Connect your agent

One endpoint gives any agent the whole index and the router. Works with MCP clients, agent frameworks, or plain HTTP — no AgentReeve account or API key. Paid x402 actions still require a compatible payer wallet/client.

MCP: https://agentreeve.com/mcp  ·  HTTP: https://agentreeve.com/api/agentreeve

MCP clients

// Claude Desktop — Settings → Developer → Edit Config
{ "mcpServers": { "agentreeve": { "url": "https://agentreeve.com/mcp" } } }

// Cursor — .cursor/mcp.json
{ "mcpServers": { "agentreeve": { "url": "https://agentreeve.com/mcp" } } }

// Claude Code
claude mcp add --transport http agentreeve https://agentreeve.com/mcp

// Windsurf — ~/.codeium/windsurf/mcp_config.json
{ "mcpServers": { "agentreeve": { "serverUrl": "https://agentreeve.com/mcp" } } }

// VS Code (Copilot agent mode) — .vscode/mcp.json
{ "servers": { "agentreeve": { "type": "http", "url": "https://agentreeve.com/mcp" } } }

// Cline — cline_mcp_settings.json
{ "mcpServers": { "agentreeve": { "url": "https://agentreeve.com/mcp", "type": "streamableHttp" } } }

// Gemini CLI — ~/.gemini/settings.json
{ "mcpServers": { "agentreeve": { "httpUrl": "https://agentreeve.com/mcp" } } }

Tools exposed: reputation_lookup · list_categories · list_capabilities · search_endpoints_by_name · search_capabilities · get_capability_profile · search_index · get_board · route_call. Public discovery returns aggregate counts for routable free providers; identities are available through the paid x402 /api/free-intelligence endpoint.

Paid routing: MCP can preview, execute free winners, and return the durable x402 quote for a paid winner. The signed-payment retry is made directly to POST /api/route; signed payment material should not be placed in MCP tool arguments.

Agent frameworks

# LangChain (Python)
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"agentreeve": {"url": "https://agentreeve.com/mcp", "transport": "streamable_http"}})
tools = await client.get_tools()

# OpenAI Agents SDK (Python)
from agents.mcp import MCPServerStreamableHttp
reeve = MCPServerStreamableHttp(params={"url": "https://agentreeve.com/mcp"})

// Vercel AI SDK (TypeScript)
import { experimental_createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const reeve = await experimental_createMCPClient({
  transport: new StreamableHTTPClientTransport(new URL("https://agentreeve.com/mcp")),
});

Any LLM or tool — one HTTP call

# GET returns the machine-readable action manifest, arguments and price semantics
curl https://agentreeve.com/api/agentreeve

# POST dispatches by action
curl -X POST https://agentreeve.com/api/agentreeve -H 'content-type: application/json' \
  -d '{"action":"route","need":"Answer this question with an LLM","provider":{"sort":"quality","allow_fallbacks":true},"payload":{"prompt":"hi"}}'

# let the router HAGGLE for you on sellers that accept counter-offers (/negotiation)
curl -X POST https://agentreeve.com/api/agentreeve -H 'content-type: application/json' \
  -d '{"action":"route","need":"Answer this question with an LLM","negotiate":{"enabled":true,"target_ratio":0.8,"max_rounds":3,"on_reject":"best_quote"},"payload":{"prompt":"hi"}}'

# free actions include endpoint identity search + the actual capability catalogue + semantic capability discovery
curl -X POST https://agentreeve.com/api/agentreeve -H 'content-type: application/json' \
  -d '{"action":"capabilities","routable":true}'

curl -X POST https://agentreeve.com/api/agentreeve -H 'content-type: application/json' \
  -d '{"action":"endpoint_search","q":"provider or domain"}'

curl -X POST https://agentreeve.com/api/agentreeve -H 'content-type: application/json' \
  -d '{"action":"capability_search","q":"Pakistan school attendance by gender"}'

# free actions: lookup · categories · endpoint_search · search · capability_search · capability_profile · board · resources · pricing · featured
# paid intelligence: free_intelligence reveals names/domains/URLs of matching routable free providers
curl -X POST https://agentreeve.com/api/agentreeve -H 'content-type: application/json' \
  -d '{"action":"lookup","url":"https://api.example.com/v1"}'

# natural-language discovery without executing anything
curl 'https://agentreeve.com/api/v1/search?q=ocr%20an%20invoice&routable=1'

# direct provider/name search
curl 'https://agentreeve.com/api/v1/endpoints/search?q=acme'

# machine discovery documents
curl https://agentreeve.com/llms.txt
curl https://agentreeve.com/.well-known/agentreeve.json
curl https://agentreeve.com/openapi.json

Because GET returns the action manifest with arguments and price semantics, an agent can inspect the contract and construct requests without an AgentReeve-specific SDK. OpenAPI remains the authoritative HTTP schema.

Pricing

index data, boards, lookups   FREE forever
routing to free services      $0 (provider identity protected in public previews)
free-provider intelligence    $0.01
routing to paid services      $0.003 AgentReeve fee here — seller is paid separately/directly by the buyer
verify end-to-end (published) $0.05   — currently free endpoints only
list your endpoint            $5
full re-review                $10
featured placement            $24 / 24h    — labelled advertising, never affects rank
submit requires ownership proof · opt-out requires ownership proof

Standing is never for sale · every paid check's result is public · the AgentReeve fee never varies by paid winner · free-provider routes are $0. back to the index · system status