x402 Router
MCP server that finds and routes to live, probed x402 pay-per-call endpoints
- 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.0Add to claude_desktop_config.json
{
"mcpServers": {
"x402-router": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"x402-router": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/camerxnduff/x402-router-mcp:0.1.0"
]
}
}
}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.


