Kalshi MCP server

MCP Server Kalshi

<!-- mcp-name: io.github.9crusher/mcp-server-kalshi -->

An MCP server that gives Claude Code and other agent harnesses a first-class interface to Kalshi. It is built for end-to-end trading: browse markets, research them, read the exact settlement rules (including pulling the contract-terms PDFs), and execute trades — all through MCP tools.

Highlights

getseries. (Kalshi has no free-text search; listmarkets filters are the search.)

• Discovery — listmarkets, getmarket, listevents, getevent, list_series,

early-close conditions, settlement sources, and series prohibitions; fetchrulespdf downloads and extracts the text of the actual legal contract PDF so the agent can read it.

• Research — getmarketorderbook, getmarketcandlesticks, getmarkettrades.
• Deep rules — getmarketrules consolidates a market's rulesprimary/rulessecondary,

plus listorders / getorder.

• Exchange — getexchangestatus, getexchangeschedule (is the market open, and its hours).
• Portfolio — getbalance, getpositions, getfills, getsettlements.
• Trading — createorder, cancelorder, amendorder, decreaseorder,

Safety by default

KALSHI_ENV=prod.

• The server targets Kalshi's demo (sandbox) environment unless you explicitly set

return a preview — a human-readable summary and the exact payload — and place nothing.

• Order-placing tools (createorder, amendorder) require confirm=true. Without it they

and order tools need an API key + RSA private key.

• Credentials are optional: all market/rules tools work unauthenticated. Only portfolio

Intuitive order model

Kalshi's V2 order API quotes everything from the YES leg (bid/ask in fixed-point dollars). This server exposes the natural model instead — action (buy/sell) + side (yes/no) + a whole cents limit price — and translates it (including the buy-NO ⇄ sell-YES price inversion).

Configuration

See .env-example. Get API credentials at docs.kalshi.com/gettingstarted/apikeys and a demo account via the demo environment guide.

Claude Desktop (uvx)

"mcpServers": {
  "kalshi": {
    "command": "uvx",
    "args": ["mcp-server-kalshi"],
    "env": {
      "KALSHI_ENV": "demo",
      "KALSHI_API_KEY": "<YOUR KALSHI API KEY>",
      "KALSHI_PRIVATE_KEY_PATH": "PATH TO YOUR RSA KEY FILE"
    }
  }
}

Claude Desktop (Docker)

"mcpServers": {
  "kalshi": {
    "command": "docker",
    "args": ["run", "--rm", "-i",
      "--mount", "type=bind,src=/Users/username,dst=/Users/username",
      "-e", "KALSHI_ENV", "-e", "KALSHI_API_KEY", "-e", "KALSHI_PRIVATE_KEY_PATH",
      "mcp-server-kalshi"],
    "env": {
      "KALSHI_ENV": "demo",
      "KALSHI_API_KEY": "<YOUR KALSHI API KEY>",
      "KALSHI_PRIVATE_KEY_PATH": "PATH TO YOUR RSA KEY FILE"
    }
  }
}

Local Development

1. Create a .env file (see .env-example).
2. Install deps: uv sync (add --extra dev for dev tools). Requires Python 3.10+.
3. Run: uv run start.
4. Test: uv run pytest.

MCP Inspector

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-kalshi run start

Testing & code quality

Shortened. The full README is on GitHub.