Kalshi Eye MCP server
An MCP server that lets AI assistants such as Claude 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"]
}
}
}
To list and download files too, add your key from API keys to that entry:
"env": { "KALSHIEYE_API_KEY": "clab_your_key" }
A missing or placeholder key is ignored, and a rejected key only affects the two file tools.
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 in the catalog, and days of data files | No |
list_markets |
A series' most recent markets, newest first, with status and result | No |
get_market |
One market's terms, status, result, and how much of it was recorded | No |
market_price_history |
A short recorded YES bid/ask path (up to about 40 points) | 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 by venue | No |
list_files |
Daily Parquet files for a dataset, date range and series, page by page | Yes |
download_links |
Signed download URLs for up to 100 of those files (counts toward the monthly allowance) | Yes |
Things to ask:
- "Which bitcoin markets does Kalshi Eye record, and since when?"
- "What were the last few hours of the Bills vs Rams market on October 12 like?"
- "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.
Metadata
Release files for kalshieye-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| kalshieye_mcp-0.1.1.tar.gz | 12.0 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kalshieye_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 21.7 kB
Release files / kalshieye_mcp-0.1.1.tar.gz
| Download URL | kalshieye_mcp-0.1.1.tar.gz |
|---|---|
| Size | 12.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d6a61bd406f788808c99c32e9dcb7f4bf217a54113847b4e12bec251a6e7322a
|
|
BLAKE2b-256 checksum How to use checksums |
bee7b512281d775bda3fb2bc7389b793cf069ebf998438f13d30e2413bdce30f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / kalshieye_mcp-0.1.1-py3-none-any.whl
| Download URL | kalshieye_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 9.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0dadb50b073d22da6f212fde563d06221c2a0952de7711f2ff23fda64c748977
|
|
BLAKE2b-256 checksum How to use checksums |
2836022533fc59cb10f0737c729a6336e7bace52d938690bd6fe34d5119680ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logSecurity for kalshieye-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for kalshieye_mcp-0.1.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.