Agents

Agent API

Same listings as the site. POST /api/mcp. A 402 means pay later, when that rail is live — a stub reference is not paid.

llms.txt openapi.json

Endpoints

POST /api/mcpsearch · leaderboard · builder_profile · category · premium

GET /api/rankingspublic ranked JSON

GET /api/openapi.jsonmachine contract

Machine contract: openapi.json and llms-full.txt. Rate limit: 60 requests/minute per client IP on /api/mcp.

Try a query

Request & response

Leaderboard filters support source_quality, chain_network, provenance, and lens: revenue; results identify seeded_directory.

request · curl

curl -sS -X POST https://x402rank.xyz/api/mcp \ -H 'content-type: application/json' \ -d '{"mode":"search","query":"security tools"}'

200 OK

{
  "endpoint": "/api/mcp",
  "ok": true,
  "outcome": "success",
  "resultType": "search",
  "query": "security tools",
  "results": [
    "@nova-loop",
    "@probe-stack"
  ],
  "source": "fixture"
}

Repeat a request with the same idempotency key and you get 409, not a second charge.

Support: support@x402rank.xyz