home / mcp / kalshi mcp server

Kalshi MCP Server

Exposes Kalshi REST API data and actions through an MCP server for automated workflows.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "9crusher-mcp-server-kalshi": {
      "command": "uvx",
      "args": [
        "mcp-server-kalshi"
      ],
      "env": {
        "BASE_URL": "https://api.elections.kalshi.com",
        "KALSHI_API_KEY": "<YOUR KALSHI API KEY>",
        "KALSHI_PRIVATE_KEY_PATH": "PATH TO YOUR RSA KEY FILE"
      }
    }
  }
}

You run an MCP server that exposes the Kalshi REST API through the MCP framework, allowing you to automate actions and data access against Kalshi within your MCP ecosystem. This guide walks you through how to use the server, install it locally, and configure it for both local and containerized runtimes.

How to use

You can run the Kalshi MCP server using a standard MCP client workflow. Choose one of the available runtime options to start the server and provide your credentials and API base URL. Once running, you can connect your MCP client to the server using its local process or a bound container that hosts the server, then perform API-backed operations through the MCP interface.

How to install

{
  "mcpServers": {
    "kalshi_uvx": {
      "command": "uvx",
      "args": ["mcp-server-kalshi"],
      "env": {
        "KALSHI_PRIVATE_KEY_PATH": "PATH TO YOUR RSA KEY FILE",
        "KALSHI_API_KEY": "<YOUR KALSHI API KEY>",
        "BASE_URL": "https://api.elections.kalshi.com"
      }
    },
    "kalshi_docker": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--mount", "type=bind,src=/Users/username,dst=/Users/username", "-e", "KALSHI_PRIVATE_KEY_PATH", "-e", "KALSHI_API_KEY", "-e", "BASE_URL", "mcp-server-kalshi"],
      "env": {
        "KALSHI_PRIVATE_KEY_PATH": "PATH TO YOUR RSA KEY FILE",
        "KALSHI_API_KEY": "<YOUR KALSHI API KEY>",
        "BASE_URL": "https://api.elections.kalshi.com"
      }
    }
  }
}

Additional sections

Prerequisites: you should have a runtime environment that supports MCP servers using UVX. You will also need access to Kalshi API credentials and a base URL for the Kalshi REST API.

Available tools

uvx_run

Run an MCP server with UVX, providing the necessary arguments and environment for the Kalshi MCP server.

docker_run

Run the Kalshi MCP server inside a Docker container with the required environment and bindings.

inspector_uv

Use the MCP inspector to run the Kalshi MCP server in inspection mode and verify behavior.