Getting Started
Payment wires: every paid endpoint accepts x402 and MPP (Machine Payments Protocol) on the same 402 - see Paying with x402 and Paying with MPP. Agent402 is the applied layer of Agentic Finance: agents that pay and get paid on their own.
You can make your first call in under a minute, with no wallet and no money.
1. Discover the catalog (free)
curl https://agent402.tools/api/pricing # every endpoint, price, category
curl https://agent402.tools/openapi.json # full OpenAPI 3.1 with schemas
curl https://agent402.tools/llms.txt # the agent-oriented overview
curl https://agent402.tools/api/find?q=ocr # resolve a task to the best tool
curl -X POST https://agent402.tools/api/route -H 'content-type: application/json' \
-d '{"query":"ocr image","top":5,"include":"external"}' # cross-seller Smart Order Router
curl 'https://agent402.tools/api/leaderboard?top=10' # on-chain ranking by Base USDC volume
Each tool also has human-readable docs at https://agent402.tools/tools/{slug} with a working example.
2. See the paywall
Call any paid tool without paying and you get an HTTP 402 with exact payment requirements:
curl -i -X POST https://agent402.tools/api/hash \
-H 'Content-Type: application/json' -d '{"text":"hello"}'
# HTTP/2 402 … {"x402Version":2,"accepts":[{ price, network, payTo, … }]}
# X-Pow-Challenge: https://agent402.tools/api/pow/challenge?slug=hash ← the free option
3. Run the full loop, free (proof-of-work)
The zero-dependency demo discovers the catalog, gets quoted, pays with ~0.2s of CPU, and uses the result:
curl -s https://agent402.tools/demo.js -o demo.js && node demo.js
To settle in real USDC instead, fund a wallet on Base and run AGENT_KEY=0xYOUR_KEY node demo.js (after npm i @x402/core @x402/evm @x402/fetch viem).
4. Pick your integration
| You are… | Use |
|---|---|
| A Claude user | Paste https://agent402.tools/mcp into Settings → Connectors - see MCP Connector |
| A Cursor / ChatGPT (Pro+) / VS Code Copilot user | Paste the same URL into the MCP connector settings - see MCP Connector |
| An MCP-based agent | npx -y agent402-mcp with optional AGENT_KEY - see MCP Connector |
| On OpenAI / Anthropic / Vercel AI SDK / LangChain / LlamaIndex | One of the framework adapter packages - see Adapters |
| Calling over HTTP with a wallet | One x402-wrapped fetch - see Paying with x402 |
| Wallet-less / sandboxed | Proof-of-work on 150+ pure-CPU tools - see Paying with Compute |
| Have a card, no wallet | Load prepaid credits at /credits ($20 / $50 / $100) and send Authorization: Bearer a402_… on any paid route; agent402-mcp and agent402-client take the same key - see Reports, Monitors and Credits |
| A person who wants one finished report | Buy it by card at /reports ($2 to $5 depending on depth), or a $5/month monitor at /monitors - see Reports, Monitors and Credits |
What things cost
Flat per-call prices from $0.001 (utilities, conversions); most tools are $0.001–$0.02 (e.g. browser rendering), with premium AI, media, and multi-tool skill packs priced higher. Report products are priced per outcome ($0.60 to $2.00 a report over x402 or MPP, $0.05 for the deterministic IPO digest: research, dossier, ticker pack, fund, SEC filing, domain audit, recall, insider flow, token brief, token risk, LinkedIn article; $2 to $5 by card, where the price includes payment processing) and monitors are $5 per month per target. The one exception to flat pricing is the LLM gateway's metered tier (POST /v1/metered/chat/completions), where the 402 quotes each request from its own body (see LLM Gateway (OpenAI /v1)). No tiers, no rate-limit plans - every call settles in seconds and the next one is independent. Prices are in the catalog and in every 402 response.