Getting Started

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.