Kalshi Kernel MCP Server

by copyleftdevio.github.copyleftdev/kalshi-kernelv0.1.1

Unofficial safety-focused MCP server for Kalshi market data and explicitly authorized trading

0Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained44d ago

Install Kalshi Kernel MCP server

claude mcp add kalshi-kernel -e KALSHI_API_KEY_ID='<kalshi-api-key-id>' -- docker run -i --rm -e KALSHI_API_KEY_ID ghcr.io/copyleftdev/kalshi-kernel:0.1.1

{
  "mcpServers": {
    "kalshi-kernel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KALSHI_API_KEY_ID",
        "ghcr.io/copyleftdev/kalshi-kernel:0.1.1"
      ],
      "env": {
        "KALSHI_API_KEY_ID": "<kalshi-api-key-id>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kalshi-kernel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KALSHI_API_KEY_ID",
        "ghcr.io/copyleftdev/kalshi-kernel:0.1.1"
      ],
      "env": {
        "KALSHI_API_KEY_ID": "<kalshi-api-key-id>"
      }
    }
  }
}

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

{
  "servers": {
    "kalshi-kernel": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KALSHI_API_KEY_ID",
        "ghcr.io/copyleftdev/kalshi-kernel:0.1.1"
      ],
      "env": {
        "KALSHI_API_KEY_ID": "<kalshi-api-key-id>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kalshi-kernel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KALSHI_API_KEY_ID",
        "ghcr.io/copyleftdev/kalshi-kernel:0.1.1"
      ],
      "env": {
        "KALSHI_API_KEY_ID": "<kalshi-api-key-id>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
KALSHI_KERNEL_MODE	—	—	Immutable execution mode; paper is the safe default
KALSHI_API_KEY_ID	—	yes	Kalshi API key identifier; used only in live mode
KALSHI_PRIVATE_KEY_PATH	—	—	Path to a mounted Kalshi private key; used only in live mode
KALSHI_LIVE_TRADING_ACK	—	—	Explicit live-risk acknowledgement documented by this project

Freshness

Maintained — last maintenance signal 44d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-26 · 44d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-22 · 48d ago · official registry · v0.1.1

FAQ

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

Run: claude mcp add kalshi-kernel -e KALSHI_API_KEY_ID='<kalshi-api-key-id>' -- docker run -i --rm -e KALSHI_API_KEY_ID ghcr.io/copyleftdev/kalshi-kernel:0.1.1. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Kalshi Kernel require an API key?

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

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

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

›Is Kalshi Kernel in the official MCP registry?

Yes, as io.github.copyleftdev/kalshi-kernel.