Agent402: 500+ tools, metered models and finished reports for AI agents

MCP serverCommerce & finance

agent402 gives your AI access to 500+ finance and commerce tools. Once added, your AI can use these tools to handle agentic finance tasks on your behalf. Access is free via proof of work, or you can pay using prepaid card credits.

Use Agent402: 500+ tools, metered models and finished reports for AI agents in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Agent402: 500+ tools, metered models and finished reports for AI agents and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the catalog.search tool from Agent402: 500+ tools, metered models and finished reports for AI agents

Details

Available today. Use it from your connected AI after setup.

Add agent402 to your AI, then choose how you want to pay for access: free via proof of work or with prepaid card credits.

Agent402: 500+ tools, metered models and finished reports for AI agentsStart free

What your AI can do with it

  • Access 500+ finance and commerce tools
  • Run agentic finance tasks over x402 or MPP
  • Use tools for free via proof of work
  • Pay for usage with prepaid card credits

Install Agent402: 500+ tools, metered models and finished reports for AI agents

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user agent402-500-tools-metered-model 'https://agent402.tools/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://agent402.tools/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=agent402-500-tools-metered-model&config=eyJ1cmwiOiJodHRwczovL2FnZW50NDAyLnRvb2xzL21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://agent402.tools/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add agent402-500-tools-metered-model --url 'https://agent402.tools/mcp'

    Run it once, then sign in with codex mcp login agent402-500-tools-metered-model if the server asks for an account.

From the project's README

As published by mikeypetrillo/agent402 in README.md.

Live at agent402.tools.

The paid door for AI agents: 500+ tools, metered models and finished reports, paid per call in USDC over x402 and MPP, or by card. 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 agent402-mcp, 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 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.

What Agent402 is

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.01 or less can be tried before that, marked unproven on the buyer's receipt. Charging crawlers on your own site instead? agent402-tollbooth puts 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/route is the neutral Smart Order Router: rank tools across every x402 seller crawled (auto-discovered from the Coinbase CDP Bazaar), health-aware, with include=external to exclude us. The response returns the top N and carries matched for how many scored.
  • Leaderboard - GET /api/leaderboard is 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; totalSellers carries the full count). Pipeline: Bazaar → eth_getLogs → per-call ceiling → aggregate by payTo. Hourly snapshot.

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 already issued keeps paying per successful call (Authorization: Bearer a402_…; new credits are not 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 11 chains or USDG on Robinhood Chain) and MPP (Machine Payments Protocol, the IETF-track Payment HTTP auth scheme co-authored by Tempo and Stripe): the same 402 carries both, an mppx client 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 (Stripe stripe/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 already issued 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, Stellar & Algorand, plus USDG on Robinhood Chain - 12 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 · 🧩 Smithery

Run it yourself in 30 seconds

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/mcp

2. 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 agent402-mcp
# in Claude Code:  claude mcp add agent402 -- npx -y agent402-mcp

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. One-click deploy to Railway (full self-hosted instance - adds optional Postgres + Redis plugins for analytics + response caching):

Boots straight from the repo's railway.toml + Dockerfile. Optional plugins are auto-detected via env: add Redis → REDIS_URL enables the upstream response cache (X-Cache: hit|miss), add Postgres → DATABASE_URL enables the public /api/analytics dashboard and the tollbooth waitlist. No env vars required to boot in free mode.

Pay per call from a wallet

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.

What's in the catalog (500+ tools)

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 & webrender (headless Chromium, executes JS), screenshot, extract (article→markdown), meta
Live search & answerssearch (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 & mediapdf-to-markdown, pdf-merge, pdf-extract-pages, pdf-rotate, images-to-pdf, audio-convert, audio-normalize (EBU R128, real ffmpeg)
Imagesimage-resize, image-convert, image-thumbnail, barcode-decode (jimp/zxing, pure-CPU)
OCRimage-ocr (text out of any image - pure-CPU, no model)
Geogeo-distance (haversine, pure-CPU), geocode, reverse-geocode, place-search, geo-lookup
Live datafx-rate (ECB), barcode-lookup (Open Food Facts), gov-data (data.gov), weather-forecast/weather-alerts, earthquakes (USGS)
Finance & cryptostock-quote/stock-history (Databento, three-venue consolidation), crypto-price/crypto-market/crypto-history/crypto-trending/crypto-global (CoinGecko)
Crypto derivatives & optionsperp-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 & stablecoinsdefi-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 intelsol-token-safety (authorities, liquidity, holder concentration, graded), sol-token-report (full risk write-up), sol-token-holders, sol-token-pairs, sol-token-search, sol-trending, sol-price, sol-swap-quote, sol-token-lookup - the due-diligence pass an agent needs before it touches a mint
Crypto market coveragecrypto-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 dataasset-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 socialfc-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 crawlingsite-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 EDGARticker→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 due diligence), 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 truthdns, dns-lookup, tls-cert, whois, http-check, robots-check, email-validate, ip-info
Crypto & paymentsusdc-balance, tx-status, gas-estimate, ens-resolve, x402-quote, x402-verify, transfer-authorization - non-custodial, multi-chain (Base/Polygon/Arbitrum/Optimism/Ethereum)
Agent memorywallet-keyed KV + TTL, atomic counters, cross-wallet grants, hash-chained audit log, similarity recall
Stats & forecastingstats-summary, correlation, linear-regression, moving-average, outliers; forecast-naive, forecast-ses, forecast-holt, forecast-holt-winters + forecast-eval (MAPE/RMSE backtest)
Finance mathblack-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)
Compressiongzip/gunzip, brotli-compress/brotli-decompress, compress-compare (algorithm shootout, pure-CPU via node:zlib)
HTML extractionhtml-select (CSS query), html-table, html-strip, html-links, html-meta - deterministic counterpart to extract
Network opsdns-lookup, dns-propagation, spf-check/dmarc-check/dkim-lookup, email-deliverability; cert-transparency, http-headers (security audit), tech-stack, asn-info (IP geo)
Chain readsblock-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 policysql-guard ($0.004 - pass/warn/block verdict with named risks on a SQL statement, plus an Ed25519 execution certificate when a signing key is configured), sql-cert-verify ($0.001 - verifies that certificate against the exact statement)
x402 seller intelligenceThree 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 utilitieshashing, 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.

LLM gateway (/v1) - chat, embeddings, rerank, images, speech & finished reports, pay per call

Point any OpenAI SDK at base_url = https://agent402.tools/v1 and pay per call in USDC over x402 or MPP - no API key, no signup, no account (a prepaid credits key already issued also works, see For humans):

Shortened here. Read the whole README on GitHub.

Tools it offers (18)

What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

  • catalog.search
  • catalog.find
  • catalog.call
  • payment.info
  • web.search
  • web.answer
  • web.news
  • browser.render
  • market.quote
  • audio.transcribe
  • memory.read
  • memory.write
  • decide.plan
  • decide.execute
  • demand.request
  • server.describe
  • decide.feedback
  • sellers.list

Signals

GitHub stars
38
Forks
28
Last commit
Oct 2026
Weekly downloads
963
Weekly_downloads
963 weekly_downloads
Advanced
Delivery
agent402 MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-mikeypetrillo-agent402
Source
github.com/mikeypetrillo/agent402
Hosted endpoint
https://agent402.tools/mcp