Skip to content
MCP server

X402 List MCP

Look up x402 payment APIs by uptime, price and on-chain volume before an agent pays

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

Add to Settings → Connectors → Add custom connector

https://mcp.x402-list.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402-list-mcp": {
      "url": "https://mcp.x402-list.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools