Happy slice of mcp pizzaMCP.pizza

mcp-server-kalshi

MCP.Pizza Chef: 9crusher

This server connects your AI assistant to Kalshi prediction markets, letting you explore markets, read exact legal rules, and manage trades all in one place. You can browse market listings, check order books, and even download contract PDFs for deep research. Trading features require setting up API keys and confirming orders, ensuring safety. It works with Claude Desktop and other MCP clients but needs a developer-level setup using command-line tools or Docker.

Other
Web/Research

Use This MCP server To

Browse available Kalshi prediction markets Read detailed rules and contract PDFs for markets Check market order books and recent trades View my portfolio balance and open positions Place, amend, or cancel trades on Kalshi Get real-time market open hours and status Preview trade orders before confirming them

README

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 — list_markets, get_market, list_events, get_event, list_series, get_series. (Kalshi has no free-text search; list_markets filters are the search.)
  • Research — get_market_orderbook, get_market_candlesticks, get_market_trades.
  • Deep rules — get_market_rules consolidates a market's rules_primary/rules_secondary, early-close conditions, settlement sources, and series prohibitions; fetch_rules_pdf downloads and extracts the text of the actual legal contract PDF so the agent can read it.
  • Exchange — get_exchange_status, get_exchange_schedule (is the market open, and its hours).
  • Portfolio — get_balance, get_positions, get_fills, get_settlements.
  • Trading — create_order, cancel_order, amend_order, decrease_order, plus list_orders / get_order.

Safety by default

  • The server targets Kalshi's demo (sandbox) environment unless you explicitly set KALSHI_ENV=prod.
  • Order-placing tools (create_order, amend_order) 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
KALSHI_ENV demo demo (sandbox) or prod (real money). Derives the base URL.
KALSHI_API_KEY (none) Kalshi API key ID. Required only for authenticated tools.
KALSHI_PRIVATE_KEY_PATH (none) Path to your RSA private key .pem. Required for authenticated tools.
BASE_URL (derived) Optional explicit REST base override (must include /trade-api/v2).

mcp-server-kalshi FAQ

Can I use this to browse and research Kalshi prediction markets?
Yes — you can list markets, view detailed market data, and read exact settlement rules including contract PDFs without needing an account.
Can I place real trades on Kalshi through this?
Yes — but placing orders requires setting up your API key and RSA private key, and you must confirm each trade to execute it.
Which apps support this MCP server?
It works with Claude Desktop and other MCP-compatible clients that can run servers via npx, uvx, or Docker.
Do I need an API key to use this?
No for browsing and research features, but yes for portfolio and trading functions.
How hard is it to set up?
It requires developer-level setup, including environment variables and possibly Docker or command-line tools.