Home

Agent402.Tools Wiki

Agent402.Tools is the applied layer of Agentic Finance - agents that pay and get paid on their own over x402 and MPP (see Agentic Finance) - shipped as an open-source, self-hostable MCP server + HTTP API with 500+ ready-to-use tools and 70+ multi-tool skill packs for AI agents - browser rendering, web search, PDFs, OCR, image and video generation, live data, crypto derivatives and DeFi and Solana token intel, crypto/payments helpers, 150+ pure-CPU utilities, plus curated workflows (Skill Packs) for jobs no single tool covers. 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, Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Stellar & Algorand - plus USDG on Robinhood Chain) and over MPP (the Machine Payments Protocol Payment HTTP auth scheme: USDC on Base and Celo, USDC.e or PathUSD natively on Tempo, and cards over MPP through Stripe on routes from $0.50) - both wires on the same 402, both opt-in; by default everything runs free. See Paying with MPP. Beside the per-call tools it sells outcome-priced reports (research, due-diligence dossiers, 13F fund reports, SEC filing reports, domain audits, FDA recall, insider flow, token risk, a publish-ready LinkedIn article package - $0.05 to $2.00 each over x402 or MPP, $2 to $5 by card), $5/month monitors that re-run a report when something changes, and prepaid card credits that let a buyer without a wallet spend on every tool - see Reports, Monitors and Credits.

Every entry earns its place - tested against its own example on every CI run, priced to market, live-verified. CI holds a 400-entry catalog floor and verifies the “500+” claim against the running server (scripts/sync-count.js --check).

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
• For people (card, no wallet): /reports one-off reports · /monitors $5/month watches · /credits prepaid credits for every tool - see Reports, Monitors and Credits
• Market intel per call: live perpetuals and options, DeFi yields and TVL, stablecoin supply, Solana token safety and risk reports, crypto news and computed indicators, indexed EVM chain reads, Farcaster social, and whole-site crawling - all keyless and deterministic, see Tool Catalog
• Images and video: flat-price generation on the OpenAI wire (/v1/images/fast, /v1/images/pro, /v1/images/generations, /v1/videos/generations) - priced per picture or per clip, not per token
• 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
• Developer experience: Quickstart · Playground · SDK REPL · API Explorer · Adapter Docs · Workflows
• 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)
• Community: Blog · Community · Contribute · Changelog · Badges

Start here

Page	What it covers
Agentic Finance	What Agentic Finance is, the stack, and where Agent402 sits
[[Why Pay Here	Why-Pay-Here]]
Getting Started	Your first call in 60 seconds - free, no wallet
[[Reports, Monitors and Credits	Reports-and-Monitors]]
Paying with x402	USDC payments: the 402 flow, code, spend controls, Stripe's purl
Paying with MPP	The Machine Payments Protocol wire: WWW-Authenticate: Payment, mppx clients, Base/Celo, native Tempo settlement, cards over MPP, native MPP on the /mcp connector
Paying with Compute	The proof-of-work tier: spec + reference solver
MCP Connector	Hosted connector (dotted tools: catalog.find, catalog.call, web.search, …, payable over MPP in the call) + the agent402-mcp npm server (wallet or prepaid credits)
Adapters	Drop-in tools for OpenAI / Anthropic / AI SDK / LangChain / LlamaIndex
Tool Catalog	What the 500+ tools are and how agents discover them
Skill-Packs	70+ multi-tool workflows - prompts/list → prompts/get, ready-to-run plans
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
[[LLM Gateway (OpenAI /v1)	LLM-Gateway]]
[[LLM Proxy Gateway	LLM-Proxy]]
[[Image Generation Gateway	Image-Gen]]
[[Code Execution Sandbox	Code-Execution]]
[[Text-to-Speech	TTS]]
[[Speech-to-Text	STT]]
[[Text Embeddings	Embeddings]]
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 MPP, native MPP on Tempo with split payments, 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
Self-Hosting	Run Agent402 on your own infrastructure
API-Reference	Complete HTTP endpoint reference - discovery, tools, payments
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, a prepaid credits key, or a CPU. GET https://agent402.tools/llms.txt and go.
• A person who needs one answer: buy a finished report by card at /reports, or a monitor that emails you when a filing, recall or certificate changes at /monitors. No wallet involved.
• An agent developer: one x402-wrapped fetch (or one MCP server) buys browser rendering, live search, PDFs, durable memory, and 150+ utilities from $0.001/call (most $0.001–$0.02; premium AI/media higher), plus 70+ curated multi-tool workflows (Skill Packs) priced by the tools they bundle - all deterministic, no LLM in the serving path - and outcome-priced report products ($0.05 to $2.00) on the same 402 when the job is a whole report rather than a call.
• 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.