X402 List MCP
Look up x402 payment APIs by uptime, price and on-chain volume before an agent pays
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally or Remotely
- Version
- 0.5.3
- Listing updated
- 2 days ago
About X402 List MCP
X402 List MCP is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
The directory behind this server tracks listed services that charge per request over x402, a stablecoin payment flow built on HTTP 402. At the time of the website snapshot it listed 1,328 services and 10,675 active endpoints across 38 mainnet networks, with monitored uptime and measured settlement activity per facilitator. The site is careful to say its figures are a measured floor, not an ecosystem total.
The npm package is a thin wrapper over the public x402-list JSON API. The README says it holds no keys, touches no database and writes nothing to the directory. Of its seven tools, six are free read-only lookups; the seventh, x402_assess_services, relays a payment challenge that you sign on your own side.
You can run it locally over stdio with npx or connect to the hosted endpoint at mcp.x402-list.com. Reading the directory is free (up to 2,000 GET requests per IP per day); a few actions such as support tickets, live delivery verification and on-demand assessments cost small USDC amounts on Base.
Install
Run in a terminal
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.x402-list.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"x402-list-mcp": {
"url": "https://mcp.x402-list.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"x402-list-mcp": {
"type": "http",
"url": "https://mcp.x402-list.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"x402-list-mcp": {
"serverUrl": "https://mcp.x402-list.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"x402-list-mcp": {
"type": "http",
"url": "https://mcp.x402-list.com/mcp"
}
}
}Configuration
X402_LIST_BASE_URLAPI base URL. The /api/v1 prefix is appended automatically.X402_LIST_TIMEOUT_MSPer-request timeout in milliseconds.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- x402_assess_services
- The only paid tool: compares a shortlist of listed services for a stated need, relaying an x402 payment challenge you sign yourself.
What it does
- Service vetting
- Look up listed x402 services with monitored health and pricing before sending a payment.
- Facilitator settlement data
- Compare on-chain settlement volume and chain coverage per facilitator.
- Paid assessment pass-through
- x402_assess_services relays a payment challenge that the caller signs; the package never holds keys.
- Local or hosted
- Run the npm package over stdio or use the hosted streamable-HTTP endpoint.
- Configurable API base
- X402_LIST_BASE_URL and X402_LIST_TIMEOUT_MS let you point at another instance or change the timeout.
Good for
- Let an agent compare x402 APIs by price and uptime before choosing one
- Check whether a payment service is still answering
- Review settlement concentration across facilitators
- Request a fresh assessment of a shortlist of services
Pricing
Freemium
Directory reads free; extra reads $0.01 USDC, assessment $0.25 USDC, paid in USDC on Base
Prices change. Check x402-list.com before you buy.
X402 List MCP FAQ
Does the server hold my wallet keys?
No. The README says the package holds no keys and never signs or settles; you sign any payment challenge client-side.
How many tools does it expose?
Seven: six free and read-only, plus the paid x402_assess_services.
What does the free tier cover?
Browsing the directory and API reads up to 2,000 GET requests per IP per UTC day; each extra request costs $0.01 USDC.
What does it need to run locally?
Node.js 20 or newer and npm; the hosted connection needs no local Node.js.
Is X402 List MCP free?
X402 List MCP has a free plan, with paid plans for more usage or features.
How do I add X402 List MCP to Claude Code?
Run this command in your terminal: claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp
What are the best alternatives to X402 List MCP?
The closest alternatives to X402 List MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to X402 List MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools