x402 Atlas
Live, verified search engine for machine-payable (HTTP 402 / x402) APIs. The "Google + Bloomberg" layer for agentic commerce: agents ask "best, cheapest, alive, trustworthy x402 endpoint for X right now?" — Atlas answers with probe-verified truth, not seller claims.
Why it wins
- Measured, not claimed — hourly probes hit every endpoint, validate the real 402 paywall, record price/latency/uptime
- Adapter layer — parses V1 (
accepts[]body), V2 (PAYMENT-REQUIREDheader), and the ecosystem's "GET = free buyer metadata / POST = 402 challenge" pattern (discovered live on agenttoll.dev). New spec versions = new adapter, never a rewrite - Agent-native — JSON API,
/llms.txt, and MCP server (/mcp) so Claude/Kimi/any agent can use it directly - On-chain ready — seller identity = settlement address (
payTo); phase-2 indexer tracks EIP-3009transferWithAuthorizationevents (validated against a real tx:0xc647…672d, $0.005 USDC on Base)
API
| Route | Description |
|---|---|
GET /v1/search?q=&chain=eip155:8453&price_max_usd=0.01&alive_only=true |
Ranked results (liveness ▸ uptime ▸ relevance ▸ freshness) |
GET /v1/services / /v1/services/history?id= |
Catalog / probe history |
GET /v1/stats |
Ecosystem stats |
POST /v1/submit |
Submit a service ({"base_url": "https://…"}) |
POST /mcp |
MCP server: search_x402, get_ecosystem_stats |
GET /llms.txt |
LLM-readable index |
GET /admin/crawl?service=&limit=&token= |
Run pipeline inline (set ADMIN_TOKEN in prod) |
Develop
npm install
npx wrangler d1 migrations apply x402-atlas-db --local
npx wrangler dev # then: curl localhost:8787/cdn-cgi/local/scheduled
curl "localhost:8787/admin/crawl?limit=3"
npm test
Deploy (first time)
npx wrangler login
npx wrangler d1 create x402-atlas-db # put id in wrangler.jsonc
npx wrangler kv namespace create CACHE # put id in wrangler.jsonc
npx wrangler r2 bucket create x402-atlas-snapshots
npx wrangler queues create x402-atlas-crawl
npx wrangler vectorize create x402-atlas-services --dimensions=768 --metric=cosine
npx wrangler d1 migrations apply x402-atlas-db --remote
npx wrangler secret put ADMIN_TOKEN
npm run deploy
Kaizen loop
Every search is logged (search_log); zero-result queries are demand signals. Weekly reports land in kaizen/reports/. Ranking: liveness(100) + uptime(×30) + relevance(×10) + freshness(×20) + price-verified(×10).
Roadmap
Phase 2: EIP-3009 settled-volume indexer + trust_score · Phase 3: USDC-paid seller tools & micropaid API tier (via x402 itself) · Phase 4: @x402-atlas/announce SDK, Bazaar interop, multi-chain.
