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
Discovery — listmarkets, getmarket, listevents, getevent, listseries,
getseries. (Kalshi has no free-text search; listmarkets filters are the search.)
Research — getmarketorderbook, getmarketcandlesticks, getmarkettrades.
Deep rules — getmarketrules consolidates a market's rulesprimary/rulessecondary,
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.
Exchange — getexchangestatus, getexchangeschedule (is the market open, and its hours).
Portfolio — getbalance, getpositions, getfills, getsettlements.
Trading — createorder, cancelorder, amendorder, decreaseorder,
plus listorders / getorder.
### Safety by default
The server targets Kalshi's demo (sandbox) environment unless you explicitly set
KALSHIENV=prod.
Order-placing tools (createorder, amendorder) require confirm=true. Without it they
return a preview — a human-readable summary and the exact payload — and place nothing.
Credentials are optional: all market/rules tools work unauthenticated. Only portfolio
and order tools need an API key + RSA private key.
### 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
| Variable | Default | Purpose |
| KALSHIENV | demo | demo (sandbox) or prod (real money). Derives the base URL. |
| KALSHIAPIKEY | (none) | Kalshi API key ID. Required only for authenticated tools. |
| KALSHIPRIVATEKEYPATH | (none) | Path to your RSA private key .pem. Required for authenticated tools. |
| BASEURL | (derived) | Optional explicit REST base override (must include /trade-api/v2). |
See .env-example. Get API credentials at
docs.kalshi.com/gettingstarted/apikeys
and a demo account via the
demo environment guide.
### Claude Desktop (uvx)
json
"mcpServers": {
"kalshi": {
"command": "uvx",
"args": ["mcp-server-kalshi"],
"env": {
"KALSHIENV": "demo",
"KALSHIAPIKEY": " ",
"KALSHIPRIVATEKEYPATH": "PATH TO YOUR RSA KEY FILE"
### Claude Desktop (Docker)
json
"mcpServers": {
"kalshi": {
"command": "docker",
"args": ["run", "--rm", "-i",
"--mount", "type=bind,src=/Users/username,dst=/Users/username",
"-e", "KALSHIENV", "-e", "KALSHIAPIKEY", "-e", "KALSHIPRIVATEKEYPATH",
"mcp-server-kalshi"],
"env": {
"KALSHIENV": "demo",
"KALSHIAPIKEY": " ",
"KALSHIPRIVATEKEYPATH": "PATH TO YOUR RSA KEY FILE"
## Local Development
1. Create a .env file (see .env-example).