Kalshi Eye
Search Kalshi, Polymarket and Limitless markets, order book history, coverage and data files.
What can you do with Kalshi Eye?
- "Which bitcoin markets does Kalshi Eye record, and since when?"
- "How did the Bills vs Rams market on October 12 trade over the game?"
- "How much of the Fed decision series is in the order book files?"
- "Is the recorder running, and how complete was last week?"
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
kalshieye-mcpclaude mcp add kalshi-eye -e 'KALSHIEYE_API_KEY=<your kalshieye_api_key>' -- uvx kalshieye-mcp==0.2.1
{
"mcpServers": {
"kalshi-eye": {
"command": "uvx",
"args": [
"kalshieye-mcp==0.2.1"
],
"env": {
"KALSHIEYE_API_KEY": "<your kalshieye_api_key>"
}
}
}
}
Environment variables
KALSHIEYE_API_KEYrequired secret Your Kalshi Eye API key (clab_...), from https://kalshieye.com/app/api/. Every tool needs it.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Kalshi Eye MCP server
An MCP server that lets AI assistants such as Claude, ChatGPT and Cursor search the Kalshi Eye archive of prediction market data. It can find Kalshi, Polymarket and Limitless markets, show how a market's price moved, check what was recorded, and list the order book files you can download.
Searching, price history and coverage need no account. Add a Kalshi Eye API key to also list daily Parquet files and get download links.
Install
Claude Code:
claude mcp add kalshieye -- uvx kalshieye-mcp
Claude Desktop, Cursor and other clients (claude_desktop_config.json, .cursor/mcp.json, ...):
{
"mcpServers": {
"kalshieye": {
"command": "uvx",
"args": ["kalshieye-mcp"],
"env": { "KALSHIEYE_API_KEY": "optional: clab_..." }
}
}
}
uvx comes with uv. With pip instead: pip install kalshieye-mcp, then use kalshieye-mcp as the command.
Tools
| Tool | What it does | Key |
|---|---|---|
search | Find series, events and markets by keyword, venue, category or status | No |
get_series | One series: what it is, how often it runs, markets and days recorded | No |
list_markets | A series' markets from the last 1 to 7 days, with status and result | No |
get_market | One market's terms, status, result, and share of its life recorded | No |
market_price_history | The recorded YES bid and ask over a market's life | No |
list_datasets | Every dataset: what it holds, columns, plan, days available | No |
dataset_series | Which series have files in a dataset, with days, rows and size | No |
recording_status | Whether recording is running and the recorded share of recent days | No |
list_files | Daily Parquet files for a dataset, date range and series | Yes |
download_links | Signed download URLs for those files (counts toward the monthly allowance) | Yes |
Things to ask:
- "Which bitcoin markets does Kalshi Eye record, and since when?"
- "How did the Bills vs Rams market on October 12 trade over the game?"
- "How much of the Fed decision series is in the order book files?"
- "Is the recorder running, and how complete was last week?"
Notes
- Kalshi is recorded since October 12, 2026; Polymarket, Limitless and Chainlink prices since October 15, 2026. Each UTC day is published the next morning.
- Prices are dollars between 0 and 1. A Kalshi YES ask is 1 minus the best NO bid. Times are UTC.
- Free data without any key: a one-day sample on Hugging Face and runnable examples. The Python client for downloading files is
kalshieye. KALSHIEYE_BASE_URLpoints the server at another deployment (defaulthttps://kalshieye.com).
Kalshi Eye is independent and is not affiliated with Kalshi, Polymarket or Limitless. MIT licensed.
Frequently asked questions
What is Kalshi Eye?
Search Kalshi, Polymarket and Limitless markets, order book history, coverage and data files.
How do I install Kalshi Eye?
It runs on your machine. In Claude Code: claude mcp add kalshi-eye -e 'KALSHIEYE_API_KEY=<your kalshieye_api_key>' -- uvx kalshieye-mcp==0.2.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Kalshi Eye need an API key?
Yes. It expects KALSHIEYE_API_KEY, which you set in its configuration.
Is Kalshi Eye open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Kalshi Eye?
It is published by KalshiEye. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.