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.

It needs a Kalshi Eye API key: create one at API keys (a free account works) and set it as KALSHIEYE_API_KEY.

Install

Claude Code:

claude mcp add kalshieye -e KALSHIEYE_API_KEY=clab_your_key -- 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": "clab_your_key" }
    }
  }
}

Without a key, or with a placeholder, every tool answers with how to get one. Listing files and download links cover the datasets your plan includes.

uvx comes with uv. With pip instead: pip install kalshieye-mcp, then use kalshieye-mcp as the command.

Tools

Tool What it does
search Find series, events and markets by keyword, venue, category or status
get_series One series: what it is, how often it runs, markets in the catalog, and days of data files
list_markets A series' most recent markets, newest first, with status and result
get_market One market's terms, status, result, and how much of it was recorded
market_price_history A short recorded YES bid/ask path (up to about 40 points)
list_datasets Every dataset: what it holds, columns, plan, days available
dataset_series Which series have files in a dataset, with days, rows and size
recording_status Whether recording is running, and the recorded share of recent days by venue
list_files Daily Parquet files for a dataset, date range and series, page by page
download_links Signed download URLs for up to 100 of those files (counts toward the monthly allowance)

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.2.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.2.0
File Size Uploaded Provenance
kalshieye_mcp-0.2.0.tar.gz 11.6 kB With provenance Details

Built distribution (wheel)

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

Total release size: 21.2 kB

Release files / kalshieye_mcp-0.2.0.tar.gz

Download URL kalshieye_mcp-0.2.0.tar.gz
Size 11.6 kB
Tags Source
SHA-256 checksum
How to use checksums
82987dd7abf9a3e9af89a455126b4d3d7f3b315aca12182bec38837593a39a6e
BLAKE2b-256 checksum
How to use checksums
fddf38b203e9ab0e65c61ea8d7b336580e38c438da621862ec8e76b4a8d12546
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.2.0-py3-none-any.whl

Download URL kalshieye_mcp-0.2.0-py3-none-any.whl
Size 9.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b14a0092f3fd7d1b72945989ddf365b5469fd34a3742981693034f50157df14c
BLAKE2b-256 checksum
How to use checksums
7c99df7776be3103a562dfc474352ce3b17d17c6bcaf08b6d3199e9344e7b9ca
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.2.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.2.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