X402 MCP Server

by carboncashmereio.github.CarbonCashmere/x402-mcpv0.2.2

177 crypto market intel endpoints with auto x402 USDC micropayments from your AI agent

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing5mo ago

Install X402 MCP server

claude mcp add x402-carboncashmere -e EVM_PRIVATE_KEY='<evm-private-key>' -e SVM_PRIVATE_KEY='<svm-private-key>' -- npx -y @carbon-cashmere/x402-mcp

{
  "mcpServers": {
    "x402-carboncashmere": {
      "command": "npx",
      "args": [
        "-y",
        "@carbon-cashmere/x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<evm-private-key>",
        "SVM_PRIVATE_KEY": "<svm-private-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "x402-carboncashmere": {
      "command": "npx",
      "args": [
        "-y",
        "@carbon-cashmere/x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<evm-private-key>",
        "SVM_PRIVATE_KEY": "<svm-private-key>"
      }
    }
  }
}

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

{
  "servers": {
    "x402-carboncashmere": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@carbon-cashmere/x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<evm-private-key>",
        "SVM_PRIVATE_KEY": "<svm-private-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "x402-carboncashmere": {
      "command": "npx",
      "args": [
        "-y",
        "@carbon-cashmere/x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<evm-private-key>",
        "SVM_PRIVATE_KEY": "<svm-private-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
EVM_PRIVATE_KEY	—	yes	0x-hex private key for Base/Polygon/Arbitrum USDC payments (dedicated wallet)
SVM_PRIVATE_KEY	—	yes	base58 Solana keypair for Solana USDC payments (optional)
X402_TOOL_LIMIT	—	—	Max tools exposed (1-177, default 100)

Freshness

Slowing — last maintenance signal 5mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-05-20 · 5mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-05-20 · 5mo ago · official registry · v0.2.2

FAQ

›How do I install the X402 MCP server in Claude Code?

Run: claude mcp add x402-carboncashmere -e EVM_PRIVATE_KEY='<evm-private-key>' -e SVM_PRIVATE_KEY='<svm-private-key>' -- npx -y @carbon-cashmere/x402-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does X402 require an API key?

Yes. It expects EVM_PRIVATE_KEY, SVM_PRIVATE_KEY, of which 2 are secrets.

›Can I use X402 as a remote (hosted) MCP server?

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

›Is X402 in the official MCP registry?

Yes, as io.github.CarbonCashmere/x402-mcp.