Kalshi
A MCP server to interact with Kalshi prediction markets
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
Maintainer
Works with
Installation
Manual Installation
npx kalshiConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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.
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-kalshiConfigure 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"
}
}
}
}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-kalshiRestart 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.
Kalshi Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Kalshi? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
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.
Set Up Kalshi in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.