Back to Browse

Kalshieye MCP Server

Developer ToolsLow Risk8.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Search Kalshi, Polymarket and Limitless markets, order book history, coverage and data files.

About

Search Kalshi, Polymarket and Limitless markets, order book history, coverage and data files.

Security Report

8.0
Low Risk8.0Low Risk

Valid MCP server (1 strong, 2 medium validity signals). 4 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.

6 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your Kalshi Eye API key (clab_...), from https://kalshieye.com/app/api/. Every tool needs it.Required

Environment variable: KALSHIEYE_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-kalshieye-kalshieye-mcp": {
      "env": {
        "KALSHIEYE_API_KEY": "your-kalshieye-api-key-here"
      },
      "args": [
        "kalshieye-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

ToolWhat it does
searchFind series, events and markets by keyword, venue, category or status. Series lead and come a page at a time (series_total, has_more, offset); events and markets are the 10 best whose words hold the query, with events_found / markets_found (exact up to 10,000, then *_found_exact: false) and more_events / more_markets, the paged calls that list every match
get_seriesOne series: what it is, how often it runs, markets in the catalog, and days of data files
list_marketsA series' markets, or the markets on every venue holding each word of q (venue narrows it), newest first, with status and result. A page at a time: total (with q, exact up to 10,000, then total_exact: false), and next_cursor (with q) or next_offset, passed back until it is null
list_eventsEvery event on every venue whose title, series name or category holds each word of the query, newest first, a page at a time (next_cursor), with total and total_exact
get_marketOne market's terms, status, result, and how much of it was recorded
market_price_historyThe recorded YES bid/ask path, up to about 240 points over the market's busiest stretch; path_source is life, busiest or window
list_datasetsEvery dataset: what it holds, columns, plan, days available
dataset_seriesWhich series have files in a dataset, with days, rows and size, up to 500 a page with total and next_offset
recording_statusWhether recording is running, and the recorded share of recent days by venue
list_filesDaily Parquet files for a dataset, date range and series, page by page
download_linksSigned 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.

Reviews

No reviews yet

Be the first to review this server!