Polymarket Prediction Markets

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["@serendb/x402-mcp-server"],
      "env": {
        "X402_GATEWAY_URL": "https://x402.serendb.com",
        "WALLET_PRIVATE_KEY": "0x...",
        "BASE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

claude mcp add x402 \
  --env X402_GATEWAY_URL=https://x402.serendb.com \
  --env WALLET_PRIVATE_KEY=your_private_key \
  --env BASE_RPC_URL=https://mainnet.base.org \
  -- npx @serendb/x402-mcp-server

Replace your_private_key with your actual private key.

First, install globally to avoid timeout issues:

npm install -g @serendb/x402-mcp-server

Then add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "x402": {
      "command": "x402-mcp-server",
      "args": [],
      "env": {
        "X402_GATEWAY_URL": "https://x402.serendb.com",
        "WALLET_PRIVATE_KEY": "0x...",
        "BASE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

1. Send your query request to the gateway
2. Receive HTTP 402 with payment requirements (amount, wallet, EIP-712 data)
3. Sign the payment authorization with your wallet
4. Retry request with X-PAYMENT header containing the signature
5. Receive your data - payment settles automatically via USDC on Base

curl -X POST https://x402.serendb.com/api/proxy \
  -H "Content-Type: application/json" \
  -d '{
    "providerId": "dfbf416d-3061-464c-b4b0-665692f11fd5",
    "agentWallet": "0xYourWalletAddress",
    "request": {
      "method": "GET",
      "path": "/endpoint"
    }
  }'

This returns 402 Payment Required with the payment details you need to sign.

After signing the EIP-712 authorization, add the base64-encoded signature:

curl -X POST https://x402.serendb.com/api/proxy \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64-encoded-signature>" \
  -d '{ ... }'