x402-list-mcp — Claude Code MCP server: what it does, how to install
Inspects x402 payment APIs before triggering a transaction, tracking uptime, pricing, and on-chain settlement numbers directly from your agent.
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcpWhat x402-list-mcp does
The package acts as a light interface to the public x402-list JSON API. It does not touch databases, never alters registry records, and stores no keys.
Seven tools are exposed to the model. Six functions handle read-only queries free of charge. They search service listings, check uptime streaks, read USD pricing per endpoint, and inspect settlement volume. The seventh tool, x402_assess_services, is a paid benchmark costing 0.25 USDC on Base. It works strictly as a relay. You must sign the payment challenge on your client, because the server does not store private credentials or execute transfers.
You can point your client to the hosted HTTP endpoint or execute the npm package locally over stdio. Running it locally requires Node.js 20 or newer alongside npm.
What it helps with
- discover APIs accepting x402 micropayments
- verify endpoint response times and recent outages
- review on-chain facilitator settlement volume
- monitor payout address and pricing changes
Example prompts for the agent
- Search the x402 directory for transcription services sorted by uptime.
- Identify the top-ranked endpoint using x402_find_best_service.
- Review price and schema modifications via x402_change_events for the past 30 days.
How to install x402-list-mcp
1Platform CLI: remote server
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp2Platform CLI
claude mcp add --env X402_LIST_BASE_URL=<X402_LIST_BASE_URL> --env X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> --transport stdio x402-list-mcp -- npx -y x402-list-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add x402-list-mcp --url https://mcp.x402-list.com/mcp2Platform CLI
codex mcp add x402-list-mcp --env X402_LIST_BASE_URL=<X402_LIST_BASE_URL> --env X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> -- npx -y x402-list-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"x402-list-mcp": {
"url": "https://mcp.x402-list.com/mcp"
}
}
}{
"mcpServers": {
"x402-list-mcp": {
"command": "npx",
"args": [
"-y",
"x402-list-mcp"
],
"env": {
"X402_LIST_BASE_URL": "<X402_LIST_BASE_URL>",
"X402_LIST_TIMEOUT_MS": "<X402_LIST_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"x402-list-mcp": {
"type": "http",
"url": "https://mcp.x402-list.com/mcp"
}
}
}{
"servers": {
"x402-list-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"x402-list-mcp"
],
"env": {
"X402_LIST_BASE_URL": "<X402_LIST_BASE_URL>",
"X402_LIST_TIMEOUT_MS": "<X402_LIST_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http x402-list-mcp https://mcp.x402-list.com/mcp2Platform CLI
gemini mcp add -e X402_LIST_BASE_URL=<X402_LIST_BASE_URL> -e X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> x402-list-mcp npx -y x402-list-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about x402-list-mcp
How do I install x402-list-mcp in Claude Code?
Run this terminal command: claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp. It links Claude Code to the hosted service without local builds.
What does x402-list-mcp do?
It gives AI assistants tools to search and evaluate x402 micropayment services. Agents can audit uptime, check endpoint prices, and inspect on-chain settlement records.
Does the server handle wallet keys or payments?
No, the server holds no credentials and never executes transactions. When using the paid assessment tool, it returns a challenge that requires signing on the client side.
