x402

What your agent can do

x402 gives your agent 10 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →pay_request — Pay for a 402-protected resource. Sends USDC payment via x402 protocol and returns the resource content. The agent automatically handles the 402 handshake.
• →verify_payment — Verify if a x402 payment was received and settled on-chain
• →create_paywall — Create a x402 paywall configuration for an endpoint. When requests hit this endpoint, they receive HTTP 402 with payment instructions.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("pay_request", { /* ... */ });

Install

$ npm install @codespar/mcp-x402

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-x402"
      ],
      "env": {
        "X402_API_KEY": "<your_x402_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 10 tools below — try pay_request first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 10

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions