x402 Micro Tollgate MCP Server

by kevin2003050666-coderio.github.kevin2003050666-coder/x402-micro-tollgatev0.3.3

HTTP 402 and MCP paywall for any API: unpaid requests get a 402, agents pay USDC on Base, then the request is proxied. Also serves paid MCP tools.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained35d ago

Install x402 Micro Tollgate MCP server

claude mcp add x402-micro-tollgate -e CDP_API_KEY_ID='<cdp-api-key-id>' -e CDP_API_KEY_SECRET='<cdp-api-key-secret>' -- npx -y x402-micro-tollgate --stdio

{
  "mcpServers": {
    "x402-micro-tollgate": {
      "command": "npx",
      "args": [
        "-y",
        "x402-micro-tollgate",
        "--stdio"
      ],
      "env": {
        "CDP_API_KEY_ID": "<cdp-api-key-id>",
        "CDP_API_KEY_SECRET": "<cdp-api-key-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "x402-micro-tollgate": {
      "command": "npx",
      "args": [
        "-y",
        "x402-micro-tollgate",
        "--stdio"
      ],
      "env": {
        "CDP_API_KEY_ID": "<cdp-api-key-id>",
        "CDP_API_KEY_SECRET": "<cdp-api-key-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "x402-micro-tollgate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "x402-micro-tollgate",
        "--stdio"
      ],
      "env": {
        "CDP_API_KEY_ID": "<cdp-api-key-id>",
        "CDP_API_KEY_SECRET": "<cdp-api-key-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "x402-micro-tollgate": {
      "command": "npx",
      "args": [
        "-y",
        "x402-micro-tollgate",
        "--stdio"
      ],
      "env": {
        "CDP_API_KEY_ID": "<cdp-api-key-id>",
        "CDP_API_KEY_SECRET": "<cdp-api-key-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CDP_API_KEY_ID	—	yes	Coinbase CDP API key ID for the x402 facilitator
CDP_API_KEY_SECRET	—	yes	Coinbase CDP API key secret for the x402 facilitator
X402_PAY_TO	—	—	EVM address that receives USDC settlements
UPSTREAM_URL	—	—	Upstream HTTP API to proxy after payment (omit for built-in mock)
PRICE	—	—	Dollar price per paid call, e.g. $0.001
NETWORK	—	—	CAIP-2 network id (eip155:84532 Base Sepolia or eip155:8453 Base)
X402_ENVIRONMENT	—	—	development or production

Freshness

Maintained — last maintenance signal 35d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-05 · 35d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-03 · 37d ago · official registry · v0.3.3

FAQ

›How do I install the x402 Micro Tollgate MCP server in Claude Code?

Run: claude mcp add x402-micro-tollgate -e CDP_API_KEY_ID='<cdp-api-key-id>' -e CDP_API_KEY_SECRET='<cdp-api-key-secret>' -- npx -y x402-micro-tollgate --stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does x402 Micro Tollgate require an API key?

Yes. It expects CDP_API_KEY_ID, CDP_API_KEY_SECRET, of which 2 are secrets.

›Can I use x402 Micro Tollgate as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is x402 Micro Tollgate in the official MCP registry?

Yes, as io.github.kevin2003050666-coder/x402-micro-tollgate.