Kalshi

v1.0.0Finance & Fintechstable

A MCP server to interact with Kalshi prediction markets

kalshimcpai-integration
Share:
19
Stars
0
Downloads
0
Weekly
0/5

What is Kalshi?

Kalshi is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server to interact with kalshi prediction markets

A MCP server to interact with Kalshi prediction markets

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A MCP server to interact with Kalshi prediction markets

Use Cases

Access Kalshi prediction markets for analysis and trading. Query market data and place trades programmatically.
9crusher

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 1, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx kalshi

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Kalshi

The Kalshi MCP server provides Claude with programmatic access to Kalshi's prediction markets, allowing you to query market data, check event probabilities, and execute trades through natural language conversations. It connects to the Kalshi REST API using RSA key-based authentication and supports both the production environment and the demo sandbox for safe testing. Traders and analysts can use this server to monitor market positions, research event contracts, and automate trading workflows directly from Claude Desktop.

Prerequisites

  • Python 3.11 or higher and the uv package manager
  • A Kalshi account with API access enabled (trading-api.readme.io)
  • A Kalshi API key (KALSHI_API_KEY) obtained from your account settings
  • An RSA private key file generated for Kalshi API authentication
  • An MCP-compatible client such as Claude Desktop
1

Create a Kalshi account and generate API credentials

Register at kalshi.com and navigate to API settings to generate your API key and RSA private key pair. For testing, use the demo environment at demo-api.kalshi.co.

2

Install the server using uvx

The recommended installation method is uvx, which runs the server without requiring a manual clone or virtual environment setup.

uvx mcp-server-kalshi
3

Configure Claude Desktop

Add the Kalshi MCP server to your claude_desktop_config.json with your API key, private key path, and the appropriate base URL (production or demo).

{
  "mcpServers": {
    "kalshi": {
      "command": "uvx",
      "args": ["mcp-server-kalshi"],
      "env": {
        "KALSHI_API_KEY": "your-kalshi-api-key",
        "KALSHI_PRIVATE_KEY_PATH": "/path/to/your/private_key.pem",
        "BASE_URL": "https://api.elections.kalshi.com"
      }
    }
  }
}
4

Test with the demo environment first

Before using production credentials, set BASE_URL to the demo endpoint to safely explore market data and test trading workflows without real money.

BASE_URL=https://demo-api.kalshi.co uvx mcp-server-kalshi
5

Restart Claude Desktop and verify connection

Restart Claude Desktop fully and ask Claude to list available Kalshi markets to confirm the server is connected and authenticating correctly.

Kalshi Examples

Client configuration

Full claude_desktop_config.json entry for the Kalshi MCP server using uvx with RSA key authentication against the production API.

{
  "mcpServers": {
    "kalshi": {
      "command": "uvx",
      "args": ["mcp-server-kalshi"],
      "env": {
        "KALSHI_API_KEY": "your-kalshi-api-key",
        "KALSHI_PRIVATE_KEY_PATH": "/home/user/.kalshi/private_key.pem",
        "BASE_URL": "https://api.elections.kalshi.com"
      }
    }
  }
}

Prompts to try

Example prompts for researching and trading on Kalshi prediction markets through Claude.

- "What prediction markets are currently open on Kalshi?"
- "What is the current probability for the Fed rate cut market?"
- "Show me my current positions on Kalshi."
- "Search for markets related to inflation or CPI data."
- "What is the order book for the next US election market?"

Troubleshooting Kalshi

Authentication fails with invalid signature or unauthorized error

Verify that KALSHI_PRIVATE_KEY_PATH points to the correct RSA private key file in PEM format, and that KALSHI_API_KEY matches the key ID associated with that RSA key in your Kalshi account settings.

Cannot find uvx command

Install uv (which includes uvx) by running `curl -LsSf https://astral.sh/uv/install.sh | sh` on macOS/Linux, or see the uv documentation for Windows. Then restart your terminal.

Server connects but returns no market data

Confirm you are using the correct BASE_URL for your environment. Production is https://api.elections.kalshi.com and demo is https://demo-api.kalshi.co. Also verify your account has API trading access enabled in Kalshi settings.

Frequently Asked Questions about Kalshi

What is Kalshi?

Kalshi is a Model Context Protocol (MCP) server that mcp server to interact with kalshi prediction markets It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Kalshi?

Follow the installation instructions on the Kalshi GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Kalshi?

Kalshi works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Kalshi free to use?

Yes, Kalshi is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "kalshi": { "command": "npx", "args": ["-y", "kalshi"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Kalshi?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides