MCP.so
Sign In

MCP Server Kalshi

@9crusher

About MCP Server Kalshi

A MCP server to interact with Kalshi prediction markets

Basic information

Category

Other

License

MIT

Runtime

python

Transports

stdio

Publisher

9crusher

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-kalshi": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "uv",
        "--directory",
        "/path/to/mcp-server-kalshi",
        "run",
        "start"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server Kalshi?

It is an MCP (Model Context Protocol) server that gives Claude Code and other agent harnesses a first-class interface to Kalshi, the regulated prediction-market exchange. It supports end-to-end trading: browsing markets, researching them, reading settlement rules, pulling contract-terms PDFs, and executing trades through MCP tools.

How to use MCP Server Kalshi?

Configure via environment variables (KALSHI_ENV, KALSHI_API_KEY, KALSHI_PRIVATE_KEY_PATH). Run with uvx mcp-server-kalshi or via Docker. The server targets the Kalshi demo sandbox by default; set KALSHI_ENV=prod for real money. Order-placing tools require confirm=true to execute; without it they only return a preview.

Key features of MCP Server Kalshi

  • Discover markets, events, and series with filtering (no free‑text search).
  • Research markets via orderbook, candlesticks, and trade history.
  • Read full settlement rules and download contract‑terms PDFs.
  • Manage portfolio: balance, positions, fills, settlements.
  • Place, cancel, amend, and decrease orders with a natural buy/sell model.
  • Safety defaults: demo environment, preview‑only orders, optional credentials for read tools.

Use cases of MCP Server Kalshi

  • Let an agent research prediction market rules and settlement conditions before deciding to trade.
  • Automate portfolio monitoring and order adjustments based on market updates.
  • Build a trading assistant that can explain market orderbooks and candlestick data.
  • Enable a voice or chat interface to browse Kalshi markets and execute trades.

FAQ from MCP Server Kalshi

What environments does MCP Server Kalshi support?

It supports demo (sandbox) and prod (real money). The default is demo.

Are API credentials required?

No. All market and rules tools work without authentication. Portfolio and order tools require a Kalshi API key and RSA private key.

How does the safety-by‑default feature work?

Order‑placing tools (create_order, amend_order) require confirm=true to actually place an order. Without it they return a human‑readable preview and the exact payload without executing anything.

What is the order model used by MCP Server Kalshi?

It exposes a natural model: action (buy/sell) + side (yes/no) + limit price in whole cents. The server automatically translates the underlying Kalshi API (which quotes everything from the YES leg) including the buy‑NO ⇄ sell‑YES price inversion.

What are the runtime dependencies?

Python 3.12 or later. Install dependencies with uv sync. For local development, include --extra dev.

Comments

More Other MCP servers