Skip to main content

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_URL points the server at another deployment (default https://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)

Source distribution for kalshieye-mcp 0.1.1
File Size Uploaded Provenance
kalshieye_mcp-0.1.1.tar.gz 12.0 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for kalshieye-mcp 0.1.1
File Interpreter ABI Platform
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page