# Use Open Agent Guide with your 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.

## Use it with your agent

Read and act on the catalog however your agent works best. Paths below are relative to the site origin.

### REST API — 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/

[Open the API reference](/api/v1/docs)

### llms.txt and Markdown — 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.

[View llms.txt](/llms.txt)

### MCP server — 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.

[Set up MCP and download Claude Code or Codex plugins](/integrations/guide.md)

### A2A server · 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.

[Read the A2A guide](/a2a/guide.md) · [Discover the Agent Card](/.well-known/agent-card.json)

### WebMCP — Every page

Every page exposes WebMCP tools through `document.modelContext`, so an agent driving a browser can act on the catalog with no setup.

### Agent skill — 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.md](/SKILL.md)

## Automate and integrate

Submit and manage catalog data from your own tooling.

### Sign up without a human — 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/

[Open the API reference](/api/v1/docs)

### Command-line tool — 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-guide

[View on PyPI](https://pypi.org/project/open-agent-guide/)

### Python SDK — Available

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`.

[View on PyPI](https://pypi.org/project/open-agent-guide/)

### Authentication and tokens — 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>

[Manage API tokens](/users/~update/)

### Export your data — 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/

[Open the API reference](/api/v1/docs)

## Get started

Create a free account for higher rate limits and the authenticated workflows, then browse the catalog or point your agent at it.