prediction-market-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
prediction-market-mcp
An MCP server that gives an AI agent the tools to reason about binary prediction markets: exact Kalshi fee math, live public market data, and two-sided position accounting.
Read-only by construction. The server issues only GET requests against Kalshi's public endpoints and takes no credentials. An agent connected to it can look, price and reason. It cannot place, change or cancel an order.
Tools
Tool | Network | What it answers |
| none | What does this order cost in fees, in dollars and per contract? |
| live | What fee type and multiplier does this series actually charge? |
| live | What is open in this series, and where is top of book? |
| live | What is resting on each side, and what ask does that imply? |
| none | Given these fills, what is my P&L under each outcome, am I locked, and what is the most the second leg may pay? |
| none | Does YES here plus NO there clear both fee schedules? |
All prices are dollars per contract between 0 and 1. Passing 52 for 52 cents is
rejected by input validation rather than silently producing a wrong fee.
Related MCP server: Kalshi Multi-Agent Research MCP Server
In use
Claude Code answering a fee question with the server connected (four tool calls: series fees, markets, orderbook, fee):

Why these tools
Fees decide most prediction-market questions, and a language model will happily
guess them. Kalshi's taker fee is ceil_cents(0.07 * multiplier * C * P * (1 - P)):
quadratic in price, rounded up per order, with a per-series multiplier. Three
things follow that an agent gets wrong without a tool:
As a share of payout the fee is roughly 8x cheaper at 3 cents than at 50 cents.
The round-up is a fixed cost, so a 1-lot at 50 cents pays 2% of payout while a 100-lot pays 1.75%.
The multiplier is per series. Assuming 1.0 is wrong for a meaningful share of the exchange.
Design choices
Truncation is reported, never hidden.
kalshi_marketsreturnstruncated: truewhen the server had more pages, so a short list is not mistaken for the whole series.Empty is distinguishable from missing. An empty orderbook returns
empty: truewithnullbest prices, not zeros.Tickers are validated before they reach a URL.
Known unknowns are in the output. The maker-fee coefficient has not been reconciled against a real fill, and
price_two_legcannot check that two venues resolve on identical criteria. Both tools say so in their result.
Install and run
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python -e ".[dev]"
.venv/bin/prediction-market-mcp # serves over stdioClaude Code:
claude mcp add prediction-market -- /absolute/path/to/.venv/bin/prediction-market-mcpClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"prediction-market": {
"command": "/absolute/path/to/.venv/bin/prediction-market-mcp"
}
}
}Tests
.venv/bin/pytest # offline: fee conversions, position math, protocol round-trip
.venv/bin/pytest -m live # also hits Kalshi's public APIThe offline suite starts the real server as a subprocess and talks to it over stdio with an MCP client, so the tool schemas and results are tested as an agent would see them.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.
Read-only prediction-market data across Kalshi, Polymarket, Limitless: venues, fees, lookups, stats.
Polymarket in your AI: market rules, real fill costs, who is trading, top traders. Read-only.
Hosted MCP for Kalshi prediction markets: search, odds, order books, settlement rules, and trading.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to Kalshi prediction market data with 23 tools for querying events, markets, trades, forecasts, candlesticks, and live data from the CFTC-regulated exchange for trading on real-world events.7-
- FlicenseNot gradedqualityDmaintenanceExposes Kalshi prediction market data as tools for Claude, enabling multi-agent research pipelines that analyze markets and produce confidence-rated trade signals.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to read Kalshi prediction market data, manage portfolios, and place or cancel trades only with explicit user approval.MIT
- FlicenseNot gradedqualityCmaintenanceLets AI agents query real Kalshi market data by searching markets, retrieving market details, and reading order books, using only public GET requests with no Kalshi account or API keys.-