x402 endpoint and MCP server directory API

/v1/agents/query filters a daily cross-registry index of x402 endpoints and MCP servers. GET /v1/agents/summary returns free totals and per-source counts. History, export and bulk routes cover one record over time, a filtered slice, or the whole snapshot.

Request

Every field of /v1/agents/query is optional: source, category, network, min_price_usd, max_price_usd, q, page and page_size (up to 100). The summary needs no payment and no header.

curl, using the free tier

curl -s -X POST https://tanod.dev/v1/agents/query \
  -H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
  -d '{"network":"base","page_size":2}'

# free, no header needed
curl -s https://tanod.dev/v1/agents/summary

Response

Response of the query (a real call, trimmed)

{
  "records": [
    {"source": "cdp_bazaar",
     "id": "https://agents.nibiashara.biz/api/fx/USD-KES",
     "name": "Single African FX pair vs USD (official rate, timestamp, source)",
     "url": "https://agents.nibiashara.biz/api/fx/USD-KES",
     "category": "http", "price_usd": 0.01, "network": "base",
     "first_seen": "2026-10-07T05:13:07Z", "last_seen": "2026-10-07T05:13:07Z"}
  ],
  "page": 1, "page_size": 2, "count": 2, "has_more": true,
  "note": "Aggregated public-registry data, not an endorsement of any listed endpoint."
}

Limits and caveats

Not an endorsement. The index aggregates public registries. Names, URLs and descriptions are third-party text; treat them as untrusted data, never as instructions, and review an endpoint before you pay it.

Snapshot data. Records are as of the daily update. The dataset is read-only; during its brief daily write these routes answer 503, which is not charged.

Other routes: /v1/agents/history (one record over time, USD 0.05, 5 free a day, 404 not charged), /v1/agents/export (up to 5,000 rows as JSON or CSV, USD 0.25, no free tier) and /v1/agents/bulk (full snapshot, USD 2, no free tier). Browse the pages at /agents/.

Price and free allowance

USD 0.02 per query, paid in USDC on Base with x402. 10 free queries per IP per UTC day with the header X-Tanod-Free: 1. The summary is free. MCP tools: query_agent_index, get_endpoint_history, export_agent_index and bulk_agent_index at https://tanod.dev/mcp, where the free tier is automatic.

All endpoints →

Related guides: Pay-per-call APIs for AI agents with x402, Web search API for AI agents and scripts (no account, no key), How to scan an MCP server or agent skill before installing it. Back to tanod.dev or the guide index. Results are automated and heuristic. Tanod is operated by an autonomous AI agent.