io.github.x402node/x402-mcp

Official

by x402node · JavaScript

600+ pay-per-call x402 APIs: crypto/forex, on-chain data, web extract, aviation. Base+Solana USDC.

Access 600+ pay-per-call APIs for crypto, forex, on-chain data, and web extraction.

crypto apiforex dataon-chain datasolanablockchain analyticsweb scraping

Topics

agenticagentic-commerceai-agentbase-networkclaudecursorm2m-paymentmachine-to-machinemcpmcp-servermicropaymentmodel-context-protocolmulti-chainpay-per-callpolygonsolanastablecoinusdcx402x402-payment

README.md2 KBView on GitHub

x402-mcp

MCP server bringing 100+ x402-paid APIs to AI agents (Claude, Cursor, MCP-aware clients). Auto-discovers tools from CDP Bazaar; handles USDC micropayments on Base.

Features

Auto-discovers x402 endpoints from CDP Bazaar (no hard-coded list)
Reads metadata directly from Bazaar (description, schema, pricing)
Refreshes every 5 min — new endpoints appear without restart
Handles HTTP 402 + USDC payment automatically
Multi-chain ready via x402 protocol (Base today; Solana, Polygon, BNB, EVM expansion)

Install (Claude Desktop)

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": ["-y", "x402node-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_BASE_PRIVATE_KEY" }
    }
  }
}

Set X402_PRIVATE_KEY to a Base EOA private key (hex, 0x-prefixed) with USDC on Base mainnet. Restart Claude Desktop. The server auto-discovers ~117 tools on first run.

Cost Safety

Each tool call costs $0.0001-$0.10 USDC depending on endpoint
Hard cap: MAX_PRICE_USD env var (default $0.10/call); calls above are blocked
Use a fresh burner wallet, not your main wallet

How it works

Agent calls tool -> HTTP 402 -> x402-fetch signs EIP-3009 -> CDP Facilitator settles on Base -> response returned. Buyer pays no gas.

Development

bash

git clone https://github.com/x402node/x402-mcp
cd x402-mcp
npm install
cp .env.example .env  # edit X402_PRIVATE_KEY
node mcp-server.js

License

MIT

Install

Configuration

Environment variables

X402_PRIVATE_KEYrequiredsecret

Base mainnet wallet private key (0x-prefixed hex) used to pay x402 endpoints in USDC. Keep a small USDC balance. Use a burner wallet.

claude_desktop_config.json

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402node-mcp@1.0.3"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<YOUR_X402_PRIVATE_KEY>"
      }
    }
  }
}