MCP Server

Active

MIT

com.x402-list/x402-list-mcp MCP Server

com.x402-list/x402-list-mcp

Discover and vet x402 payment APIs: uptime, pricing, and on-chain-verified settlement volume.

What is the com.x402-list/x402-list-mcp MCP server?

The x402-list-mcp MCP server is a directory of services that accept x402 (HTTP 402 stablecoin) payments, with on-chain-verified settlement volume per facilitator and continuous health monitoring. It exposes six free read-only tools and one paid assessment tool to help AI agents find, filter, and evaluate payment services by reliability, compliance, and cost.

x402-list-mcp lets you search and vet x402 payment services before your agent uses them. It provides real uptime data, pricing, on-chain settlement volume per facilitator, and live health checks—all grounded in on-chain verification rather than self-reported metrics. Use it to find the best service for a payment need, monitor service changes, and assess shortlists with fresh comparisons.

How to install com.x402-list/x402-list-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

X402_LIST_BASE_URL
API base URL. The /api/v1 prefix is appended automatically.
X402_LIST_TIMEOUT_MS
Per-request timeout in milliseconds.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "x402-list-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402-list-mcp"
      ],
      "env": {
        "X402_LIST_BASE_URL": "<YOUR_X402_LIST_BASE_URL>",
        "X402_LIST_TIMEOUT_MS": "<YOUR_X402_LIST_TIMEOUT_MS>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

x402_search_services — Search and filter the directory by query, category, network, status, and signable flag; sort by newest, uptime, cheapest, or endpoints.
x402_get_service — Retrieve full details for one service by slug: endpoints, per-endpoint USD pricing, uptime windows, networks, and settlement asset.
x402_find_best_service — Get a ranked recommendation for a stated need, computed server-side by reliability, x402 compliance, price, and on-chain traction.
x402_check_health — Check live status directory-wide or per service, including uptime snapshots and consecutive failure counts.
x402_facilitator_volumes — Retrieve per-facilitator on-chain-verified settlement volume in USD, transaction counts, and verification flags for today, 7d, 30d, and all-time.
x402_change_events — Free read-only feed of service changes (payto_changed, price_changed, schema_changed) with diffs, timestamps, and before/after snapshots; filterable by service, type, and days.
x402_assess_services — Paid ($0.25 USDC on Base) on-demand AI comparison of a shortlist for a stated need; optionally probe one service live; requires client-side signing of x402 challenge.

Use cases

Find the most reliable and cheapest x402 payment service for a specific use case before your agent initiates a payment.
Monitor uptime, price changes, and schema updates across listed x402 services to detect when to switch providers.
Assess on-chain settlement volume per facilitator to gauge ecosystem health and service legitimacy.
Get a ranked recommendation of services tailored to your reliability, compliance, and cost requirements.
Probe a shortlisted service live and get an AI-generated comparison report to make a final selection.

com.x402-list/x402-list-mcp MCP server FAQ

What is x402-list-mcp?

It's an MCP server that wraps the x402-list directory of stablecoin payment services. It exposes six free read-only tools to search, filter, and monitor services, plus one paid tool ($0.25 USDC) for on-demand AI assessment.

Is it free to use?

Six of the seven tools are free and read-only. The seventh tool, x402_assess_services, costs $0.25 USDC per call on Base and requires you to sign an x402 challenge client-side.

How do I install it in Claude or Cursor?

Add it to your MCP client config: {"mcpServers": {"x402-list": {"command": "npx", "args": ["-y", "x402-list-mcp"]}}}. Or use the hosted HTTP endpoint at https://mcp.x402-list.com/mcp.

Does it require authentication or API keys?

No. The package holds no keys, touches no database, and makes no writes. It's a thin read-only wrapper over the public x402-list HTTP API.

What data does it provide?

Service details (endpoints, pricing, uptime), on-chain-verified settlement volume per facilitator, live health status, change events, and ranked recommendations based on reliability, compliance, and price.

Can I use it to make payments?

No. The x402_assess_services tool is a pass-through that relays an x402 payment challenge you sign yourself; the package never holds keys, signs, or settles payments.

README (reference)

Source of truth, from the repository.

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 search_x402_services 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, x402_assess_services, 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-mcp

Claude 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 --http

Hosted endpoint: https://mcp.x402-list.com/mcp. Health probe: GET /healthz returns {"status":"ok"}.

Environment variables

Variable	Default	Purpose
`X402_LIST_BASE_URL`	`https://x402-list.com`	API base URL. The `/api/v1` prefix is appended automatically.
`X402_LIST_TIMEOUT_MS`	`15000`	Per-request timeout in milliseconds.
`MCP_HTTP_PORT` / `PORT`	`3000`	HTTP port. Setting `MCP_HTTP_PORT` selects HTTP transport.
`MCP_ALLOWED_ORIGINS`	(empty, permissive)	Comma list of allowed CORS origins for HTTP mode.
`MCP_ALLOWED_HOSTS`	(empty, off)	Comma list that enables DNS-rebinding protection in HTTP mode.

Tools

Tool	What it does
`x402_search_services`	Search and filter the directory by query, category, network, status, and `signable` (whether the last observed 402 envelope carries the EIP-712 domain parameters a standard x402 client needs in order to sign); sort by newest/uptime/cheapest/endpoints.
`x402_get_service`	Full detail for one service by slug: endpoints, per-endpoint USD pricing, uptime windows, networks, settlement asset.
`x402_find_best_service`	Ranked recommendation for a need, computed server-side (GET /api/v1/best). Ranks mostly by reliability, x402 compliance and price (status, verified, uptime, response time, USD price), with a small (~10%) weight on per-service on-chain traction that can never dominate those three. The answer carries `ranking_version`, 3 today (see below), and a `units` map holding every scoring caveat in full.
`x402_check_health`	Live status, directory-wide or per service (uptime snapshots, consecutive failures).
`x402_facilitator_volumes`	Per-facilitator on-chain-verified settlement volume (today UTC/7d/30d/all) in USD, tx counts, and an on-chain vs listed flag. The `*_24h` fields cover today (UTC) so far, not a trailing 24-hour window.
`x402_change_events`	Free, read-only feed of what the monitor observed changing on listed services, most recent first, in exactly three event types (`payto_changed`, `price_changed`, `schema_changed`). Filter by `service` (the listing slug: the parameter is named `service`, not `slug`), by `type`, and by `days` (1 to 365, default 90); page with `page` / `per_page` (up to 100 per page). Each event carries the observation timestamp, a diff summary, and the before/after 402 snapshots. Prices inside an event are atomic token amounts, never dollars, and every payout address is returned masked by the API: the feed reports THAT the payTo changed, never the address.
`x402_assess_services`	Paid ($0.25 USDC on Base, x402). Fresh on-demand AI comparison of a shortlist of listed services for a stated need. Pass-through: it never holds keys, never signs, and never settles. Call without `payment_signature_b64` to get the x402 challenge verbatim, sign it client-side, then retry with the signature to get the report. Optionally add a `probe` target `{ slug, endpoint_path? }` to also test one listed service live: the price becomes $0.25 plus that endpoint price X (non-refundable), and the report gains a `probe_report` block with a verdict and truncated extracts, never the verbatim third-party body.

Ranking generations

x402_find_best_service returns the scoring generation it was produced under. Today it is 3. Scores you stored under an earlier generation are not comparable with these, because the math moved:

Generation 2 capped the compliance term at 0.6, the floor of the C band, when at least one of a service's EVM routes was observed missing the EIP-712 domain parameters (extra.name, extra.version) a standard x402 client needs in order to sign a payment. A fact about the envelope on the wire, not a judgement on the merit of the service.
Generation 3 added the anti-wash rules on the traction term: an absolute floor of $10 on 30d settlement volume, below which the term scores 0 because sub-floor volume is indistinguishable from dust and must not move rank; a discount on a payout concentrated in one buyer, up to half the traction term when a single buyer accounts for all of it, since one buyer is one relationship and not the broad demand the term is meant to reward; and a service that publishes no mappable payTo now scores 0 on that term instead of having the weight renormalized away, so hiding the payout address no longer beats having a measured one.

Units note

All monetary values are decimal US dollars and are passed through verbatim. There is no cents conversion anywhere. The per-endpoint pricing[].price field is a raw atomic on-chain token amount (a uint256 string), not dollars; only price_usd is the dollar figure.

Honesty note

Two different on-chain volume signals; do not conflate them. Facilitator volume (x402_facilitator_volumes) is the ecosystem headline, aggregated per facilitator. Per-service traction (the traction block on each service, weighed at ~10% inside x402_find_best_service) is settlement measured over a service's own payTo via recognized settlers - a deliberate conservative undercount, not an estimate: unattributed settlements are left out, never scaled up. When a payTo is shared across services (shared_payout: true), only settlement VOLUME is attributed pro-quota, the operator-level volume over that address divided across the services sharing it, which is a declared convention and not an individually observed measure, while transaction count and unique buyers stay whole operator-level integers; a service on a network not yet measured, or a shared-payout member whose probe has been failing, carries no traction term at all and the remaining weights are renormalized over it. Never read shared, pro-quota or unmeasured volume as one service's revenue. To ask "which facilitators have real on-chain volume", use x402_facilitator_volumes and read the verification flag.

Source

The source code is not public yet. This package is a thin read-only wrapper over the public x402-list REST API, documented at https://x402-list.com/api.

License

MIT

Related MCP servers

X402 Git

Buy private git repos and agent skills with USDC over x402. Read the manifest free, then pay.

x402receipts