# x402 Router

> x402 Router is a freemium MCP server for finance and payments. MCP server that finds and routes to live, probed x402 pay-per-call endpoints. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/camerxnduff/x402-router-mcp
- **MCP Registry name:** io.github.camerxnduff/x402-router
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

x402 is an HTTP 402 payment scheme where agents pay per call, and many of the endpoints that advertise it are dead, misconfigured or slow. This router probes each endpoint every three hours, checks that its 402 response has a valid version, scheme, network, payTo address, asset and amount, and ranks it on uptime and latency with a reliability score of 0 to 100. The README counts more than 24,000 live endpoints across 3,800 services.

Four tools are free and read-only: search, route, registry stats and paid-route requirements. Two paid tools, one at $0.01 USDC per call for the best endpoint and one at $0.002 for a fresh probe of a single endpoint, only pay if you configure your own wallet key with a per-call cap; otherwise they return the price and payment requirements.

A free HTTP API, status page with settled payments and discovery files sit alongside the server. Settlement uses Base USDC first, with Solana USDC as a fallback.

## Features

- **Live endpoint search:** Searches probed endpoints by chain, category, price and score.
- **Best-endpoint routing:** Picks the top match for a category and chain.
- **Reliability scores:** Scores endpoints 0 to 100 on uptime and latency.
- **Registry statistics:** Reports counts by chain, category and source.
- **Optional paid tools:** Pays per call in USDC only with your own capped wallet key.
- **Read-only by default:** Holds no keys and never pays unless configured.

## Good for

- Find a working weather or finance x402 endpoint for an agent
- Compare endpoint prices and latency before paying
- Check whether a specific endpoint is currently live
- Look at registry stats by chain

## Install

### Claude Code (Terminal)

```sh
claude mcp add x402-router -- docker run -i --rm ghcr.io/camerxnduff/x402-router-mcp:0.1.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "x402-router": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "x402-router": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "x402-router": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "x402-router": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "x402-router": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
      ]
    }
  }
}
```

## Tools

- `search_x402_endpoints`: Searches live x402 endpoints.
- `route_x402_request`: Finds the best endpoint for a request.
- `get_registry_stats`: Reports registry counts.
- `get_paid_route_requirements`: Returns payment requirements for the paid route.
- `find_best_x402_endpoint`: Paid: ranked endpoint list, $0.01 USDC per call.
- `check_x402_endpoint`: Paid: fresh live probe of one endpoint, $0.002 USDC per call.

## FAQ

### Does it spend my money?

Not by default; it is read-only, and paid tools only pay if you set your own wallet key with a per-call cap.

### What do the paid tools cost?

$0.01 USDC for the best-endpoint lookup and $0.002 USDC for a live endpoint check.

### How is it installed?

Through uvx, Docker or from source.

### How often is the registry refreshed?

Endpoints are probed every three hours.

### Is x402 Router free?

x402 Router has a free plan, with paid plans for more usage or features.

### How do I add x402 Router to Claude Code?

Run this command in your terminal: claude mcp add x402-router -- docker run -i --rm ghcr.io/camerxnduff/x402-router-mcp:0.1.0

### What are the best alternatives to x402 Router?

The closest alternatives to x402 Router are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

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