CrossFin MCP Server

by bubilife1202io.github.bubilife1202/crossfinv1.18.0

Korean and global crypto exchange routing and arbitrage signals, with x402 USDC micropayments.

1Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale8mo ago

Install CrossFin MCP server

claude mcp add bubilife1202 -e EVM_PRIVATE_KEY='<evm-private-key>' -- npx -y crossfin-mcp

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

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

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

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

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

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

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

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

Configuration

Variable	Required	Secret	Description
EVM_PRIVATE_KEY	—	yes	Base wallet private key for x402 USDC payments (only needed for paid tools)
CROSSFIN_API_URL	—	—	API base URL (default: https://crossfin.dev)
CROSSFIN_LEDGER_PATH	—	—	Local ledger file path (default: ~/.crossfin/ledger.json)

Remote endpoints

streamable-httphttps://crossfin.dev/api/mcp

Freshness

Stale — last maintenance signal 8mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-02-26 · 8mo ago · GitHub
Latest release
2026-02-15 · 8mo ago · GitHub · v1.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-02-25 · 8mo ago · official registry · v1.18.0

FAQ

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

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

›Does CrossFin require an API key?

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

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

Yes — it offers both a hosted endpoint and a local stdio package.

›Is CrossFin in the official MCP registry?

Yes, as io.github.bubilife1202/crossfin.