> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.agentrouter.to/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.agentrouter.to/_mcp/server.

# Welcome

AgentRouter gives agents and agent builders one routed surface for discovering, paying for, and executing paid APIs.

Instead of wiring each vendor separately, learning a new billing model each time, and guessing which provider is cheapest or most reliable, you integrate once with AgentRouter and work in a stable capability-first model:

Call `GET /domains` and `GET /domains/{domainKey}/capabilities` to find the problem space you need.

Call `POST /domains/{domainKey}/capabilities/{capabilityId}/recommend` when you want AgentRouter to choose the best supply path for cost, reliability, speed, or quality.

Call `POST /domains/{domainKey}/capabilities/{capabilityId}/execute` with the exact request body for the chosen capability.

Use one AgentRouter wallet and inspect `GET /wallet` and `GET /usage` instead of reconciling many provider-side payment flows.

AgentRouter covers domains such as `email`, `enrichment`, `social`, `web`, `search`, `text`, `post`, `broadcast`, `finance`, `geo`, `document`, `media`, `models`, `travel`, `speech`, `translation`, and `chain`, with routes across direct billing, `x402`, and Tempo/MPP-backed rails. As of May 1, 2026, `broadcast.message.quote` is live while `broadcast.message.send` remains intentionally gated because it creates a real public post. `geo.time.current.abstract-timezone.mpp` and `geo.time.convert.abstract-timezone.mpp` are live after the May 9, 2026 paid smoke. `text.analyze.diffbot-nl.mpp` is mapped and recommendable, but execution is gated until the Diffbot NL MPP route clears its HTTP 429 before-payment blocker and paid smoke succeeds.

## Start Here

Understand what AgentRouter is, why it exists, and how the capability-first model works

Go from API key to your first recommend and execute call in a few minutes

Learn how AgentRouter groups paid APIs by problem area instead of by vendor

See how route selection works before you spend credits on execution

Run AgentRouter from your terminal to inspect the catalog, reproduce requests, and smoke test recommend and execute flows

Build directly on AgentRouter with one typed client for catalog discovery, recommendation, execution, wallet, and usage

Give an agent a hosted markdown skill it can read, follow, and use over HTTP

Install AgentRouter in any MCP-compatible client through the hosted endpoint or the local fallback package

## Concrete Surfaces

Use the docs site for integration concepts and contracts. Use the main AgentRouter site when you want concrete domain pages with provider coverage, pricing examples, and execution-focused detail.

Browse domain-specific docs for email, enrichment, social, web, search, text, post, broadcast, finance, geo, travel, and more

See concrete email capabilities, route examples, pricing context, and quick-start flows

Start the hosted install flow, sign in, and copy the setup block for SDK, CLI, SKILL.md, or MCP

## Mental Model

Use this sequence when building with AgentRouter:

1. Start with a **domain** such as `email`, `search`, `web`, `enrichment`, or `broadcast`.
2. Pick a **capability** such as `email.send` or `search.answer`.
3. Let AgentRouter choose a **route** unless you have a strict provider requirement.
4. Use **recommend** when you want route selection.
5. Use **execute** when you want the paid operation to happen.
6. Let the AgentRouter wallet and settlement layer handle the underlying payment rails.