obolpay-x402-mcp

📖 Tutorial: Let your AI agent autonomously buy data — x402 + gasless prepaid + MCP on Base

MCP server for the live Obolpay x402 gateway — pay-per-call premium data for AI agents, settled in USDC on Base mainnet via HTTP 402.

Give any MCP-compatible agent (Claude Desktop, etc.) the ability to discover → evaluate (free preview) → pay once → then call GASLESS forever → verify a signed receipt — autonomously.

Tools

Related MCP server: x402-mcp

Why it's different

• Free preview before paying — evaluate the data, no blind spend.

• Prepaid GASLESS balance — deposit USDC once, then unlimited cheap calls via off-chain signed vouchers.

• Signed receipts — EIP-191 proof-of-purchase, verifiable at /verify-receipt.

• Freshness SLA + auto-refund — stale data is auto-refunded to your balance.

• Delta delivery (X-Since-Seq) — only new items, saves your context tokens.

Run

pip install -r requirements.txt          # mcp[cli], web3, eth-account, requests
export X402_AGENT_PRIVATE_KEY=0x...       # a Base wallet with USDC + a little ETH for gas
# optional: export X402_BASE_URL=https://x402.obolpay.xyz   (default)
python x402_mcp_server.py

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "obolpay-x402": {
      "command": "python",
      "args": ["/absolute/path/to/x402_mcp_server.py"],
      "env": { "X402_AGENT_PRIVATE_KEY": "0x..." }
    }
  }
}

Links

• Live endpoint: https://x402.obolpay.xyz

• Discovery manifest: https://x402.obolpay.xyz/.well-known/x402

• Reference client (non-MCP): https://x402.obolpay.xyz/client.py

Built on x402 + Base. USDC micropayments for the AI agent economy.