
agent402.tools: 500+ pay-per-call tools, metered models and finished reports for AI agents, paid per
agent402.tools: 500+ pay-per-call tools, metered models and finished reports for AI agents, paid per call in USDC over x402 and MPP or by card. Open source, self-hostable, MCP-native. The applied layer of agentic finance.
·
Live at agent402.tools.
Agent402 is a catalog of 500+ tools that AI agents find, pay for per request over x402 or MPP, and call with no account or API key. Metered models and finished reports are sold the same way, and reports by card too. The applied layer of Agentic Finance. Open source, self-hostable, MCP-native.
Operated by Havok Holdings LLC · Live · Why pay here · Receipts · Status · Security · Company
Try it in 30 seconds: claude mcp add agent402 -- npx -y [email protected], or paste https://agent402.tools/mcp into any MCP client. The free tier needs no wallet. Verified setup blocks for Cursor, VS Code, Windsurf, Cline, Roo Code, Codex CLI, Gemini CLI, Continue, ElizaOS, Paperclip, HarnessRouter and AgentCore: agent402.tools/guides/agent-hosts (shortlinks agent402.sh/<host>, e.g. agent402.sh/cursor).
Who pays: agents pay per call (from $0.001; models metered under a quoted ceiling and settled at actual usage); people buy finished reports ($2 to $5) and monitors ($5 a month) by card; sites charge crawlers with the tollbooth.
Agentic Finance is software agents paying and getting paid on their own: discovering a service, paying per request from a wallet over open protocols (x402, MPP), receiving a verifiable receipt, and earning per request in return. Agent402 is its applied layer - explainer: agent402.tools/agentic-finance · glossary.
Selling an x402 API? List it on the index for free at
/sell(POST /api/index/register: self-serve, no signup, 0% take). The router sends buyers to a seller once its routes show settled payments from several independent buyers; calls priced at $0.05 or less on Base (up to $0.25 a day per seller and $5.00 a day in all) or $0.01 or less on Solana can be tried before that, marked unproven on the buyer's receipt. Charging crawlers on your own site instead?agent402-tollboothputs a 402 gate in front of it.What makes it different: Agent402 is open-source and self-hostable - and a single integration gives a buyer three free primitives over the whole x402 ecosystem:
- Find -
/api/find?q={task}resolves a task description to the best-matching tools (route, price, schema, ready example).- Route -
POST /api/routeis the neutral Smart Order Router: rank tools across every x402 seller crawled (auto-discovered from the Coinbase CDP Bazaar), health-aware, withinclude=externalto exclude us. The response returns the top N and carriesmatchedfor how many scored.- Leaderboard -
GET /api/leaderboardis the public on-chain ranking of x402 sellers by Base USDC settled volume - calls served, totalUsd, unique buyers per seller. It returns the top N, never the whole board (25 by default, 50 the ceiling;totalSellerscarries the full count). Pipeline: Bazaar →eth_getLogs→ per-call ceiling → aggregate bypayTo. The snapshot refreshes every 4 hours.Plus the catalog - 500+ strong: search/answer as the MCP front door, then 500+ tools and curated skill packs (multi-tool workflows callable as MCP prompts) - all runnable yourself, plus
agent402-tollbooth- an open pay-per-crawl gate for the other side of x402.Two doors, two price lists. Agents pay per call in USDC (x402 / MPP) or free via proof-of-work, and a finished report costs $0.60 to $2.00 that way. People pay by card: the same reports at agent402.tools/reports (company dossier, 13F fund report, insider flow, market brief, deep research, FDA recall, domain audit) are $2 to $5, monitors that re-run on change at /monitors are $5 a month, and a prepaid credits key pays per successful call on Agent402's own services (
Authorization: Bearer a402_…; /credits says whether packs are on sale). The card price includes payment processing. An agent paying per call pays the lower tool price for the same report.Two payment wires, one URL. Every paid endpoint accepts x402 (
PAYMENT-SIGNATURE, USDC on 13 chains or USDG on Robinhood Chain) and MPP (Machine Payments Protocol, the IETF-trackPaymentHTTP auth scheme co-authored by Tempo and Stripe): the same 402 carries both, anmppxclient pays out of the box, and MPP settles on Base and Celo (USDC), natively on Tempo (USDC.e or PathUSD via Tempo's relay), or by card over MPP (Stripestripe/charge, offered on routes priced $0.50 and up when the operator configures it). The MPP marketplace lists every MPP seller we can verify live. Details: What is MPP · live MPP settlements.
Framework adapters (drop-in tools for the major agent stacks - auto-payment underneath):
500+ strong - live web search and cited answers as the MCP front door, then ready-to-use web tools and multi-tool skill packs for your AI agent, from one server. Every one priced per call and settled on-chain. Browser
rendering, web search, PDFs, images, OCR, live financial/crypto/macro data, SEC EDGAR, deterministic stats, forecasting, and options/bond pricing (Black-Scholes, YTM), compression, and 150+ pure-CPU utilities. Run it yourself for free in 30 seconds (MCP or
plain HTTP, no API keys, no signup - the free tier and x402/MPP payments never
need a key; only a prepaid credits key is a bearer key), connect
it to Claude/ChatGPT/any MCP client, and add your own tools in a few lines.
No language model writes a utility tool's answer, and every tool CI can run
without a third-party key is re-tested against its own example before every release. The model-backed
surfaces are explicit and priced as such: the /v1 gateway (metered under a
quoted ceiling, or flat tiers) and the finished report products (/v1/research, /v1/dossier, ... below).
Optionally, the same server can charge per call over the x402 protocol (USDC on Base, Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Arc, Ink, Stellar & Algorand, plus USDG on Robinhood Chain - 14 chains) - so the instance you self-host for free can also be a hosted, monetized one. Free mode is one setting (
FREE_MODE=true); a paid instance needs a payout wallet.
🟢 Hosted demo: agent402.tools · 📖 Wiki · 📦 npm · 🔌 MCP Registry · 🧩 Hosted MCP connector
Pick whichever fits. They are all free and need no wallet:
1. Zero install - add the hosted connector to Claude (claude.ai → Settings → Connectors → Add custom connector):
https://agent402.tools/mcp2. One command - run the MCP server locally (the pure-CPU tools work with no key; it pays the tiny proof-of-work for you):
npx -y [email protected]
# in Claude Code: claude mcp add agent402 -- npx -y [email protected]3. Clone and host the whole thing (all 500+ tools as an HTTP API + MCP, free mode, no payments):
git clone https://github.com/MikeyPetrillo/Agent402 && cd Agent402
npm install
FREE_MODE=true npm start # → http://localhost:3000 (HTTP API + /mcp)# try a tool over HTTP - no auth in free mode
curl -s -X POST localhost:3000/api/hash -H 'content-type: application/json' \
-d '{"text":"hello world","algo":"sha256"}'4. Deploy to Railway (full self-hosted instance, built from the repo's Dockerfile):
The button creates the service from this repository; it adds no database or cache. Set FREE_MODE=true to serve every tool free, or the paid-mode variables in Self-Hosting: without one or the other the server exits at boot. Redis and Postgres are optional and you add them yourself: REDIS_URL enables the upstream response cache (X-Cache: hit|miss), and DATABASE_URL enables the public /api/analytics dashboard.
Every paid route answers 402 with both an x402 offer and MPP challenges, so either client pays it. No API key, no signup: the wallet is the account.
MPP (USDC.e or PathUSD on Tempo, listed first in the 402, or USDC on Base or Celo) with mppx:
import { Mppx, tempo, evm } from "mppx/client";
const account = (await import("viem/accounts")).privateKeyToAccount(process.env.AGENT_KEY);
const res = await Mppx.create({ methods: [tempo.charge({ account }), evm.charge({ account })] }).fetch("https://agent402.tools/api/uuid");x402 (USDC on Base and other chains) with @x402/fetch:
import { wrapFetchWithPayment } from "@x402/fetch"; import { x402Client } from "@x402/core/client"; import { registerExactEvmScheme } from "@x402/evm/exact/client";
const client = new x402Client(); registerExactEvmScheme(client, { signer: (await import("viem/accounts")).privateKeyToAccount(process.env.AGENT_KEY) });
const res = await wrapFetchWithPayment(fetch, client)("https://agent402.tools/api/uuid");More: Paying with MPP · Paying with x402.
Every tool earns its place: priced to market and settled on-chain, and every tool CI can run without a third-party key is tested against its own example on every CI run. CI holds a 400-entry catalog floor and verifies the “500+” claim against the running catalog (
scripts/sync-count.js --check). The catalog grows only when a tool is worth calling.
| Examples | |
|---|---|
| Browser & web | render (headless Chromium, executes JS), screenshot, extract (article→markdown), meta |
| Live search & answers | search (real web index), search-lite (a quick 5-result sample), answer (web answer with citations), search-news/search-images/search-videos variants, search-suggest, multi-search |
| PDFs & media | pdf-to-markdown, pdf-merge, pdf-extract-pages, pdf-rotate, images-to-pdf, audio-convert, audio-normalize (EBU R128, real ffmpeg) |
| Images | image-resize, image-convert, image-thumbnail, barcode-decode (jimp/zxing, pure-CPU) |
| OCR | image-ocr (text out of any image - pure-CPU, no model) |
| Geo | geo-distance (haversine, pure-CPU), geocode, reverse-geocode, place-search, geo-lookup |
| Live data | fx-rate (ECB), barcode-lookup (Open Food Facts), gov-data (data.gov), weather-forecast/weather-alerts, earthquakes (USGS) |
| Finance & crypto | stock-quote/stock-history (a licensed feed, multi-venue consolidation), crypto-price/crypto-market/crypto-history/crypto-trending/crypto-global (CoinGecko) |
| Crypto derivatives & options | perp-markets, perp-funding, perp-funding-screener, perp-basis, perp-open-interest, perp-klines, perp-orderbook (live perpetuals: mark/oracle price, funding, OI, candles, depth); options-summary, crypto-options-chain, options-ticker, options-volume (options book, IV and greeks, onchain options volume) - $0.001 to $0.005 a call, no exchange account |
| DeFi & stablecoins | defi-yields (screen pools by chain, project, TVL and stablecoin-only), defi-yield-history, defi-protocols, defi-protocol, defi-chains, defi-chain-tvl-history, defi-fees, defi-dex-volume, stablecoins, stablecoin-supply-history - $0.001 to $0.003 a call |
| Solana token intel | sol-token-pairs, sol-token-search, sol-trending, sol-price, sol-swap-quote, sol-token-lookup - markets, prices and routing for any mint |
| Crypto market coverage | crypto-news, crypto-indicators (RSI, MACD, moving averages, computed here), crypto-market-pulse, coin-profile, coin-history, coin-ohlc, coin-market-chart-range, coin-categories, coin-price-by-contract (price by token ADDRESS, no coin id needed), global-defi, exchanges, exchange-tickers, exchange-rates, coin-search, coins-list - plus tokenized real-world assets from the same CoinGecko key: rwa-list, rwa-markets, rwa-asset, rwa-issuers, rwa-issuer (tokenized stocks, ETFs and commodities with onchain market data and the issuers behind them) |
| Indexed chain data | asset-transfers (filtered transfer history), token-balances, token-allowance, tx-receipt (decoded transfers), block-receipts, token-price-history - indexed reads across the major EVM chains, no node and no key of your own |
| Farcaster social | fc-cast-search, fc-channel-feed, fc-trending, fc-user-casts, fc-cast, fc-cast-replies, fc-channel, fc-user-search, fc-cast-metrics - search, feeds and engagement metrics on the onchain social graph |
| Site crawling | site-map (enumerate a site's URLs) and site-crawl (breadth-first crawl to clean markdown, robots-respecting, hard page/depth/time budgets) - the deterministic pair behind any "read this whole site" task |
| Macro (FRED + more) | yield curve, treasury, fiscal, Fed funds, CPI, unemployment, Sahm rule, ECB FX, World Bank, FRED bulk release observations |
| SEC EDGAR | ticker→CIK, filing list, 10-K/10-Q text, XBRL frames, insider transactions, 13F holdings, IPO calendar, full-text search |
| Finished reports (cited) | research/research-pro/research-max (grounded deep research), market-brief, dossier/dossier-max (company due diligence), fund-report/fund-report-max (13F portfolio), domain-audit/domain-audit-pro (graded security + deliverability), recall-report (FDA), insider-report (Form 4 flow), token-risk/token-risk-pro (on-chain contract risk), filing-report (latest SEC filing), token-brief (Solana mint risk evidence, available while its data source answers), ticker-pack (dossier + insider flow + holders), ipo-report (S-1 + 424B4 digest, deterministic) - $0.05 to $2.00 per report over x402 / MPP, or $2 to $5 by card at /reports; see the /v1 table below |
| Network truth | dns, dns-lookup, tls-cert, whois, http-check, robots-check, email-validate, ip-info |
| Crypto & payments | usdc-balance, tx-status, gas-estimate, ens-resolve, x402-quote, x402-verify, transfer-authorization - non-custodial, multi-chain (Base/Polygon/Arbitrum/Optimism/Ethereum) |
| Agent memory | wallet-keyed KV + TTL, atomic counters, cross-wallet grants, hash-chained audit log, similarity recall |
| Stats & forecasting | stats-summary, correlation, linear-regression, moving-average, outliers; forecast-naive, forecast-ses, forecast-holt, forecast-holt-winters + forecast-eval (MAPE/RMSE backtest) |
| Finance math | black-scholes (option pricing + greeks), bond-price/bond-ytm, cagr, sharpe-ratio, annuity, npv/irr, compound-interest, loan-payment/amortization, break-even, effective-annual-rate (pure-CPU, deterministic) |
| Compression | gzip/gunzip, brotli-compress/brotli-decompress, compress-compare (algorithm shootout, pure-CPU via node:zlib) |
| HTML extraction | html-select (CSS query), html-table, html-strip, html-links, html-meta - deterministic counterpart to extract |
| Network ops | dns-lookup, dns-propagation, spf-check/dmarc-check/dkim-lookup, email-deliverability; cert-transparency, http-headers (security audit), tech-stack, asn-info (IP geo) |
| Chain reads | block-number, chain-info, block-info, contract-code, erc721-owner, event-logs - keyless JSON-RPC reads with multi-endpoint failover on Ethereum/Base/Polygon/Arbitrum/Optimism, from $0.001 |
| SQL policy | sql-guard ($0.004 - pass/warn/block verdict with named risks on a SQL statement, plus an Ed25519-signed check result when a signing key is configured), sql-cert-verify ($0.001 - verifies that signed result against the exact statement) |
| x402 seller intelligence | Three rungs on the same question, cheapest first. seller-trust (GET /api/x402/seller-trust, $0.005) - the router's gate field by field: indexed, manifest parses, chains advertised, settled calls observed, would we spend buyer money there. seller-dossier (POST /api/seller-dossier, $0.05) - the assembled record: every price with its provenance, advertised wallets against the wallets actually paid, settlement evidence per source, the dispatch verdict per chain with its reason, and what happened the times our router paid it. seller-payability (POST /api/seller-payability, $0.10) - buys one real call right now and reports every leg, including whether the accept's EIP-712 domain matches the token it names. The first two are offline reads of what we already know; the third spends USDC to find out |
| 150+ pure-CPU utilities | hashing, JWT, base58, JSON⇄CSV/YAML, token-count, text-chunk, json-validate, text stats, cron math, validators, unit conversions across 13 categories (one parametric tool) |
Full schemas live in /openapi.json; a
machine-readable catalog is at /api/pricing
and /llms.txt. Don't know which tool you need?
/api/find?q=<task> resolves
a task description to the right tool - route, price, schema, and a ready example -
so an agent skips the token-heavy "search around to find a tool" step.
/v1) - chat, embeddings, rerank, images, speech & finished reports, pay per callCall a model: the metered route is the default. POST /v1/metered/chat/completions
(and the Anthropic Messages and OpenAI Responses twins, /v1/metered/messages and
/v1/metered/responses) serves third-party models with no API key, no signup and no
account, paid per call in USDC over x402 or MPP (a prepaid credits key also works, see
For humans). The 402 quotes this exact request from
its own body (the input estimated from its tokens with headroom, plus your
max_tokens, at the model's list price plus a fee). On x402, Tempo and credits,
settlement never exceeds that quote: an exact payer pays the quote, and an upto
payer (where the 402 offers it) or a credits key settles what the answer used; a card
payment adds the processor fee. Set a client timeout of at least 120 s: the answer is
generated and the payment settled before the response is sent, which takes a few seconds
on most calls and longer for long answers, and a client that disconnects after the
payment settles is charged without the answer (the charge is recorded as owed and
reviewed for a refund).
curl -i -X POST https://agent402.tools/v1/metered/chat/completions -H 'content-type: application/json' \
-d '{"model":"anthropic/claude-haiku-4.5","messages":[{"role":"user","content":"Summarize x402 in one line"}],"max_tokens":200}'
# unpaid: HTTP 402 quoting this body; an x402 or MPP client pays the quote and resendsThe flat tiers below stay as the predictable-price option: point any OpenAI SDK at
base_url = https://agent402.tools/v1 (or /v1/nano, /v1/pro, /v1/premium) for one
price per call whatever the length.
| Endpoint | Price | Serves |
|---|---|---|
POST /v1/metered/chat/completions | from $0.001 | the default - every explicit model the flat chat tiers serve, quoted per request from the body (200k chars in on every model and more on a larger context window, 8,192 tokens out) |
POST /v1/nano/chat/completions | $0.003 | nano models - priced for high-frequency agent loops |
POST /v1/auto/chat/completions | $0.01 | no model needed - deterministic eval-ranked routing (code / reasoning / long / general), optional quality: fast | balanced | best at the same price, decision disclosed via agent402_router |
POST /v1/chat/completions | $0.02 | budget/mid models (gpt-6-luna by default, claude haiku, gemini flash, deepseek, llama…) |
POST /v1/pro/chat/completions | $0.10 | mid-frontier (gpt-6.1 terra by default, gpt-6 sol, claude sonnet, gemini pro and 4 argon, grok) |
POST /v1/premium/chat/completions | $0.50 | frontier (claude opus 5.5 by default, gpt-5.6 sol and terra, gpt-6 astra, claude fable 5.1 and 5.2, gemini 4 argon) |
POST /v1/grounded/chat/completions | $0.03 | the auto router plus a live web search on every call - answers carry OpenAI-wire url_citation annotations; never cached |
POST /v1/{nano,auto,pro,premium}/messages, POST /v1/messages | tier price | the Anthropic Messages wire on every tier (same allowlist, caps and failover as the chat route); effort (low to max) is the depth control on Claude 4.7+, older Claude takes thinking.budget_tokens |
POST /v1/{nano,auto,pro,premium}/responses, POST /v1/responses | tier price | the OpenAI Responses wire on every tier (function tools only, no server state) |
POST /v1/embeddings | $0.002 | OpenAI embeddings, batch up to 64 inputs - an identical repeat from the payer that paid for it is free (deterministic output, cache default-on; scope below) |
POST /v1/rerank | $0.002 | Cohere-compatible rerank ({query, documents[], top_n}), up to 50 documents, cache default-on (scope below) |
POST /v1/images/generations | $0.08 | image generation (FLUX.2 Pro, 1024x1024 PNG) - OpenAI images wire, inline base64 out |
POST /v1/images/fast | $0.02 | budget text-to-image, same OpenAI images wire, about two seconds a picture |
POST /v1/images/pro | $0.05 | higher-fidelity text-to-image, one picture a call |
POST /v1/videos/generations | $0.20 | text-to-video: one silent 4-second 720p clip, MP4 inline base64, 16:9 or 9:16 |
POST /v1/audio/speech | $0.06 | text-to-speech, OpenAI audio.speech.create() wire - up to 2,000 chars in, raw mp3 (default) or pcm bytes out, five-model failover chain |
Streaming (stream: true), full tools/function-calling passthrough, an opt-in
prompt cache on the chat tiers (cache: true → a byte-identical repeat within
10 minutes is free to the payer that paid for it, on a fresh payment of its own: an
x402 v2 exact payment signed by the paying wallet's own key, a verified Tempo sender,
or the same credits key; the repeat's payment is not charged, except a Tempo transfer
sent before the call, which is final when sent; other payers and payment methods,
including Solana, Stellar, Algorand, Permit2/upto, x402 v1 and contract wallets, are
charged on each call; the same rule covers the embeddings and rerank caches), upstream failover chains that end in a canary-proven model, and a
free GET /v1/models listing every model with
its tier and caps. A real-money canary buys the core surfaces daily (the chat
tiers, the messages and responses wires, embeddings, rerank, image generation
and speech) - streaming, routing disclosure, and both cache behaviors included.
Finished report products live on the same /v1 prefix: one paid call returns
a complete, cited report (JSON, with a sources appendix) rather than a raw model
turn. Every report is grounded in primary data the server fetches itself (EDGAR
filings, openFDA, DNS/TLS probes, on-chain reads, a live web search) before
synthesis; ipo-report is fully deterministic (no model at all):
| Endpoint | Price | Report |
|---|---|---|
POST /v1/research · /v1/research/pro · /v1/research/max | $0.60 · $0.85 · $1.10 | deep research report ({query}) - grounded multi-search, rerank, cited synthesis |
POST /v1/research/market-brief | $0.85 | market / competitor brief ({query}) |
POST /v1/dossier · /v1/dossier/max | $0.85 · $1.10 | company due-diligence dossier ({ticker}) - filings, insider flow, web |
POST /v1/fund · /v1/fund/max | $0.60 · $0.85 | fund portfolio report from the latest 13F ({manager}) - bought/sold last quarter |
POST /v1/domain-audit · /v1/domain-audit/pro | $0.60 · $0.85 | graded domain security + deliverability audit ({domain}) |
POST /v1/recall-report | $0.60 | FDA recall report, drug/food/device ({query}) |
POST /v1/insider-report | $0.60 | insider flow report from parsed Form 4 filings ({ticker}) |
POST /v1/filing-report | $0.85 | latest SEC filing read and summarized with the facts that moved ({ticker}) |
POST /v1/token-brief | $0.60 | Solana token risk evidence from on-chain and market data ({mint}), available while its data source answers |
POST /v1/ticker-pack | $2.00 | one ticker in one report: dossier, insider flow and holders |
POST /v1/token-risk · /v1/token-risk/pro | $0.60 · $0.85 | token and contract risk report from on-chain evidence ({address, chain}) |
POST /v1/ipo-report | $0.05 | IPO pipeline digest, S-1 + 424B4 from EDGAR full-text search ({days, keyword}), deterministic |
Reports are wallet-only (x402 / MPP / prepaid credits, never proof-of-work) and take a few minutes to generate. The same reports are sold to people by card at agent402.tools/reports for $2 to $5 depending on depth. The card price includes payment processing; an agent paying per call over x402 or MPP pays the lower tool price for the same report.
Two companion tools close the loop: POST /api/route/execute ($0.01, with
execute-plus $0.05, execute-max $0.55 and execute-pro $3.30 tiers for pricier tools) resolves a task description to the
best tool and runs it in one paid call, including, with include:"external",
tools sold by other x402 sellers (it routes on proven on-chain settled
volume, with one exception - a Base or Solana seller with no history yet is
tried only after every proven candidate, under a small per-call ceiling (on Base,
also a daily cap per seller), and flagged unproven on the receipt - buys the result from them on the chain you paid
on - Base, Solana, Algorand or Tempo - and sells it to you; see the
Smart Order Router guide), and
POST /api/my-usage ($0.005) returns the paying wallet's own purchase
history - no wallet parameter; the x402 payment is the identity, so nobody can
read another wallet's profile.
The same catalog has a card-paying front door (Stripe Checkout; the operator
enables it with STRIPE_SECRET_KEY, otherwise these pages simply do not mount):
| Page | What you get |
|---|---|
| agent402.tools/reports | Buy any finished report from the table above by card (POST /api/buy) for $2 to $5 (the deepest tiers and the ticker pack sit at the top of that range; current prices on the page), delivered at /r/<session> - no wallet, no account. The card price includes payment processing; an agent paying per call pays the lower tool price for the same report. A report is generated only against a Stripe-verified paid session, once; a failed generation is refunded automatically. |
| agent402.tools/monitors | $5/month subscriptions that re-run a report when something changes and email you (up to 4 full reports in any 30 days; a change past that arrives as an alert email): domain security monitor (free daily re-probe, full paid re-run on a security change, a certificate inside 14 days of expiry, or every 30 days), SEC filing watch (new filing), Solana token risk watch (changed risk facts, available while its data source answers), fund 13F watch (new filing), FDA recall watch (new recall number), insider flow watch (new Form 4), research question watch (your question researched again about once a week), IPO pipeline watch (weekly digest). Reports land at /m/<id>; manage or cancel through the Stripe Customer Portal at /monitors/manage. |
| agent402.tools/credits | Prepaid credits: a prepayment for Agent402's own services, for business and developer use (the page says whether packs are on sale). Send a key (a402_…) as Authorization: Bearer a402_… on a priced route and the call is paid from the key - debited only on a successful response, integer micro-dollars so sub-cent prices are exact; credits never expire and carry no fees, and are not transferable or redeemable for cash. GET /api/credits/balance (same header) reads the balance; a 402 with {reason, balanceUsd, topup} means insufficient. Identity-bound tools (/api/memory*, my-usage) refuse credits because the payment is the identity there; pay those over an x402 rail. Routes that buy from an outside seller with our wallet (the route-execute tiers, seller-payability, /api/decide/execute and the flight routes) take a wallet payment only (x402, or MPP on a chain). |
A credits key is understood by the SDKs: agent402-mcp reads
AGENT402_CREDITS_KEY and agent402-client takes { creditsKey }.
POST /api/decide turns a plain-language task into a call-ready plan: which tools, from this
catalog and from outside x402 sellers whose 402 was verified in the last week, in what order, with
fallbacks, inputs that validate against each tool's schema, and cost and latency estimates.
Priced by depth: quick (one best tool), plan (steps and fallbacks) and full (plus a compiled
prompt), from $0.003 to $0.03 per decision over x402 or MPP.
curl -X POST https://agent402.tools/api/decide \
-H "Content-Type: application/json" \
-d '{"task":"Check whether wallet 0xd8dA...6045 is on a sanctions list, then list its recent token transfers on Base","depth":"plan"}'firstParty).POST /api/decide/execute, which runs the plan: our tools directly, outside steps bought from the
seller and resold at the seller's price plus a disclosed 5% markup. Spend stops at the budget,
fallbacks are tried in order, and a run where no step succeeds is not charged on x402. Because it can
buy from outside sellers, execute is paid from a wallet (x402, or MPP on a chain).decide.plan and decide.execute; decide.feedback (free) records
whether a step worked. Page: agent402.tools/decide.For jobs that span several tools - "audit a domain", "diagnose deliverability",
"work up a time-series", "peel an opaque blob" - Agent402 ships curated
skill packs: ordered, typed sequences of tool calls with a Claude-ready
prompt template. Callable as MCP prompts (prompts/list → prompts/get { name, arguments })
or plain HTTP at GET /api/skill-packs/{slug}/prompt (every slug is listed in the
free JSON index at /api/skill-packs.json).
A task-shaped query to catalog.search (the hosted connector's search tool; the older search_tools name still works as an alias) returns the matching pack alongside individual tools.
| Featured pack | Chains | Use it for |
|---|---|---|
security-audit | cert-transparency · dns-lookup · spf-check · dmarc-check · http-headers · tls-cert · tech-stack | Domain security posture |
trend-analysis | stock-history · fred-series · stats-summary · moving-average · linear-regression · outliers · correlation · forecast-eval | Quant workup on any time series |
structured-scrape | extract · render · html-select · html-table · html-strip · html-links · html-meta | Deterministic scraping decision tree |
decode-blob | jwt-decode · gunzip · brotli-decompress · base64 · hex · json-format · hash | Identify and peel any opaque string |
forecasting-bake-off | stock-history · fred-series · forecast-eval · forecast-naive · forecast-ses · forecast-holt · forecast-holt-winters | Rank 4 forecasters by RMSE, pick the winner |
document-intel | pdf-info · pdf-to-markdown · pdf-extract-pages · image-ocr · barcode-decode · pdf-merge · images-to-pdf | PDF/OCR/barcode pipeline |
status-snapshot | dns-lookup · http-check · http-headers · tls-cert · robots-check | One-shot service-health sweep |
All 70+ packs at /skills · JSON index at /api/skill-packs.json ·
on MCP the packs appear under prompts/list so any MCP-aware client picks them up automatically.
Agent402 is also the open routing + ranking layer for the whole x402
ecosystem: it crawls public x402 sellers (the local catalog + an
auto-discovered set from the Coinbase CDP Bazaar,
refreshed hourly) and exposes them through three free surfaces - same logic as
/api/find: discovery primitives shouldn't cost money.
| Surface | What |
|---|---|
GET /api/find?q={task} | Resolve a task to the best-matching tools (route, price, schema, ready example) |
POST /api/route | Smart Order Router: { query, top, include } → ranked tools across sellers (match score, then health, then price; a judgment model then moves the listing that actually does the task to the top, cheapest among equally good ones, reported in judged). include=external excludes Agent402 itself |
GET /api/leaderboard | On-chain ranking of x402 sellers by Base USDC settled volume (callsSettled, totalUsd, uniqueBuyers per seller). Top N only - 25 default, 50 ceiling, totalSellers for the full count. Pipeline: Bazaar → eth_getLogs → per-call ceiling → aggregate. The snapshot refreshes every 4 hours |
/marketplace | Public HTML dashboard: every seller, tool count, network, last-fetched, rolling health |
GET /api/index | The seller index as JSON (totals, per-seller health/routable flags). Paginated - one page of 250 max, complete: false and a Link header with rel="next" while more remain, sellerCount for the total. One origin, unpaged and with its crawl history: ?seller=<host> |
/stellar · /algorand | Per-chain marketplace pages: sellers and tools settling on that rail specifically |
# "I need an OCR tool - find me the cheapest healthy one anywhere on x402"
curl -X POST https://agent402.tools/api/route \
-H 'content-type: application/json' \
-d '{"query":"ocr image to text","top":5}'
# "Who are the most-used x402 sellers right now? (on-chain proof, not self-reports)"
curl 'https://agent402.tools/api/leaderboard?top=25&include=external'Dispatch is labeled, never implied: every /api/route row and /api/index
seller carries routerDispatchEligible and routerDispatchReason (crawl_failed,
network_unknown, settlement_required, settlement_checked_at_pay_time,
eligible, ...); executeVia appears only on a row the router will pay right
now (executeViaCallableNow: true), otherwise the tier moves to
executeViaWhenEligible. routable is crawl readiness, never a promise to pay.
A manifest-priced route is also read live once and then weekly, so the chains
its 402 actually offers reach the row even when the seller's manifest lags.
Health-aware: sellers whose last few crawls errored are excluded from the router (a buyer routed to a dead seller wastes money). Healthier sellers also break ties at equal match score and price, so flaky-but-cheap sellers lose to reliable ones. Brand-new sellers (no history yet) get the benefit of the doubt.
Judged fit: the lexical score rewards a listing whose name repeats the task's words, so one seller's twenty narrow routes could out-rank a general tool that does the job. A judgment model now reads a shortlist - at most two rows per seller, plus the best matches from the local catalog - and moves the listing that actually does the task to the top; when several do it equally well, the cheapest wins. It never adds a seller the settlement gate did not admit, it can say "none of these" (route-execute then refuses before anything is paid), and it fails open to the lexical order. The tools themselves still run no model; this is only how the router chooses.
Operators get 3-rail attribution on the dashboard (/api/stats,
/__operator, token-gated - it answers 404 without the operator token): USDC vs. proof-of-work vs.
heartbeat-probe traffic are counted separately - and the heartbeat rail is gated
on a POW_SECRET-signed token (not a spoofable User-Agent), so the operator
view reflects real external demand.
For API sellers: /sell is the front door -
list an existing x402-speaking API on the index for free with
POST /api/index/register (health-routed, 0%
take, self-serve, no signup), or install agent402-tollbooth to
put a pay-per-crawl gate in front of a site that isn't x402-native yet.
From code, the agent402-client npm package wraps all of this -
find() a tool, then call() it, paying automatically (a built-in proof-of-work
for free tools, your x402 wallet for paid ones), with caching and idempotent
retries:
npm install agent402-clientimport { Agent402 } from "agent402-client";
import { privateKeyToAccount } from "viem/accounts";
const a = new Agent402(); // free tier (proof-of-work)
const out = await a.call("hash", { text: "hello world", algo: "sha256" });
// a prepaid credits key pays wallet-only tools on Agent402's own services
const b = new Agent402({ creditsKey: "a402_..." });
// a signer that deposited USDC into Circle Gateway pays the batched accept
// where a 402 offers one (no gas per call); off by default
const c = new Agent402({ gateway: { signer: privateKeyToAccount(process.env.AGENT_KEY) } });agent402-client has no dependencies: install viem for privateKeyToAccount, or pass any EIP-712 signer with address and signTypedData.
services/live)A separate, read-only service that draws x402 payments on Base and MPP payments on Tempo as they settle. It reads public chain RPCs and public discovery listings, holds the last hour in memory, and fans out to browsers over one server-sent event stream; it shares no process, database or key with the API. Hosted at https://live.agent402.tools.
Run it locally (Node 22+, no dependencies):
cd services/live
PORT=8090 node server.js # then open http://localhost:8090
node test.js # offline testsOptional settings: LIVE_BASE_RPCS and LIVE_TEMPO_RPCS (comma-separated RPC URLs), LIVE_INCLUDE_UNLISTED=1 (also count Base payments to wallets no discovery listing names), LIVE_INTERNAL_PAYERS (payer wallets to label as test traffic), LIVE_MAX_PAYMENT_USD (default 50).
If you're already on one of the stacks below - OpenAI, Anthropic, the Vercel AI SDK, LangChain (JS or Python), LlamaIndex, Strands, Google ADK, or the OpenAI Agents SDK - skip the wiring: there's a drop-in package that turns the Agent402 catalog into native tool objects for your framework, with payment handled underneath (proof-of-work for free tools, x402+USDC when you pass an @x402/fetch):
| Stack | npm | Returns |
|---|---|---|
| OpenAI function-calling (chat.completions / Assistants v2 / Responses) | agent402-openai-tools | tools[] for tools: param |
Anthropic Messages API (tool_use) | agent402-anthropic-tools | tools[] for tools: param |
Vercel AI SDK (streamText / generateText) | agent402-ai-sdk | Record<name, tool()> |
| LangChain JS / LangGraph | agent402-langchain | DynamicStructuredTool[] |
| LlamaIndex TS | agent402-llamaindex | FunctionTool[] |
| Strands Agents (AWS Bedrock AgentCore) | agent402-strands | StrandsTool[] for new Agent({ tools }) |
| Google ADK (Agent Development Kit) | agent402-google-adk | FunctionTool[] for ADK agents |
| OpenAI Agents SDK | agent402-openai-agents | Agent tools for @openai/agents |
| Coinbase AgentKit (CDP, Privy, ZeroDev, viem wallets) | agent402-agentkit | an ActionProvider for AgentKit.from({ actionProviders }) |
| LangChain Python / CrewAI | agent402-langchain (PyPI) | StructuredTool[] from Agent402Toolkit.get_tools() - four meta-tools (find / route / call / about), not one per slug |
// e.g. OpenAI - every adapter has the same surface.
import OpenAI from "openai";
import { agent402Tools } from "agent402-openai-tools";
const openai = new OpenAI();
const { tools, execute } = await agent402Tools({ slugs: ["extract", "hash", "render"] });
const res = await openai.chat.completions.create({ model: "gpt-6-luna", tools, messages: [...] });
// when the model returns a tool call: await execute(call.function.name, JSON.parse(call.function.arguments));Already a Claude/MCP user? agent402-mcp is still the better path - paste https://agent402.tools/mcp into your client. The adapters are for direct API integrations where MCP isn't available. Sources: adapters/.
OpenClaw agents: drop in skills/openclaw/agent402/SKILL.md - teaches an OpenClaw agent to find, pay (x402 USDC on Base, twelve other chains accepted, or free proof-of-work), and call any of the 500+ tools and packs.
A tool is just an object in a kit array. Drop this into any file in
src/tools/ (e.g. append to AGENT_TOOLS in src/tools/agent-kit.js)
and it's live - routed, schema-published, MCP-exposed, and covered by the
"every tool answers its own example" CI check:
{
route: "POST /api/reverse",
name: "Reverse text",
slug: "reverse",
category: "text",
price: "$0.001", // free via proof-of-work once listed in src/free-tier.js
description: "Reverse a string. Example: {\"text\":\"abc\"} → {\"reversed\":\"cba\"}",
discovery: {
inputSchema: { properties: { text: { type: "string" } }, required: ["text"] },
example: { text: "abc" }, // CI calls this and checks it works
},
handler: (input) => {
if (typeof input.text !== "string") { const e = new Error('"text" required'); e.statusCode = 400; throw e; }
return { reversed: [...input.text].reverse().join("") };
},
}That's the whole contract: handler(input) returns a JSON-serializable object
(or throws an Error with .statusCode for a 4xx). A new tool is wallet-only;
a pure-CPU tool joins the free proof-of-work tier when its slug is added to
FREE_TIER_SLUGS in src/free-tier.js. See CONTRIBUTING.md for the full walkthrough.
The same server can require payment per call - useful if you host a public
instance. Payments are the default posture: a bare npm start fails closed,
exiting unless WALLET_ADDRESS is set - running without payments is the
explicit opt-in (FREE_MODE=true npm start). To charge, set WALLET_ADDRESS
PAYMENT_NETWORKS=…,robinhood +
ROBINHOOD_FACILITATOR_URL) via standard x402 clients:Every 402 is valid under @x402/core's own schemas (at most five tags, CI-checked
on all routes) and carries a typed output schema twice: in the bazaar discovery
extension and as accepts[0].outputSchema on the first accept, so a client that
reads the spec's field sees the response shape before paying.
Optional: GATEWAY_NANOPAYMENTS=on adds a Circle Gateway batched accept on Arc
and Base beside the plain one (same price, same payTo; buyers who deposited
USDC into Gateway sign per call with no gas, and Gateway settles off chain into
your Gateway balance, withdrawn with scripts/gateway-withdraw.js). Off by
default; see the wiki's Self-Hosting page. Buyers pay it from agent402-client
with the gateway option (wiki: Circle Gateway).
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/extract", {
method: "POST", headers: { "Content-Type": "application/json" },
body: JSON.stringify({ url: "https://agent402.tools/guides/x402-in-5-minutes" }),
});MPP dual-stack. The paywall also speaks MPP (Machine Payments Protocol -
the IETF-track Payment HTTP auth scheme from tempoxyz/mpp):
the same 402 carries a WWW-Authenticate: Payment challenge, Authorization: Payment credentials settle, and settled responses return a Payment-Receipt.
MPP has two methods here: evm settles identically to x402 (EIP-3009 USDC,
same facilitator, same price); tempo settles natively via
Tempo's own relay (TIP-1034/TIP-20, no x402 facilitator
involved) - a genuinely separate settlement path, set TEMPO_API_KEY to
enable it. An mppx client works out
of the box for either method; set MPP_SECRET_KEY to enable the shim on your
own instance. Same URL either way - the buyer's client picks the dialect.
Agents without a wallet still use every pure-CPU tool by solving a single-use sha256 proof-of-work (a fraction of a second on a laptop; the MCP servers do it automatically). Details: wiki: Paying with x402 · Paying with MPP · Paying with Compute.
Every claim links to the surface that proves it (the live version, a section of the docs: agent402.tools/docs#why).
POST /v1/metered/chat/completions) quotes each 402 from the request's own body; a wallet paying upto settles actual usage under that ceiling, provider discounts such as prompt-cache reads pass through, and every settled x402 or MPP response carries a receipt; a JSON answer bought with an EVM wallet can be attested on Base by that wallet (POST /api/attest).success:false, and is not charged. One exception, on the EVM chains: a transfer that lands after a timed-out settle, a disconnect during settle, or a settle the facilitator answered as pending whose receipt was not read in time, is booked as a refund owed and repaid after on-chain proof. A retry carrying the same Idempotency-Key and the same payment credential replays the paid answer instead of paying again, and a request re-sent with the same signed EVM payment is answered from its first answer even without a key (X-Replayed-Answer: 1); a settled receipt on an error response is detected by our own alarm and recorded as a debt in a refund ledger, never written off silently.POST /api/route/execute resolves a task to the best seller across the ecosystem, buys the result from that seller with our wallet and sells it to you under one receipt. Sellers are routable on proven on-chain settlement, with one bounded exception for a zero-history Base or Solana seller under a small per-call ceiling./status), a real-money canary through every on-chain rail daily, transactions published by rail and wire (/revenue), open source and self-hostable. The deterministic tools run no model; the ones that do are named (the /v1 tiers, the report products, the image, speech, transcription, embedding and AI-answer tools, the Decide planner, and the judgment model that can pick among the router's shortlisted candidates). The operator is identified on-chain: Agent402 is agent 94639 in the ERC-8004 Identity Registry on Base, resolving to /.well-known/agent-registration.json, with an A2A agent card at /.well-known/agent-card.json./status - where a day with no observation
reads "no data", never uptime, because an outage is exactly when a probe
cannot report.agent402.base.eth
(a Base name resolving to the public receiving wallet); every other chain's
receiving address is in the live 402 and at /.well-known/x402,
so anyone can verify on chain; live counts at /api/stats.Grades and purchase records kept by other services. Each runs its own checks, and we do not control what they show.
x402 is an open payment protocol built on HTTP 402 Payment Required for machine-to-machine, pay-per-call payments in stablecoins (USDC).
Most projects in the space are the protocol + SDKs,
a starter template, or a payment facilitator. Agent402 is the applied layer -
a ready-to-run x402 server that already speaks the protocol and ships 500+
working tools, so you don't have to build the catalog yourself.
Listed in the official MCP Registry and discoverable in the Coinbase x402 Bazaar.
Works with AWS Bedrock AgentCore Payments out of the box - AgentCore orchestrates x402, which is the protocol Agent402 already speaks. Point the AgentCore Gateway at https://agent402.tools/mcp for all 500+ tools, or use agent402-strands for a curated subset inside a Strands agent. Five-minute recipe: wiki: AWS Bedrock AgentCore.
Charge AI crawlers that hit your site. Humans browse free; known bots get
402 Payment Required and can pay in USDC over x402 - or solve a free
proof-of-work. Open source and self-hosted: no platform lock-in, no card processor
required, no merchant-of-record, no signup.
npm i agent402-tollbooth · tollbooth/ · tollbooth/README.mdRuns as Express middleware, a Next.js / Vercel Edge middleware, a Cloudflare
Worker, a reverse proxy, or a WordPress plugin (beta). Drop-in templates in
tollbooth/deploy/. One Web-Crypto core powers all of them.
Since 0.9.x the gate also speaks MPP natively: hand it your @x402/express
middleware (createTollbooth({ x402 })) and it mints WWW-Authenticate: Payment
evm challenges from the same 402, or give it a Tempo relay key
(createTollbooth({ tempo: { apiKey, recipient, currency, splits } })) and it
settles MPP tempo/charge credentials on Tempo with optional split payments,
with no x402 middleware at all.
Since 0.10.0 the edge build speaks MPP too: with secret, payTo and your
verifyX402 callback set, every 402 carries a WWW-Authenticate: Payment
challenge beside the x402 quote, and an Authorization: Payment credential
(HMAC-bound to that challenge, unexpired, minted for that exact resource) is
translated to PAYMENT-SIGNATURE and handed to the same verifier.
| Path | What |
|---|---|
src/server.js | Express app + the tool catalog (routes, prices, schemas, discovery) |
src/tools/ | The tool kits (web, PDF, media, images, live data, crypto/x402, 150+ pure-CPU utilities) - add tools here |
src/mcp-http.js | Hosted MCP connector (streamable HTTP, authless free tier) |
src/pow.js | Proof-of-work tier (signed, single-use, slug-scoped challenges) |
src/payments.js | Optional x402 v2 wiring: USDC on Base/Solana/Polygon/Arbitrum/Monad/Celo/Avalanche/Sei/Optimism/Arc/Ink/Stellar/Algorand + USDG on Robinhood Chain (14 chains), CDP facilitator, Bazaar discovery |
src/mpp-shim.js, src/mpp-tempo.js, src/mpp-stripe.js | MPP on the same routes: Payment challenges/credentials translated to x402 (evm), native Tempo settlement via Tempo's relay, and Stripe cards over MPP |
src/x402-index.js | x402 Index + Smart Order Router: cross-seller crawl, auto-discovery, health-aware routing, per-chain marketplace pages (/stellar, /algorand) |
src/sell.js | /sell - the seller front door: free self-serve listing (POST /api/index/register) or agent402-tollbooth for pay-per-crawl |
src/human-checkout.js | Card front door for the report products: /reports (page in src/human-reports-page.js), POST /api/buy, delivery at /r/:sessionId (Stripe Checkout, generate-once, auto-refund on failure) |
src/stripe-subscriptions.js | /monitors - $5/month monitor subscriptions (MONITOR_PRODUCTS: domain, filing, token, fund, recall, insider, research, ipo), signature-verified webhook, Customer Portal |
src/monitor-scheduler.js | Fulfilment for the monitors: cheap daily probes, paid re-runs on change, email delivery, reports at /m/:id |
src/credits.js | Prepaid card credits: /credits, a402_ bearer keys, the authorize-then-debit gate in front of every priced route |
mcp/ | The agent402-mcp npm package (stdio MCP server) |
client/ | The agent402-client buyer SDK (find() + call() with auto-payment) |
tollbooth/ | The agent402-tollbooth pay-per-crawl gate (Express / edge / proxy) |
adapters/ | Drop-in tools for every framework in the adapter table above (npm, plus langchain-py on PyPI for LangChain/CrewAI Python) |
wiki/ | Source for the GitHub wiki (CI-synced) |
scripts/ | Tests, demos, ops tooling |
/v1 chat, embeddings, images, speech) is additionally subject to the
upstream model providers' usage policies. Wallets used for prohibited content are blocked
before settlement (WALLET_BLOCKLIST).agent402-mcp (mcp/), agent402-client (client/), agent402-tollbooth (tollbooth/), agent402-openclaw (openclaw/), agent402-agentkit (adapters/agentkit/), elizaos-plugin-agent402 (adapters/eliza/) and the facilitator (facilitator/). GitHub's repository-level license badge reports the server's AGPL; a package's license field and its directory's LICENSE are what apply to that package. Provided as-is, without warranty (see LICENSE and NOTICE). "Agent402" and the logo are trademarks of Havok Holdings LLC - the license covers the code, not the name; forks must rename (see TRADEMARKS.md).
If you self-host, you are the operator: your deployment, your terms, your compliance -
Havok Holdings LLC operates only the hosted instance and is not responsible for third-party
deployments.PRs that add useful tools, fix bugs, or improve docs are very welcome - see CONTRIBUTING.md. Server AGPL-3.0, every published package MIT (see Legal above). Maintained by Havok Holdings LLC.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/agent402 to learn what the "Agent402" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y [email protected]| Name | What it does |
|---|---|
catalog.search | Keyword search over the Agent402 catalog of 500+ tools (628 loaded by this connector). Returns { results, workflows }; run one with catalog.call. 170 pure-CPU tools run free here (proof-of-work). The |
catalog.find | Resolve a plain-language task to the single best-matching Agent402 tool, returned call-ready: slug, price, input schema and a worked example. Use catalog.search to compare several candidates. Returns |
catalog.call | Run an Agent402 tool by slug, with params matching that tool's inputSchema; find slugs with catalog.find or catalog.search. The 170 pure-CPU tools run free here, rate-limited, through proof-of-work. P |
payment.info | How paying for Agent402 tools works. This connector holds no wallet: 170 pure-CPU tools run free through proof-of-work, and the rest settle in USDC over x402 or MPP (payable here). Covers wallet setup |
web.search | Paid ($0.01/call): Live web search: ranked results[] of {title, url, description (the snippet, plain text), age, publishedAt (ISO)} from an independent search index as clean JSON - fresh pages your mo |
web.answer | Paid ($0.08/call): AI-generated answer to a natural-language question, grounded in live web search results with source citations. Returns clean prose plus a structured citations array (URL, snippet, f |
web.news | Paid ($0.01/call): Live news search: ranked recent articles as results[] of {title, url, description (the snippet, plain text), age, publishedAt (ISO), source (publisher hostname), breaking} from an i |
browser.render | Paid ($0.01/call): Render a page in a real headless Chromium browser (JavaScript executed), then extract the main content as clean markdown. Use this for SPAs and JS-heavy sites where plain fetching r |
market.quote | Paid ($0.001/call): End-of-day US equity quote: last close, day range, consolidated volume, previous close and the change between them. US equities only; indices, FX and crypto are not covered (crypto |
audio.transcribe | Paid ($0.030/call): Transcribe audio to text with the gpt-transcribe model. Provide a URL to an audio file (mp3, wav, m4a, etc.) and get back the transcript. Add diarize:true for speaker labels, word |
memory.read | Paid ($0.001/call): Read from a wallet-scoped namespace. ?key=… returns the stored value; omit key to list keys. The read half of memory-write's exact-key store. For similarity retrieval over remember |
memory.write | Paid ($0.001/call): Persistent key-value memory for agents, scoped to the paying wallet. Your x402 payment IS your authentication: the wallet that pays owns the namespace. No signup, no API keys. Exac |
decide.plan | Paid ($0.010/call): Describe a job and get a call-ready plan: which tools, across this catalog and outside x402 sellers with a recently verified 402, solve it end to end, in what order, with fallbacks |
decide.execute | Paid ($0.001/call): Run a decision's plan (decisionId from POST /api/decide), or a free plan sketch (steps), through Agent402: first-party steps run directly, third-party steps are bought from the sel |
demand.request | [free] Report a capability the 500+ tools do not cover, after catalog.search or catalog.find found nothing that fits. Requests are clustered by need, and frequent ones get built. Records demand only: |
server.describe | [free] Describe this connector: the tools it lists, how to install (Claude Code / Cursor / npm), free vs paid tiers, and discovery URLs. |
decide.feedback | [free] Report whether one step of a decide.plan decision worked (success or failure, optional 1-5 quality and latency). Needs the decisionId and feedbackToken that decide.plan returned; one verdict pe |
| Name | What it does |
|---|---|
earnings-deep-dive | Everything you need before a company reports: the latest financials, recent SEC filings, the latest close, and fresh analyst news - in one pass. |
options-analytics | Price a European option on a live stock: pull the current quote, estimate volatility from recent history, run Black-Scholes for fair value + the full greeks, and check the news for catalysts. |
fixed-income-desk | Read the rate environment and price a bond in one workflow: the live Treasury curve, the 2s10s and 3M-10Y spreads, inflation context, then price and yield a specific coupon bond at current rates. |
defi-protocol-scanner | Due-diligence a DeFi protocol in one workflow: live token price, market context, protocol TVL across chains, and recent news - the on-chain and off-chain picture together. |
security-audit | Security audit skill: one call runs the external checks in sequence and returns each step's own result: certificate transparency log, DNS records, SPF, DMARC, HTTP security headers, TLS certificate an |
email-deliverability | Email deliverability skill: one chained call runs every mail check as its own step and returns each step's output, so a failing piece is visible on its own: SPF, DMARC, DKIM key strength, the combined |
market-brief | Quick crypto market snapshot: price for a specific coin, trending coins, and global market stats (total cap, BTC dominance, volume) - one call. |
financial-analysis | Quick company snapshot: latest close, 9 key financial metrics (revenue through cash flow), and upcoming earnings - one call, one payment. |
financial-research | Pull SEC filings, the latest close, historical prices, and macro context for a single ticker in one pass. |
macro-economics | Pull the canonical US macro dataset - yield curve, CPI, unemployment, fed funds, Sahm rule - without an API key. |
macro-dashboard | The full macro + crypto dashboard in one call: 5 FRED series, 5 Treasury reads, yield-curve spread, crypto market/trending/global, and live gas - a 14-tool macro + crypto basket, bundled below its a l |
dns-network-ops | End-to-end DNS health check: records, multi-resolver propagation, WHOIS, ASN, robots.txt, and reachability. |
crypto-research | Pull live price, market structure, OHLC history, trending status, global market context, and recent news for a single coin in one pass. |
content-extraction | Turn arbitrary URLs and PDFs into clean structured text - articles, page metadata, PDF pages, OCR'd images, browser-rendered SPAs. |
sec-filings-deep-dive | Pull the full EDGAR picture of a US public company in one workflow: recent filings, key financial time series, insider trades, and full-text search across the corpus. |
structured-scrape | Pull structured data out of any web page deterministically - articles to clean text, tables to JSON rows, specific elements via CSS selector - without writing regex against raw HTML. |
decode-blob | Hand the agent an opaque string - a JWT, a base64'd JSON payload, a gzip-encoded API response, a hex-encoded hash - and walk it through identifying what it is and unwrapping it layer by layer until it |
trend-analysis | Take any numeric time series - a stock's daily close, a FRED macro indicator, a treasury yield history - and run it through the full quantitative workup: descriptives, moving averages, trend line, out |
forecasting-bake-off | Don't guess which forecasting method to trust. Backtest all four (naive/drift, SES, Holt, Holt-Winters) on a real series, rank by out-of-sample RMSE, then forecast forward with the winner and its 95% |
document-intel | Turn any PDF or image URL into structured data - metadata, extracted text, sliced page ranges, OCR for scanned docs, decoded barcodes / QR codes - without falling back to a vision LLM guess. Built for |
document-brief | Metadata, an AI-written summary, and a preview of the opening pages of a PDF - understand what a document says without reading the whole thing. The catalog's first AI-summarization pack, complementary |
fraud-signals | Is this domain trustworthy, or is it a phishing site / typosquat / scam? Pull the reputation signals an analyst checks before clicking anything: domain age, cert issuance history, hosting reputation, |
api-investigation | Point at an unknown API endpoint and figure out how to use it: auth scheme, content type, version, rate limits, OpenAPI/Swagger spec discovery, and JSON response structure. The deterministic recon wor |
location-intel | Location intel skill: one call turns an address or place name into a situational brief: coordinates, the postal address, restaurants in the area, the weather forecast, active hazard alerts, and the pa |
user-onboarding | Take a signup form submission and run the full onboarding workup deterministically: validate the email, score the chosen password, mint a stable internal ID, derive a URL-safe handle from the display |
trip-planner | Plan a multi-stop journey deterministically: geocode each stop, sum the pairwise haversine distances, estimate arrival times by adding driving hours per leg, count business days from today to each arr |
macro-context | Macro backdrop snapshot: the 'is the economic backdrop you're modeling against still current?' pack. Pull the core US macro readings - CPI year-over-year, unemployment, fed funds, the Treasury yield c |
regulatory-watch | Regulatory watch skill: one call searches recent SEC filings for a theme, then pulls the top match's filings and insider trades, a reference institutional holdings report and recent S-1 IPO registrati |
search-and-cite | Search and cite skill: one call returns a cited answer to a question (the answer step is model-backed) beside web and news results for it, then fetches the top citation and extracts its entities, so e |
media-pipeline | The 'user uploaded a thing, normalize it before storing' workflow. Probe the file (image or audio/video) with media-info, decode any embedded barcodes/QRs, resize and thumbnail the image, convert it t |
schema-evolution | Schema evolution check skill: one call compares two OpenAPI snapshots and returns the structural diff, the new spec's lint score, its endpoint list, the first endpoint's required params, an empty requ |
link-preview | The 'turn a URL into a card-shaped preview' workflow. Pull OpenGraph/Twitter card metadata, fetch the article body as a description fallback, normalize the og:image into a standard 1200×630 social car |
any-to-markdown | Convert anything at a URL - HTML, PDF, or an image - to clean markdown. The 'I have a URL but it might be any content-type, give me markdown either way' workflow: HEAD-detect the content-type, branch |
status-snapshot | The 'is this site healthy, addressable, and crawlable - right now?' workflow. DNS resolution → HTTP reachability → security headers → TLS certificate expiry → robots policy. Five tools, one structured |
weather-brief | Full weather briefing for a location: current conditions, 7-day forecast, and air quality index in one pass. |
price-monitor | Side-by-side snapshot of a stock and a crypto asset: the equity's latest close against a live crypto quote, a trailing-year series for each, and a date-stamped comparison. |
wallet-readiness | One call answers 'can this wallet pay right now?' - USDC balances on Base AND Solana, live Base gas, and a ready-to-share card onramp funding link if it's running dry. |
onchain-analyst | Ask Base anything in one paid call: your SQL runs against indexed, DECODED chain data (events with parsed parameters, transactions, blocks, user-ops) with the live schema alongside - no indexer, no RP |
seo-audit | Can search engines and AI crawlers actually index this page? One pass over reachability, TLS, robots policy, sitemap health, meta/OpenGraph tags, and the on-page link graph. |
cheapest-rail | Where should an agent transact this minute? Live gas on Ethereum + every major L2 side by side, Base gas tiers, a fee estimate for your transaction type, and ETH spot to price it all in dollars. |
company-dossier | Raw company data in one parallel call: latest close, financials, recent SEC filings, insider trades over the past 90 days and past-month web results on its news, each as its own tool's answer with no |
domain-intel | Full domain security and SEO intelligence in one call: WHOIS, DNS, TLS cert, HTTP headers, tech stack, robots policy, and certificate transparency. |
crypto-dossier | Everything about a cryptocurrency in one call: live price, 90-day history, trending status, global market context, news search, and top article extraction. |
earnings-watch | Has this company just reported, and what is being said about it? Recent SEC filings, the latest close, and current coverage in one call. |
insider-alert | Insider buying/selling activity for a stock: Form 4 trades, the latest close, and recent SEC filings in one call. |
ipo-watch | What companies are going public? Recent S-1/IPO filings from EDGAR plus a web search for IPO news. |
yield-dashboard | Yield dashboard skill: one parallel call returns the latest Treasury yields at every maturity, the gaps between key maturities with the inversion flag, and the average interest the Treasury pays by se |
inflation-check | Inflation check skill: one parallel call reads the headline consumer price index change over twelve months, the effective fed funds level, the jobless figure and the Sahm Rule recession indicator, so |
fx-monitor | Major currency snapshot: EUR/USD, GBP/USD, JPY/USD rates plus the full FX dashboard in one call. |
defi-dashboard | DeFi market overview: total TVL, ETH price, Base gas, and global crypto stats in one call. |
| Name | What it does |
|---|---|
earnings-deep-dive | Everything you need before a company reports: the latest financials, recent SEC filings, the latest close, and fresh analyst news - in one pass. |
options-analytics | Price a European option on a live stock: pull the current quote, estimate volatility from recent history, run Black-Scholes for fair value + the full greeks, and check the news for catalysts. |
fixed-income-desk | Read the rate environment and price a bond in one workflow: the live Treasury curve, the 2s10s and 3M-10Y spreads, inflation context, then price and yield a specific coupon bond at current rates. |
defi-protocol-scanner | Due-diligence a DeFi protocol in one workflow: live token price, market context, protocol TVL across chains, and recent news - the on-chain and off-chain picture together. |
security-audit | Security audit skill: one call runs the external checks in sequence and returns each step's own result: certificate transparency log, DNS records, SPF, DMARC, HTTP security headers, TLS certificate an |
email-deliverability | Email deliverability skill: one chained call runs every mail check as its own step and returns each step's output, so a failing piece is visible on its own: SPF, DMARC, DKIM key strength, the combined |
market-brief | Quick crypto market snapshot: price for a specific coin, trending coins, and global market stats (total cap, BTC dominance, volume) - one call. |
financial-analysis | Quick company snapshot: latest close, 9 key financial metrics (revenue through cash flow), and upcoming earnings - one call, one payment. |
financial-research | Pull SEC filings, the latest close, historical prices, and macro context for a single ticker in one pass. |
macro-economics | Pull the canonical US macro dataset - yield curve, CPI, unemployment, fed funds, Sahm rule - without an API key. |
macro-dashboard | The full macro + crypto dashboard in one call: 5 FRED series, 5 Treasury reads, yield-curve spread, crypto market/trending/global, and live gas - a 14-tool macro + crypto basket, bundled below its a l |
dns-network-ops | End-to-end DNS health check: records, multi-resolver propagation, WHOIS, ASN, robots.txt, and reachability. |
crypto-research | Pull live price, market structure, OHLC history, trending status, global market context, and recent news for a single coin in one pass. |
content-extraction | Turn arbitrary URLs and PDFs into clean structured text - articles, page metadata, PDF pages, OCR'd images, browser-rendered SPAs. |
sec-filings-deep-dive | Pull the full EDGAR picture of a US public company in one workflow: recent filings, key financial time series, insider trades, and full-text search across the corpus. |
structured-scrape | Pull structured data out of any web page deterministically - articles to clean text, tables to JSON rows, specific elements via CSS selector - without writing regex against raw HTML. |
decode-blob | Hand the agent an opaque string - a JWT, a base64'd JSON payload, a gzip-encoded API response, a hex-encoded hash - and walk it through identifying what it is and unwrapping it layer by layer until it |
trend-analysis | Take any numeric time series - a stock's daily close, a FRED macro indicator, a treasury yield history - and run it through the full quantitative workup: descriptives, moving averages, trend line, out |
forecasting-bake-off | Don't guess which forecasting method to trust. Backtest all four (naive/drift, SES, Holt, Holt-Winters) on a real series, rank by out-of-sample RMSE, then forecast forward with the winner and its 95% |
document-intel | Turn any PDF or image URL into structured data - metadata, extracted text, sliced page ranges, OCR for scanned docs, decoded barcodes / QR codes - without falling back to a vision LLM guess. Built for |
document-brief | Metadata, an AI-written summary, and a preview of the opening pages of a PDF - understand what a document says without reading the whole thing. The catalog's first AI-summarization pack, complementary |
fraud-signals | Is this domain trustworthy, or is it a phishing site / typosquat / scam? Pull the reputation signals an analyst checks before clicking anything: domain age, cert issuance history, hosting reputation, |
api-investigation | Point at an unknown API endpoint and figure out how to use it: auth scheme, content type, version, rate limits, OpenAPI/Swagger spec discovery, and JSON response structure. The deterministic recon wor |
location-intel | Location intel skill: one call turns an address or place name into a situational brief: coordinates, the postal address, restaurants in the area, the weather forecast, active hazard alerts, and the pa |
user-onboarding | Take a signup form submission and run the full onboarding workup deterministically: validate the email, score the chosen password, mint a stable internal ID, derive a URL-safe handle from the display |
trip-planner | Plan a multi-stop journey deterministically: geocode each stop, sum the pairwise haversine distances, estimate arrival times by adding driving hours per leg, count business days from today to each arr |
macro-context | Macro backdrop snapshot: the 'is the economic backdrop you're modeling against still current?' pack. Pull the core US macro readings - CPI year-over-year, unemployment, fed funds, the Treasury yield c |
regulatory-watch | Regulatory watch skill: one call searches recent SEC filings for a theme, then pulls the top match's filings and insider trades, a reference institutional holdings report and recent S-1 IPO registrati |
search-and-cite | Search and cite skill: one call returns a cited answer to a question (the answer step is model-backed) beside web and news results for it, then fetches the top citation and extracts its entities, so e |
media-pipeline | The 'user uploaded a thing, normalize it before storing' workflow. Probe the file (image or audio/video) with media-info, decode any embedded barcodes/QRs, resize and thumbnail the image, convert it t |
schema-evolution | Schema evolution check skill: one call compares two OpenAPI snapshots and returns the structural diff, the new spec's lint score, its endpoint list, the first endpoint's required params, an empty requ |
link-preview | The 'turn a URL into a card-shaped preview' workflow. Pull OpenGraph/Twitter card metadata, fetch the article body as a description fallback, normalize the og:image into a standard 1200×630 social car |
any-to-markdown | Convert anything at a URL - HTML, PDF, or an image - to clean markdown. The 'I have a URL but it might be any content-type, give me markdown either way' workflow: HEAD-detect the content-type, branch |
status-snapshot | The 'is this site healthy, addressable, and crawlable - right now?' workflow. DNS resolution → HTTP reachability → security headers → TLS certificate expiry → robots policy. Five tools, one structured |
weather-brief | Full weather briefing for a location: current conditions, 7-day forecast, and air quality index in one pass. |
price-monitor | Side-by-side snapshot of a stock and a crypto asset: the equity's latest close against a live crypto quote, a trailing-year series for each, and a date-stamped comparison. |
wallet-readiness | One call answers 'can this wallet pay right now?' - USDC balances on Base AND Solana, live Base gas, and a ready-to-share card onramp funding link if it's running dry. |
onchain-analyst | Ask Base anything in one paid call: your SQL runs against indexed, DECODED chain data (events with parsed parameters, transactions, blocks, user-ops) with the live schema alongside - no indexer, no RP |
seo-audit | Can search engines and AI crawlers actually index this page? One pass over reachability, TLS, robots policy, sitemap health, meta/OpenGraph tags, and the on-page link graph. |
cheapest-rail | Where should an agent transact this minute? Live gas on Ethereum + every major L2 side by side, Base gas tiers, a fee estimate for your transaction type, and ETH spot to price it all in dollars. |
company-dossier | Raw company data in one parallel call: latest close, financials, recent SEC filings, insider trades over the past 90 days and past-month web results on its news, each as its own tool's answer with no |
domain-intel | Full domain security and SEO intelligence in one call: WHOIS, DNS, TLS cert, HTTP headers, tech stack, robots policy, and certificate transparency. |
crypto-dossier | Everything about a cryptocurrency in one call: live price, 90-day history, trending status, global market context, news search, and top article extraction. |
earnings-watch | Has this company just reported, and what is being said about it? Recent SEC filings, the latest close, and current coverage in one call. |
insider-alert | Insider buying/selling activity for a stock: Form 4 trades, the latest close, and recent SEC filings in one call. |
ipo-watch | What companies are going public? Recent S-1/IPO filings from EDGAR plus a web search for IPO news. |
yield-dashboard | Yield dashboard skill: one parallel call returns the latest Treasury yields at every maturity, the gaps between key maturities with the inversion flag, and the average interest the Treasury pays by se |
inflation-check | Inflation check skill: one parallel call reads the headline consumer price index change over twelve months, the effective fed funds level, the jobless figure and the Sahm Rule recession indicator, so |
fx-monitor | Major currency snapshot: EUR/USD, GBP/USD, JPY/USD rates plus the full FX dashboard in one call. |
defi-dashboard | DeFi market overview: total TVL, ETH price, Base gas, and global crypto stats in one call. |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/agent402)Nothing comparable is listed yet.
v2.8.2v2.8.2: payer-scoped answer cache, replay identity per signed payment, router buys on more EVM chainsRelease notesv2.8.1v2.8.1: cache answers keyed on every input, steadier geocoding and ENS lookupsRelease notesv2.8.0v2.8.0: dub, loop gate, email guard, page change and MCP package checksRelease notesv2.7.0v2.7.0: image and long-document judgment, exact sanctions matching, and deadlines on every outside callRelease notesv2.6.0v2.6.0: collect slow reports later, richer SEC pages, and clearer refusalsRelease notesv2.5.0v2.5.0: ElevenLabs voices, Decide plans, Claude Code on a wallet, and a live payments viewRelease notesv2.4.0v2.4.0: @x402 2.26 on our own handshake, Astra and Fable on premium, effort on the Messages wire, and a router that indeRelease notesv2.3.0v2.3.0: Typed 402s, tokenized assets, MPP on the edge, and two alarms that stopped lyingRelease notesv2.2.0v2.2.0: Agentic Finance, MPP on Tempo, reports for people, and a gateway that bills what the model usedRelease notesv2.1.0v2.1.0: Redesign, four new chains, hardened site securityRelease notesv2.0.0v2.0.0 — 500 strong: the curated catalogRelease notesv1.3.0v1.3.0 - 1,431 tools: federal-data pack, market-pulse, reliability invariantsRelease notesv1.2.0v1.2.0 — 1,407 tools + 100 skill packsRelease notesv1.1.0v1.1.0 — 6 chains, premium packs, Stellar, Stripe ACPRelease notesv1.0.0v1.0.0 — 1,338 tools + 42 skill packsRelease notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "agent402" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.