Agent402 Wiki
Agent402 is an open-source, self-hostable MCP server + HTTP API with ~1,100 ready-to-use tools for AI agents — browser rendering, web search, PDFs, OCR, images, live data, crypto/payments helpers, and ~1,040 pure-CPU utilities. Clone it and run everything free in 30 seconds (no wallet, no signup), or use the hosted instance. Optionally, the same server can charge per call over the x402 protocol (USDC on Base) — that part is opt-in; by default everything runs free.
It's also the open x402 index: a single integration gives a buyer three primitives over the whole ecosystem — Find (/api/find, resolve a task to a tool), Route (/api/route, the neutral x402 Index and Smart Order Router across every seller crawled from the Coinbase CDP Bazaar), and Leaderboard (/api/leaderboard, the x402 Leaderboard — public on-chain ranking of every seller by Base USDC settled volume). All three are free and unpaywalled — discovery primitives shouldn't cost money.
- Run it yourself (free):
git clone … && npm install && FREE_MODE=true npm start— see Getting Started - Live hosted demo: https://agent402.tools · MCP connector (paste into Claude):
https://agent402.tools/mcp - Add your own tool: a few lines in
src/tools/— see CONTRIBUTING - The other side of x402 — charge AI bots crawling your site with the open-source pay-per-crawl gate: see Pay-per-crawl
- Machine-readable catalog:
/api/pricing·/openapi.json·/llms.txt - Live stats (hosted instance):
/api/stats·/analytics(cache-hit %, p50/p95 latency, error rate) - Performance surfaces:
/api/cache-stats(Redis hit-rate counters) ·/api/cacheable(which routes cache + TTL) ·/api/analytics(24h tool-call timeseries)
Start here
| Page | What it covers |
|---|---|
| Getting Started | Your first call in 60 seconds — free, no wallet |
| Paying with x402 | USDC payments: the 402 flow, code, spend controls, Stripe's purl |
| Paying with Compute | The proof-of-work tier: spec + reference solver |
| MCP Connector | Hosted connector + the agent402-mcp npm server |
| Adapters | Drop-in tools for OpenAI / Anthropic / AI SDK / LangChain / LlamaIndex |
| Tool Catalog | What the ~1,100 tools are and how agents discover them |
| x402-Index-and-Router | The cross-seller index + Smart Order Router (cheapest healthy tool across the ecosystem) |
| x402-Leaderboard | Public on-chain ranking of every x402 seller by Base USDC settled volume |
| Payments and x402 | Non-custodial multi-chain payment toolkit: quote, verify, balance, gas, transfer-auth, ENS |
| Pay-per-crawl | agent402-tollbooth: charge AI crawlers to access your site (USDC via x402 or proof-of-work) |
| Memory and Coordination | Durable wallet-keyed state, cross-wallet grants, audit log |
| Architecture | How the server, paywall, and facilitators fit together |
| Security Model | SSRF defense, PoW scoping, what's wallet-only and why |
| Operations | CI pipeline, heartbeat watchdog, deploys, persistence |
| FAQ | The short answers |
The one-line pitch per audience
- An agent, mid-task: every capability here needs only what you already hold — a wallet or a CPU.
GET https://agent402.tools/llms.txtand go. - An agent developer: one x402-wrapped fetch (or one MCP server) buys browser rendering, live search, PDFs, durable memory, and ~1,000 utilities at $0.001–$0.02/call, deterministic, no LLM in the serving path.
- A skeptic: the whole server is open source, every endpoint is re-tested against its own documented example before every deploy, and revenue settles on-chain to
agent402.base.eth(a Base name resolving to the public receiving wallet) — verify on Basescan.
This wiki is generated from the
wiki/directory of the main repo and synced by CI — edit there, not here.