Skip to main content

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_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.0

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.0
File Size Uploaded Provenance
kalshieye_mcp-0.1.0.tar.gz 8.8 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for kalshieye-mcp 0.1.0
File Interpreter ABI Platform
kalshieye_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.2 kB

Release files / kalshieye_mcp-0.1.0.tar.gz

Download URL kalshieye_mcp-0.1.0.tar.gz
Size 8.8 kB
Tags Source
SHA-256 checksum
How to use checksums
16396604477edcb74d13f06fef7fa6e56516b2f3dbfe918c9c61c4c3b291f8d8
BLAKE2b-256 checksum
How to use checksums
ffc6d7713597a65bb17b9c4ab5c03e286fc101738d677c2ef11da8e6648e2c35
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.0-py3-none-any.whl

Download URL kalshieye_mcp-0.1.0-py3-none-any.whl
Size 8.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b578312550c973fde5e6e21a16e2e70edebe36c104ad50029e335ce23c7aaaca
BLAKE2b-256 checksum
How to use checksums
c405a94fccca72a73bc34a7b486a465a7f1c18fb4672e28461f21595aaf8ca1f
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.0

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

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