X402 List MCP server
Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.
27 stars75 downloads/wk
Reviews
Write oneNobody has reviewed X402 List yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
X402 List tools (7)
write = sends, deletes, buys or postsx402_assess_servicesFreeCall this when the free signals have run out: you hold 2 to 8 finalists from x402_search_services or x402_find_best_service, their stored fields do not separate them for YOUR stated need, and choosing wrong costs more than a quarter. It buys one fresh AI assessment reasoned against your question, not a cached grade; reading an already-computed assessment stays free via x402_get_service. Price: a one-time $0.25 USDC on Base, over two calls. Call once WITHOUT payment_signature_b64 to receive the x402 payment challenge verbatim (accepts[], amount, payTo, and a base64 PAYMENT-REQUIRED header); sign accepts[0] client-side with your own wallet; call again with the SAME question and services plus payment_signature_b64 to receive the report and a base64 PAYMENT-RESPONSE settlement receipt. This server holds no keys, never signs and never settles: it only relays the challenge. Optionally add probe { slug, endpoint_path? } to have one listed service paid and called for real and its answer analyzed: the challenge is then priced at $0.25 plus that endpoint price X, and the report gains a probe_report block with a verdict and truncated extracts, never the verbatim third-party body. When live probing is not armed the probe is ignored. Caveats: read the amount to sign from accepts[0].amount, never from a fixed figure, since a probe changes it; probe fees are non-refundable whatever the verdict; if the fresh run cannot be produced the server answers before settling, so you are never charged for nothing; there is no refund. Prices are US dollars.
x402_change_eventsFreeCall this before you trust anything you cached about a service, and right after a payment failed for no obvious reason: the monitor's log of what moved under you. Returns payTo, price and 402-schema changes observed on listed services, most recent first, in exactly three event types (payto_changed, price_changed, schema_changed). Filter with service (the slug), type, and days (1 to 365, default 90). Caveats: prices here are atomic token amounts, never dollars, and every payTo is masked by design, so the feed reports THAT the payout address changed, never the address. Free and read-only.
x402_check_healthFreeCall this before you send a payment, or right after a call unexpectedly failed: is this service up right now. With no slug, the directory snapshot: five status counts across 500+ services (include_services=true attaches every row). With a slug: that service's status, its 24h/7d/30d/90d uptime windows, response time, consecutive failures, daily snapshots. No money fields.
x402_facilitator_volumesFreeCall this when the question is about the rail rather than the service: which x402 facilitator actually settles money, and how much. Returns on-chain-verified settlement volume and transaction counts per facilitator for today (UTC), 7d, 30d and all-time, plus a verification flag ('on-chain' once volume has been observed on-chain, else 'listed'), across more than 30 facilitators. Optional daily timeseries (up to 90 days) and per-chain breakdown. Volume is decimal USD. Caveats: PER-FACILITATOR, never per-service; the *_24h fields cover today (UTC) so far, not a trailing 24 hours, and reset at 00:00 UTC, so prefer 7d.
x402_find_best_serviceFreeCall this when you have a need in words and want one service to call rather than a list to read: it is the free ranking step between searching and paying. Pass the need as q, plus any category, network, price cap or verification requirement, and get up to 20 ranked recommendations with the basis each one placed on. Ranking is mostly per-service reliability (live status, verification, uptime, response time), x402 compliance, and price in USD, with a small (about 10%) weight on measured on-chain settlement traction that can never dominate those three. The response carries ranking_version (currently 3), need_blind_ranking (true when no q was given, so the order is global quality rather than your need), and a units map holding every scoring caveat in full: the compliance cap, the pro-quota rule for shared payout addresses, renormalization, the $10 volume floor, and the single-buyer discount. Read units before comparing scores across generations.
x402_get_serviceFreeCall this once you hold a slug and are deciding whether to commit to that service: the full record behind a directory row. Live status, uptime over 24h/7d/30d/90d, average response time, networks and settlement asset, every priced endpoint, and the assessment block. include_series=true adds 90 daily points of on-chain volume and distinct buyers. Read the units map in the response: the per-endpoint price field is atomic token units, not dollars.
x402_search_servicesFreeYour first call when you do not know which x402 service exists for a job: it narrows a directory of 500+ listed services to candidates. Filter by free-text query, category, network, live status, and whether the last observed 402 envelope is signable by a standard x402 client; sort by newest, uptime, cheapest, or endpoints. Returns up to 100 compact summaries a page: price in decimal USD, uptime, status, verification. Then x402_get_service for the full record.
Public scan report
scanner v0.1.9 · 2026-09-20 · same rubric, same numbers if you re-run it
- Code scan15 source files scanned25/25
- Live reliabilityremote reachable in 1641ms20/20
- Tool poisoning7 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 19 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace7/10
What the publisher says
From the X402 List repository's README, as published. We do not edit it. Read it on GitHub
x402-list-mcp
MCP server for x402-list: discover x402 payment services and on-chain-verified facilitator settlement volume.
Upgrading from 0.4.x? Every tool was renamed. 0.5.0 moved all of them into the x402_* namespace
and removed the old names, with no compatibility aliases: a tools/call for get_service or
searchx402services now comes back as a JSON-RPC -32602 "Tool not found", and the old names are
absent from tools/list too. The old-to-new table and the upgrade checklist (prompts, client
allow lists, eval fixtures) are in CHANGELOG.md.
What is x402-list
x402-list is the directory of services that accept x402 (HTTP 402 stablecoin) payments. Its distinctive, defensible data is on-chain-verified settlement volume per facilitator, not self-reported numbers. Listed services are continuously health-monitored (uptime, response time, status).
This package is a thin wrapper over the public x402-list HTTP JSON API. It holds no keys, touches no database, and makes no writes to the directory. It exposes the directory to AI agents through the Model Context Protocol as seven tools: six are free and read-only, and the seventh, x402assessservices, is the only paid one, a pass-through that relays an x402 payment challenge you sign yourself client-side (the package never holds keys, never signs, and never settles).
Install and quick start
stdio (local MCP clients)
npx -y x402-list-mcpClaude Desktop / generic MCP client config:
{ "mcpServers": { "x402-list": { "command": "npx", "args": ["-y", "x402-list-mcp"] } } }Hosted HTTP (Streamable HTTP transport)
MCP_HTTP_PORT=3000 npx -y x402-list-mcp --httpHosted endpoint: https://mcp.x402-list.com/mcp. Health probe: GET /healthz returns {"status":"ok"}.
Environment variables
Tools
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp
X402 List: common questions
- Is X402 List MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the X402 List safety report
- How do I install X402 List?
- It runs remotely at mcp.x402-list.com. Add it to Claude Code, Claude Desktop or Cursor with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does X402 List need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is X402 List maintained?
- The last commit was 19 days ago (2026-09-01). The latest release is v0.5.1.
- Is X402 List up?
- 100% of our last 6 checks got an answer. We check remote servers about four times a day.
- What can I use instead of X402 List?
- Servers from other publishers that do the same job: PipRail MCP server, X402 Payment Safety MCP server and Agent402.Tools: pay-per-call web tools MCP server. Compare all X402 List alternatives.
Alternatives to X402 List
Same job from other publishers: the closest match first, then the best rated.
- PipRailBudget-bound x402 payment wallet for AI agents — pays HTTP 402 URLs, capped locally. No backend.not reviewedGrowingB
- X402 Payment SafetyAuthorize x402 payments before signing with request-bound, signed safety decisions.not reviewedGrowingA
- Agent402.Tools: pay-per-call web toolsAgentic Finance: 500+ agent tools, multi-chain USDC over x402 or MPP, free via PoW or card creditsnot reviewedEstablishedA
POPCORN MCPSigned time and SHA-256 witness receipts for agents, with offline verification and x402 payment.not reviewedGrowingB- X402 Data GatewayPaid x402 and MPP tools for agent discovery, payment safety, data, and DeFi.not reviewedGrowingB