Kalshi Eye MCP Server
Kalshi Eye MCP server lets AI assistants search and inspect prediction-market archive data and retrieve dataset/file download metadata.
Search Kalshi, Polymarket, Limitless, and Chainlink series, events, and markets by keyword, venue, category, or status.
Get series details, including cadence, markets, and available data days.
List markets in a series with status and results, and get individual market terms, status, result, and recording coverage.
View a market's recorded YES bid/ask price history.
List datasets, series available within datasets, recording status, and daily Parquet files by date range/series.
Generate signed download URLs for files from
list_files; downloads count toward the plan's monthly allowance.
Provides access to Chainlink price data recorded in the Kalshi Eye archive, queryable alongside prediction-market data from Kalshi, Polymarket, and Limitless.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kalshi Eye MCP Server How did the Bills vs Rams market trade on October 12?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpClaude 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.
Related MCP server: Polymarket MCP Server
Tools
Tool | What it does |
| Find series, events and markets by keyword, venue, category or status. Series lead and come a page at a time ( |
| One series: what it is, how often it runs, markets in the catalog, and days of data files |
| A series' markets, or the markets on every venue holding each word of |
| Every event on every venue whose title, series name or category holds each word of the query, newest first, a page at a time ( |
| One market's terms, status, result, and how much of it was recorded |
| The recorded YES bid/ask path, up to about 240 points over the market's busiest stretch; |
| Every dataset: what it holds, columns, plan, days available |
| Which series have files in a dataset, with days, rows and size, up to 500 a page with |
| Whether recording is running, and the recorded share of recent days by venue |
| Daily Parquet files for a dataset, date range and series, page by page |
| 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_URLpoints the server at another deployment (defaulthttps://kalshieye.com).
Kalshi Eye is independent and is not affiliated with Kalshi, Polymarket or Limitless. MIT licensed.
Available Tools
10 toolsdataset_seriesCRead-only
Which series have files in one dataset (for example book_l2 or trades), with days, rows and size.
Inputs: dataset_id (required), limit, query. Returns: object
download_linksAIdempotent
Signed download URLs for file keys from list_files. Needs KALSHIEYE_API_KEY.
The first download of a file in a month counts toward the plan's monthly allowance.
Inputs: keys (required). Returns: object
get_marketARead-only
One market by ticker (Kalshi ticker, or a Polymarket token id): terms, status, result, and how much of its life was recorded.
Inputs: ticker (required). Returns: object
get_seriesARead-only
One series (for example KXBTC15M or KXFEDDECISION): what it is, how often it runs, and how many markets and days the archive has.
Inputs: series_id (required). Returns: object
list_datasetsARead-only
Every dataset in the archive (order books, top of book, minute bars, trades, settlements, Polymarket, Chainlink...): what it holds, the plan it needs, days available, and its columns.
Inputs: no named parameters. Returns: object
list_filesBRead-only
Daily Parquet files for a dataset and date range (YYYY-MM-DD, UTC), optionally one series. Needs KALSHIEYE_API_KEY.
Inputs: dataset (required), end_date (required), start_date (required), limit, +1 more. Returns: object
list_marketsARead-only
Markets in one series that closed or close within the last days days (1 to 7), with status, result and times.
status is a Kalshi market status, such as active or finalized.
Inputs: series (required), days, limit, status. Returns: object
market_price_historyARead-only
The recorded YES best bid and ask over a market's life, about 40 points, plus how much was recorded.
Good for "what did the market think over time". For every order book change, use the daily Parquet files (list_datasets, list_files).
Inputs: ticker (required). Returns: object
recording_statusARead-only
Whether the recorder is running now, the last published day, and the recorded share of recent days by venue.
Inputs: no named parameters. Returns: object
searchARead-only
Search Kalshi, Polymarket and Limitless series, events and markets by keyword.
Examples: "bitcoin 15 minute", "fed rate", "NFL", "New York temperature". category is an archive category such as Crypto, Economics, Sports or Politics. status "live" keeps markets still trading.
Inputs: query (required), limit, venue, status, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a distinguishable target: search (keyword discovery), get_series/list_markets/get_market (drill-down by series ticker or market ticker), and a separate archive tier (list_datasets, dataset_series, list_files, download_links). The only mild overlaps are get_series vs dataset_series and search vs list_markets, but descriptions disambiguate them clearly.
Most tools follow verb_noun (download_links, get_series, list_markets, get_market, list_datasets, list_files), but there are notable deviations: the bare verb 'search' and noun-only names like market_price_history, dataset_series, and recording_status. Still readable, but the pattern isn't uniform.
Ten tools is well-scoped for a market data archive: discovery, metadata, file listing, and download each earn their place with no redundant surface.
The full pipeline is covered: search/discover markets and series, inspect datasets, list daily Parquet files, and obtain signed download URLs, plus a recorder health check. Minor gaps exist—events are only reachable via search, and there is no direct query tool beyond price history and raw file download.
Maintenance
Related MCP Connectors
Read-only prediction-market data across Kalshi, Polymarket, Limitless: venues, fees, lookups, stats.
Read-only Polymarket search, market details, order books, price history, and market cards.
Order-book depth & history for Polymarket, Kalshi & Limitless. Keyless demo, key for full access.
Polymarket in your AI: market rules, real fill costs, who is trading, top traders. Read-only.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables access to Polymarket's prediction markets for analyzing market probabilities, trading activity, and event outcomes across politics, sports, crypto, and other categories through natural language queries.10ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query Polymarket prediction markets, accessing real-time odds, market data, price history, order books, and trending markets across categories like politics, crypto, and sports through natural language.7MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Polymarket prediction markets, including retrieving market data, user positions, and trading history.823 npm13Apache 2.0
- AlicenseAqualityDmaintenanceProvides search, trending, odds, arbitrage, and category browsing for prediction markets (Polymarket & Kalshi) via the Model Context Protocol, enabling AI agents to access live market data without API keys.51MIT