Skip to content
MCP server

x402 Router

MCP server that finds and routes to live, probed x402 pay-per-call endpoints

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, self-hosted, API
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About x402 Router

x402 Router is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "x402-router": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402-router": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Free tools; paid tools $0.01 and $0.002 USDC per call; MIT licensed

x402 Router 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.

How AIPoweredBot checks servers