X402 List MCP server
{
"mcpServers": {
"x402-list": {
"command": "npx",
"args": [
"-y",
"x402-list-mcp@latest",
"x402-list-mcp"
],
"env": {
"X402_LIST_BASE_URL": "https://..."
}
}
}
}{
"mcpServers": {
"x402-list": {
"command": "npx",
"args": [
"-y",
"x402-list-mcp@latest",
"x402-list-mcp"
],
"env": {
"X402_LIST_BASE_URL": "https://..."
}
}
}
}{
"mcpServers": {
"x402-list": {
"command": "npx",
"args": [
"-y",
"x402-list-mcp@latest",
"x402-list-mcp"
],
"env": {
"X402_LIST_BASE_URL": "https://..."
}
}
}
}{
"servers": {
"x402-list": {
"command": "npx",
"args": [
"-y",
"x402-list-mcp@latest",
"x402-list-mcp"
],
"env": {
"X402_LIST_BASE_URL": "${input:x402_list_base_url}"
}
}
},
"inputs": [
{
"id": "x402_list_base_url",
"type": "promptString",
"description": "X402 list base url",
"password": true
}
]
}{
"mcpServers": {
"x402-list": {
"command": "npx",
"args": [
"-y",
"x402-list-mcp@latest",
"x402-list-mcp"
],
"env": {
"X402_LIST_BASE_URL": "https://..."
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y x402-list-mcpversion 0.5.1
What it does
This MCP server provides access to x402-list, a directory of HTTP 402 stablecoin payment services with on-chain-verified settlement data. It exposes tools for searching services, checking health and uptime, retrieving pricing, and getting ranked recommendations for payment service selection.
- Search and filter x402 payment services by category, network, price, and compliance status before directing an agent to use one.
- Check real-time uptime and health metrics for listed payment services to assess reliability before committing to a payment flow.
- Get a ranked recommendation for which payment service best fits a specific need, ranked by reliability, x402 compliance, and price.
Tools this server exposes
| Tool | Does |
|---|---|
| x402_search_services | Search and filter the directory by query, category, network, status, and signable flag; sort by newest, uptime, price, or endpoints. |
| x402_get_service | Retrieve full details for one service including endpoints, per-endpoint pricing in USD, uptime windows, supported networks, and settlement asset. |
| x402_find_best_service | Get a server-side ranked recommendation for a payment service need, scored primarily by reliability, x402 compliance, and price with minor weight on on-chain tr |
| x402_check_health | Retrieve live status snapshots for the directory or a specific service, including uptime and failure counts. |
| x402_facilitator_volumes | Retrieve per-facilitator on-chain-verified settlement volume in USD and transaction counts across time periods (24h, 7d, 30d, all-time). |
| x402_change_events | Access a feed of observed changes on listed services (payto, price, schema changes) with before/after 402 snapshots, filterable by service and type. |
| x402_assess_services | Paid tool ($0.25 USDC on Base) for on-demand AI comparison of shortlisted services for a stated need; supports optional live endpoint probing. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.