Skip to content
MCP server

X402 MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.2
Listing updated
5 days ago

About X402 MCP

X402 MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add x402-mcp --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' --env SVM_PRIVATE_KEY='<SVM_PRIVATE_KEY>' -- npx -y @carbon-cashmere/x402-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "x402-mcp": {
      "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

{
  "mcpServers": {
    "x402-mcp": {
      "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

{
  "servers": {
    "x402-mcp": {
      "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 ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • EVM_PRIVATE_KEY0x-hex private key for Base/Polygon/Arbitrum USDC payments (dedicated wallet)
  • SVM_PRIVATE_KEYbase58 Solana keypair for Solana USDC payments (optional)
  • X402_TOOL_LIMITMax tools exposed (1-177, default 100)

Pricing

Open source

X402 MCP FAQ

Is X402 MCP free?

Yes. X402 MCP is open source, so you can use and self-host it for free.

How do I add X402 MCP to Claude Code?

Run this command in your terminal: claude mcp add x402-mcp --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' --env SVM_PRIVATE_KEY='<SVM_PRIVATE_KEY>' -- npx -y @carbon-cashmere/x402-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers