Mcp X402

@codespar/mcp-x402

Deprecated: no live endpoint. Measured on 2026-09-27 against two public DNS resolvers (8.8.8.8 and 1.1.1.1): api.x402.org, the only host this server calls, does not resolve in DNS. x402 has no central API: it is an HTTP 402 protocol, and each seller picks the facilitator that verifies payment. No tool in this server reaches a service. The package is deprecated on npm and stays in this repository for reference only. If you have a working endpoint, point the server at it with X402_BASE_URL. To bring the package back, open an issue in mcp-dev-latam with the provider's documented base URL.

MCP server for x402 — HTTP-native micropayments protocol by Coinbase (USDC on Base/Solana)

[npm] [License: MIT]

What is x402?

x402 is an open protocol that enables machine-to-machine micropayments at the HTTP layer. When an AI agent requests a resource and receives HTTP 402 Payment Required, it automatically sends a USDC payment on-chain and retries — no checkout UI, no merchant integration, pure HTTP.

This is the payment rail purpose-built for agentic commerce.

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{  "mcpServers": {    "x402": {      "command": "npx",      "args": ["-y", "@codespar/mcp-x402"],      "env": {        "X402_API_KEY": "your-key",        "X402_WALLET_ADDRESS": "your-wallet-address"      }    }  }}

Claude Code

claude mcp add x402 -- npx @codespar/mcp-x402

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{  "servers": {    "x402": {      "command": "npx",      "args": ["-y", "@codespar/mcp-x402"],      "env": {        "X402_API_KEY": "your-key",        "X402_WALLET_ADDRESS": "your-wallet-address"      }    }  }}

Tools (10)

Authentication

x402 uses a Bearer API key from a registered facilitator.

Get your credentials

1. Visit the x402 documentation
2. Set up a facilitator or use Coinbase's hosted facilitator
3. Generate an API key
4. Get your wallet address (Base or Solana)
5. Set the environment variables

Environment Variables

Use Cases

• Agent accessing premium APIs — AI agent pays per-request for data feeds, LLM APIs, or premium content
• Micropayment monetization — Protect your API endpoints with sub-cent paywalls
• Machine-to-machine commerce — Agents autonomously purchasing compute, data, or services

Roadmap

v0.2 (planned)

• create_subscription — Set up recurring micropayments for an endpoint
• estimate_cost — Estimate cost before paying for a resource
• batch_pay — Pay for multiple resources in a single transaction

v0.3 (planned)

• Multi-token support (ETH, SOL beyond USDC)
• Streaming payments for long-running agent tasks

Want to contribute? Open a PR or request a tool.

Links

• x402 Protocol (Coinbase)
• x402 Specification
• MCP Dev LATAM
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT