x402 Atlas
Enables AI agents to search and verify machine-payable HTTP 402/x402 APIs using live probe data, providing ranked results by liveness, uptime, price, and trustworthiness.
README
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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.