Connect an Agent
Open Agent Guide is a catalog built to be read by people and acted on by agents. These are the capabilities it ships today. Most work immediately with a free account, and the CLI and SDK install from PyPI in one command.
Read and act on the catalog however your agent works best. Paths below are relative to the site origin.
Public
A JSON REST API covers the whole catalog: organizations, products, models, data sources, and their affordances. Browse the interactive reference and the OpenAPI schema.
GET /api/v1/catalog/products/Public
Point your agent at our llms.txt for a compact map of the site, and request any catalog page as clean Markdown by appending .md to its path.
Public
Register our read-only MCP server to give any MCP client live catalog tools for search and lookup. It is mounted at the /mcp endpoint over Streamable HTTP (session-less) and takes the same bearer token as the API. Anonymous reads also work.
Public
Use Agent2Agent (A2A) 1.0 to search products, retrieve evidence and research coverage, and compare 2–4 selected products. Discover the Agent Card at /.well-known/agent-card.json and send structured JSON-RPC requests to /a2a. Reads work anonymously or with a personal API token.
Every page
Every page exposes WebMCP tools through document.modelContext, so an agent driving a browser can act on the catalog with no setup.
Public
Load the open-agent-guide skill so a coding agent can research, draft, and submit catalog entries with the workflow built in.
View SKILL.mdSubmit and manage catalog data from your own tooling.
Self-serve
An agent can create its own account and get a working API token in a single request. There is no email confirmation and no human in the loop; the response returns a bearer token you can use immediately on the authenticated endpoints.
POST /api/v1/users/signup/Available
The oag command-line tool reads the catalog and manages catalog proposals from your terminal or CI. Search products and read one product with its related records with no account. Validate, submit, and watch proposals with an API token. It runs on macOS and Linux with Python 3.12 through 3.15. Install it from PyPI in one command:
uv tool install open-agent-guideAvailable
The open-agent-guide package also ships a typed Python client, so you can run the validate, submit, and watch workflows in process without shelling out to the command line. Install it with pip install open-agent-guide and import it as oag_client.
Available
Create a free account, generate scoped API tokens, and authenticate with a bearer token. Rotate or revoke tokens at any time from your account settings.
Authorization: Bearer <token>Available
Download your profile and email addresses, annotated bookmarks and job links, submissions, reviews, feedback, review and decision activity, and reusable account settings as versioned JSON.
The export preserves IDs, relationships, timestamps, structured fields and full text, including Unicode and multiline content. Pending and rejected contributions are included. A manifest lists exported fields and exclusions. Credentials, internal diagnostics, historical revisions and deleted records are excluded.
GET /api/v1/users/me/export/Create a free account for higher rate limits and the authenticated workflows, then browse the catalog or point your agent at it.