@x402-api/mcp-server

MCP server that gives Claude, ChatGPT, and any MCP-compatible AI agent access to pay-per-call crypto/DeFi data via the x402 protocol.

8 tools. No API keys. AI agents pay USDC micropayments on Base, per request.

  ██╗  ██╗██╗  ██╗ ██████╗ ██████╗
   ╚██╗██╔╝██║  ██║██╔═══██╗╚════██╗
    ╚███╔╝ ███████║██║   ██║ █████╔╝
    ██╔██╗ ╚════██║██║   ██║██╔═══╝
   ██╔╝ ██╗     ██║╚██████╔╝███████╗
   ╚═╝  ╚═╝     ╚═╝ ╚═════╝ ╚══════╝

Tools

| Tool | API Endpoint | Cost | Description | |------|-------------|------|-------------| | get_crypto_prices | GET /api/price-feed | 0.001 USDC | BTC/ETH/SOL + top 24h movers | | get_gas_prices | GET /api/gas-tracker | 0.001 USDC | Multi-chain gas (ETH, Base, Polygon, Arbitrum) | | get_dex_quotes | GET /api/dex-quotes | 0.002 USDC | Swap quotes: Uniswap, SushiSwap, 1inch | | scan_token | GET /api/token-scanner | 0.003 USDC | Token security scan + rug-pull detection | | track_whales | GET /api/whale-tracker | 0.005 USDC | Holder concentration + whale alerts | | scan_yields | GET /api/yield-scanner | 0.005 USDC | DeFi yields: Aave, Compound, Morpho, Lido, Pendle | | get_funding_rates | GET /api/funding-rates | 0.008 USDC | Perp funding rates across 6 venues | | profile_wallet | GET /api/wallet-profiler | 0.008 USDC | Full wallet portfolio + risk profile |

Quick Start

Option A: Inspect mode (no payment needed)

Just run it — any 402 responses will return human-readable payment instructions:

npx @x402-api/mcp-server

Claude will tell you what's needed when a tool requires payment.

Option B: Auto-pay mode (fully autonomous)

Install optional payment deps and set your wallet key:

npm install -g @x402-api/mcp-server
npm install -g x402-fetch viem
export X402_WALLET_PRIVATE_KEY=0x<your_private_key>
x402-api-mcp

The server will auto-pay 402 responses using USDC on Base. Make sure your wallet has USDC on Base mainnet.

Claude Desktop Integration

Add to your claude_desktop_config.json:

Without auto-pay (inspect mode)

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": ["@x402-api/mcp-server"]
    }
  }
}

With auto-pay

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": ["@x402-api/mcp-server"],
      "env": {
        "X402_WALLET_PRIVATE_KEY": "0x<your_private_key>"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | X402_WALLET_PRIVATE_KEY | Optional | Private key for auto-pay (e.g. 0x...). If set, x402-fetch handles payments automatically. | | X402_API_BASE_URL | Optional | Override API URL (default: https://x402-api.fly.dev) |

How x402 Payments Work

This API uses the x402 protocol — HTTP 402 Payment Required:

1. Agent calls tool → MCP server makes API request
2. Server returns 402 with payment details (amount, USDC address, Base network)
3. Auto-pay mode: x402-fetch signs and submits payment, retries request automatically
4. Manual mode: MCP returns 402 details so user/agent can arrange payment

Payment details:

• Token: USDC on Base mainnet
• Address: 0x60264c480b67adb557efEd22Cf0e7ceA792DefB7
• Chain: Base (chain ID 8453)
• Amount: 0.001–0.008 USDC per call (< 1 cent USD)

Tool Reference

get_crypto_prices

No parameters. Returns current prices for BTC, ETH, SOL + top 24h movers.

Cost: 0.001 USDC

get_gas_prices

No parameters. Returns gas prices for Ethereum, Base, Polygon, Arbitrum — slow/standard/fast tiers.

Cost: 0.001 USDC

get_dex_quotes

Compare swap quotes across DEXes.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | from | string | ✅ | Input token (e.g. "ETH", "0x...") | | to | string | ✅ | Output token (e.g. "USDC") | | amount | string | ✅ | Amount to swap (e.g. "1.5") |

Cost: 0.002 USDC

scan_token

Token security scan — detects rug-pull flags, honeypot patterns, mint authority, etc.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | token | string | ✅ | Contract address or symbol (e.g. "PEPE") |

Cost: 0.003 USDC

track_whales

Whale tracking — holder concentration, Gini coefficient, recent large moves.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | token | string | ✅ | Contract address or symbol |

Cost: 0.005 USDC

scan_yields

Top DeFi yield opportunities across Aave, Compound, Morpho, Lido, Pendle, etc.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | chain | string | ❌ | Filter by chain: "ethereum", "base", "arbitrum", "polygon" | | min_tvl | number | ❌ | Minimum TVL in USD (e.g. 1000000) |

Cost: 0.005 USDC

get_funding_rates

Perpetual funding rates across Binance, OKX, Bybit, dYdX, GMX, Hyperliquid.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | asset | string | ❌ | Asset symbol (e.g. "BTC", "ETH"). All assets if omitted. |

Cost: 0.008 USDC

profile_wallet

Full wallet portfolio analysis — holdings, DeFi positions, activity, PnL, risk score.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | address | string | ✅ | Ethereum/Base wallet address (0x...) |

Cost: 0.008 USDC

Development

git clone https://github.com/fernsugi/x402-api-mcp-server
cd x402-api-mcp-server

npm install
npm run build
npm start

To test without a payment wallet, simply run and see the 402 responses:

node dist/index.js

Links

• x402 API Landing Page
• x402 Protocol
• Base Chain
• ERC-8004 Agent Identity
• Agent #18763 on BaseScan

License

MIT