Skip to content
MCP server

Kerdos X402 MCP

Crypto market intelligence MCP — pay-per-tool-call in USDC on Base via the x402 protocol.

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

About Kerdos X402 MCP

Kerdos 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 kerdos-x402-mcp --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y kerdos-x402-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kerdos-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kerdos-x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kerdos-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kerdos-x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "kerdos-x402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kerdos-x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kerdos-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kerdos-x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kerdos-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kerdos-x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

Configuration

  • EVM_PRIVATE_KEYUser-supplied EVM private key on Base mainnet. Used solely to sign USDC `transferWithAuthorization` payment payloads via x402. Each tool call costs $0.01-$0.06 USDC.Required
  • KERDOS_X402_BASE_URLOptional override of the Kerdos x402 endpoint base URL.

Pricing

Open source

Kerdos X402 MCP FAQ

Is Kerdos X402 MCP free?

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

How do I add Kerdos X402 MCP to Claude Code?

Run this command in your terminal: claude mcp add kerdos-x402-mcp --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y kerdos-x402-mcp