@codespar/mcp-x402
v0.1.1
Published
MCP server for x402 — HTTP-native micropayments protocol by Coinbase (USDC on Base/Solana)
Maintainers
Readme
@codespar/mcp-x402
MCP server for x402 — HTTP-native micropayments protocol by Coinbase (USDC on Base/Solana)
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-x402Cursor / 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
| Tool | Description |
|------|-------------|
| pay_request | Pay for a 402-protected resource and return its content |
| verify_payment | Verify if a x402 payment was received and settled on-chain |
| create_paywall | Create a x402 paywall configuration for an endpoint |
| get_paywall | Get paywall configuration for a URL |
| list_paywalls | List all configured paywalls |
| delete_paywall | Remove a paywall from an endpoint |
| get_balance | Get available USDC balance for x402 payments |
| list_payments | List x402 payment history with filters |
| get_payment | Get details of a specific x402 payment |
| get_supported_networks | List supported blockchain networks and tokens |
Authentication
x402 uses a Bearer API key from a registered facilitator.
Get your credentials
- Visit the x402 documentation
- Set up a facilitator or use Coinbase's hosted facilitator
- Generate an API key
- Get your wallet address (Base or Solana)
- Set the environment variables
Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| X402_API_KEY | Yes | API key for x402 facilitator |
| X402_WALLET_ADDRESS | Yes | Wallet address for sending/receiving payments |
| X402_NETWORK | No | Blockchain network: base (default) or solana |
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 endpointestimate_cost— Estimate cost before paying for a resourcebatch_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
License
MIT
