Kerdos X402 MCP Server

by singlishmanio.github.Singlishman/kerdos-x402-mcpv0.1.0

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

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing6mo ago

Install Kerdos X402 MCP server

claude mcp add kerdos-x402 -e EVM_PRIVATE_KEY='<evm-private-key>' -- npx -y kerdos-x402-mcp

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

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

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

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

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

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

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

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

Configuration

Variable	Required	Secret	Description
EVM_PRIVATE_KEY	yes	yes	User-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.
KERDOS_X402_BASE_URL	—	—	Optional override of the Kerdos x402 endpoint base URL.

Freshness

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

Last commit (default branch)
2026-04-27 · 6mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-04-27 · 6mo ago · official registry · v0.1.0

FAQ

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

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

›Does Kerdos X402 require an API key?

Yes. It expects EVM_PRIVATE_KEY, of which 1 is a secret.

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

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

›Is Kerdos X402 in the official MCP registry?

Yes, as io.github.Singlishman/kerdos-x402-mcp.