Kalshi MCP Server (2026): Connect Claude to Kalshi Markets

Does Kalshi have an official MCP server?

Yes, for its documentation. Kalshi's docs site serves an MCP endpoint at https://docs.kalshi.com/mcp. It exposes two tools: search_api_documentation, which searches the docs and returns matching pages with links, and query_docs_filesystem, which reads a full page. That is useful while you build against the Kalshi API, because your assistant can look up endpoints, fields and examples instead of guessing them.

Adding it to Claude Code takes one command:

claude mcp add --transport http kalshi-docs https://docs.kalshi.com/mcp

What it does not do is serve markets. Ask it for the current price of a Kalshi contract and it can only point you to the documentation for the endpoint that would return it. For live data, you need a server that calls the API itself.

How do you connect Claude to live Kalshi markets?

With an MCP server that wraps a market data API. Predictefy's @predictefy/mcp covers Kalshi along with Polymarket, Gemini, Polymarket US, Limitless and the rest of its 15+ venues, all on one normalized schema, so the same tools work whichever venue you ask about. Create a free API key at portal.predictefy.com/keys, then add the server.

Claude Code:

claude mcp add predictefy -e PREDICTEFY_API_KEY=pk_live_your_key_here -- npx -y @predictefy/mcp

Claude Desktop, in claude_desktop_config.json:

{
  "mcpServers": {
    "predictefy": {
      "command": "npx",
      "args": ["-y", "@predictefy/mcp"],
      "env": {
        "PREDICTEFY_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Restart Claude, then check the connection by asking it to list the venues it can see. The list_venues tool answers without calling a venue, so a response confirms the server is running. Then ask for something live, such as "Show me the most active Kalshi markets on the Fed decision and their order books."

What can Claude do with Kalshi through MCP?

Cross-venue comparison is where a multi-venue server earns its place. Kalshi and Polymarket often price the same event differently, and Claude can pull both prices and both books in one conversation, then work out whether the gap survives fees. The arbitrage tool needs the Builder plan or above.

Can Claude trade on Kalshi through MCP?

Yes, if you turn it on. The server registers its ten execution and collateral tools only when you set MCP_ENABLE_TRADE=true, and your Predictefy key needs the trade scope, which you opt into per key. Without both, the server cannot place an order no matter what the conversation asks for.

Trading then runs in steps, and no tool both builds and submits. exec_quote previews the cost against the live book, exec_prepare builds the order, and exec_submit sends it, as a dry run unless you explicitly confirm. Kalshi orders use your own Kalshi API key ID and private key, which Predictefy's execution service uses for that one request and never stores, and your funds stay in your Kalshi account. Kalshi's keys are covered in how to get a Kalshi API key.

A sensible setup is two servers: a read-only one for research, and a separate one with trading enabled that you only start when you mean to trade.

What does it cost to run?

The MCP server is free to install, and its calls use credits from your Predictefy plan. The free plan includes 25,000 credits a month. Market metadata, search and price snapshots cost 1 credit, order book snapshots and historical queries cost 5, cross-venue comparisons cost 10, and an arbitrage query costs 15. Paper trading costs 0 credits on every plan.

What about other Kalshi MCP servers?

Several community servers on npm and GitHub wrap Kalshi's public API, from read-only data wrappers to ones that place orders. Evaluate them like any other dependency: when the last commit landed, whether there is a licence, how credentials are stored, and whether an unsupported request returns an honest error or an empty result. A Kalshi-only server also answers only Kalshi questions. The moment you want to compare a price with Polymarket or Gemini, you are running several servers and reconciling their output by hand.

For the Polymarket side, see how to connect Claude to live Polymarket markets, or start with the Predictefy API.

Frequently Asked Questions