MCP server for x402, an HTTP-native micropayments protocol by Coinbase. It supports 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.

🛠️ Key Features

Implements MCP server for x402
x402 enables micropayments at the HTTP layer using USDC on-chain (Base/Solana, per description)
Uses HTTP 402 Payment Required flow to trigger payment and retry

🚀 Use Cases

Agentic commerce scenarios where an AI agent requests protected resources
Payments and open-finance use cases involving USDC-based micropayments
Latin America and Brazil-related integrations (topics include brazil, latin-america)

⚡ Developer Benefits

Fits Model Context Protocol workflows for LLM tools (topics include llm-tools, mcp)
Aligns payment triggering with standard HTTP behavior via 402 Payment Required

⚠️ Limitations

Readme excerpt provided is truncated (“no checkout U…”), so full operational details are not included

@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:

json

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

Claude Code

bash

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

Cursor / VS Code

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

json

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

Tools (10)

Tool	Purpose
`pay_request`	Pay for a 402-protected resource.
`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 specific URL
`list_paywalls`	List all configured x402 paywalls
`delete_paywall`	Remove a x402 paywall from an endpoint
`get_balance`	Get available USDC balance for x402 payments
`list_payments`	List x402 payment history with optional filters
`get_payment`	Get details of a specific x402 payment
`get_supported_networks`	List supported blockchain networks, tokens, and facilitators for x402 payments

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 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.

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

io.github.codespar/mcp-x402