Kalshi

io.github.yakub268Published by GitHub account yakub268v0.1.1Updated Oct 24, 2026

Search, analyze, and trade Kalshi prediction markets through Claude Desktop

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that lets an assistant search, analyze and trade Kalshi prediction markets, including placing limit orders from Claude Desktop.

What you can do
Search markets by keyword and list trending markets or all markets in a series, with prices and volume details, plus full market info and orderbook depth for a ticker. Read account balance and open positions, also exposed as balance and positions resources. Place limit orders on Kalshi markets.
When to use it
Useful when you want to research Kalshi prediction markets and check your portfolio from a chat assistant, or place limit orders without leaving the conversation. It suits users who already have a Kalshi account and API credentials.
Requirements
Runs locally as a Python package (Python 3.10+) configured in Claude Desktop. Needs a Kalshi API key ID in KALSHI_API_KEY and the path to an RSA private key .pem file in KALSHI_PRIVATE_KEY_PATH. Requires network access to Kalshi.
Before you install
The server can place real limit orders that spend money on your Kalshi account. It needs your API key ID and RSA private key file path; the README says signing happens locally, but keep the key file protected. Review any order before confirming it.

Installation

In SourceWeft

  1. Open Kalshi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Kalshi MCP Server

mcp-name: io.github.yakub268/kalshi

[MCP] [Python]

Model Context Protocol server for Kalshi prediction markets. Search, analyze, and trade prediction markets directly through Claude Desktop.

Built with production-grade authentication and rate limiting from a live trading system with 4+ months of uptime.

Features

Tools (6)

  • search_markets - Search by keyword, get prices/volume
  • get_market_details - Full market info + orderbook depth
  • get_portfolio - Account balance + open positions
  • get_trending_markets - Top markets by 24h volume
  • place_order - Execute limit orders
  • get_series_markets - All markets in a series (e.g., Fed events)

Resources (2)

  • kalshi://balance - Current account balance
  • kalshi://positions - Open positions list

Installation

Prerequisites

  1. Kalshi API credentials: Get from kalshi.com/profile/api-keys

    • Download your API key ID
    • Download the RSA private key (.pem file)

  2. Python 3.10+

Quick Install (PyPI)

bash
pip install kalshi-mcp

From Source

bash
# Clone repositorygit clone https://github.com/yakub268/kalshi-mcp.gitcd kalshi-mcp
# Install dependenciespip install -e .

Claude Desktop Configuration

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{  "mcpServers": {    "kalshi": {      "command": "python",      "args": ["-m", "kalshi_mcp"],      "env": {        "KALSHI_API_KEY": "your-api-key-here",        "KALSHI_PRIVATE_KEY_PATH": "C:\\Users\\YourName\\.trading_keys\\kalshi_private_key.pem"      }    }  }}

Note:

  • Replace your-api-key-here with your actual Kalshi API key
  • Update the private key path to where you saved your .pem file
  • On Windows, use double backslashes (\\) in paths

Test the Connection

Restart Claude Desktop, then try:

What's my Kalshi balance?

or

Search for bitcoin prediction markets

Usage Examples

Search for Markets

Search for markets about the Federal Reserve

Get Market Analysis

Show me details for ticker KXFED-26MAR19-B5.25

Check Portfolio

What's my current Kalshi portfolio?

Place an Order

Buy 10 contracts of KXHIGHNYC-26FEB20-B34.5 YES at 25 cents

Authentication

This server uses RSA-PSS signature authentication:

  1. Each request is signed with your private key
  2. Kalshi verifies the signature with your public key
  3. Thread-safe rate limiting (150ms between requests)
  4. Automatic retry on 429 rate limit errors

Security: Your private key never leaves your machine. The server only signs requests locally.

Rate Limiting

  • Built-in 150ms spacing between requests (~6.6 req/s)
  • Automatic exponential backoff on 429 errors (0.5s → 1s → 2s)
  • Safe for concurrent use across multiple Claude conversations

Architecture

Built on production code from a live Kalshi trading bot:

  • Authentication: Reused from kalshi_client.py (4+ months uptime)
  • Rate limiting: Shared across all client instances
  • Error handling: Battle-tested retry logic
  • Market discovery: Liquidity scoring from scanner.py

Contributing

Issues and PRs welcome! This is an open-source project built to fill a gap in the MCP ecosystem.

License

MIT License - see LICENSE file

Acknowledgments

Questions? Open an issue or reach out on GitHub.

Source: README.md at commit 70fe3a7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts