# X402 List MCP

> X402 List MCP is a freemium MCP server for finance and payments. Look up x402 payment APIs by uptime, price and on-chain volume before an agent pays. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://x402-list.com
- **Repository:** https://github.com/mcccsm/x402-list-mcp
- **MCP Registry name:** com.x402-list/x402-list-mcp
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.x402-list.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "x402-list-mcp": {
      "url": "https://mcp.x402-list.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "x402-list-mcp": {
      "type": "http",
      "url": "https://mcp.x402-list.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "x402-list-mcp": {
      "serverUrl": "https://mcp.x402-list.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "x402-list-mcp": {
      "type": "http",
      "url": "https://mcp.x402-list.com/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/x402-list-mcp
