MCP Server Kalshi

MCP Server Kalshi

Claude Code やその他のエージェントハーネスに Kalshi への一級のインターフェースを提供する MCP サーバーです。エンドツーエンドの取引のために構築されています。マーケットを閲覧し、調査し、正確な決済ルールを読み（コントラクト条項の PDF の取得を含む）、取引を実行する——これらすべてを MCP ツールを通じて行えます。

ハイライト

• 探索 — list_markets、get_market、list_events、get_event、list_series、 get_series。（Kalshi にはフリーテキスト検索がないため、list_markets のフィルターが検索の役割を果たします。）
• 調査 — get_market_orderbook、get_market_candlesticks、get_market_trades。
• 詳細なルール — get_market_rules はマーケットの rules_primary/rules_secondary、 早期クローズ条件、決済ソース、シリーズの禁止事項を統合します。fetch_rules_pdf は実際の法的契約 PDF をダウンロードしてテキストを抽出するため、エージェントがそれを読むことができます。
• 取引所 — get_exchange_status、get_exchange_schedule（マーケットが開いているか、およびその取引時間）。
• ポートフォリオ — get_balance、get_positions、get_fills、get_settlements。
• 取引 — create_order、cancel_order、amend_order、decrease_order、 さらに list_orders / get_order。

デフォルトで安全

• 明示的に KALSHI_ENV=prod を設定しない限り、このサーバーは Kalshi の デモ（サンドボックス） 環境を対象とします。
• 注文を出すツール（create_order、amend_order）には confirm=true が必要です。これがない場合、 これらのツールは プレビュー ——人間が読める要約と正確なペイロード——を返し、何も発注しません。
• 認証情報は 任意 です。すべてのマーケット／ルールツールは未認証で動作します。ポートフォリオ と注文のツールにのみ API キー + RSA 秘密鍵が必要です。

直感的な注文モデル

Kalshi の V2 注文 API はすべてを YES レッグから見てクォートします（bid/ask は固定小数点ドル）。 このサーバーは代わりに自然なモデル——action（buy/sell）+ side（yes/no）+ 整数の セント 価格——を公開し、それを変換します（buy-NO ⇄ sell-YES の価格反転を含む）。

設定

変数	デフォルト	目的
KALSHI_ENV	demo	demo（サンドボックス）または prod（実際の資金）。ベース URL を導出します。
KALSHI_API_KEY	(なし)	Kalshi API キー ID。認証が必要なツールにのみ必要です。
KALSHI_PRIVATE_KEY_PATH	(なし)	RSA 秘密鍵 .pem へのパス。認証が必要なツールに必要です。
BASE_URL	(導出)	オプションの明示的な REST ベースの上書き（/trade-api/v2 を含める必要があります）。

.env-example を参照してください。API 認証情報は docs.kalshi.com/getting_started/api_keys で取得でき、デモアカウントは デモ環境ガイドから取得できます。

Claude Desktop (uvx)

"mcpServers": {
  "kalshi": {
    "command": "uvx",
    "args": ["mcp-server-kalshi"],
    "env": {
      "KALSHI_ENV": "demo",
      "KALSHI_API_KEY": "<YOUR KALSHI API KEY>",
      "KALSHI_PRIVATE_KEY_PATH": "PATH TO YOUR RSA KEY FILE"
    }
  }
}

Claude Desktop (Docker)

"mcpServers": {
  "kalshi": {
    "command": "docker",
    "args": ["run", "--rm", "-i",
      "--mount", "type=bind,src=/Users/username,dst=/Users/username",
      "-e", "KALSHI_ENV", "-e", "KALSHI_API_KEY", "-e", "KALSHI_PRIVATE_KEY_PATH",
      "mcp-server-kalshi"],
    "env": {
      "KALSHI_ENV": "demo",
      "KALSHI_API_KEY": "<YOUR KALSHI API KEY>",
      "KALSHI_PRIVATE_KEY_PATH": "PATH TO YOUR RSA KEY FILE"
    }
  }
}

ローカル開発

1. .env ファイルを作成します（.env-example を参照）。
2. 依存関係をインストールします: uv sync（開発ツールには --extra dev を追加）。Python 3.10+ が必要です。
3. 実行します: uv run start。
4. テストします: uv run pytest。

MCP Inspector

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-kalshi run start

テストとコード品質

uv sync --extra dev              # install dev tools (ruff, mypy, pytest, ...)
uv run pytest                    # run the test suite
uv run pytest --cov              # tests with a coverage report
uv run ruff check src tests      # lint
uv run black src tests           # format (add --check to verify only)
uv run mypy                      # type check
uv run pre-commit install        # (once) run ruff + black on every commit

テストは純粋／オフラインです。注文の変換と confirm ゲート、HTTP クライアント （注入された httpx.MockTransport 経由）、MCP ツールレジストリ、設定、PDF 抽出を、実際の Kalshi API に触れることなく 検証します。CI（.github/workflows/ci.yml）は、すべての push/PR で Python 3.10～3.13 にわたって ruff + black + mypy + pytest を実行し、リリースは同じスイートでゲートされます。

認証

リクエストは RSA-PSS（MGF1-SHA256、最大ソルト）で署名されます。認証された各リクエストは KALSHI-ACCESS-KEY、KALSHI-ACCESS-TIMESTAMP、KALSHI-ACCESS-SIGNATURE を送信し、署名対象の メッセージは timestamp_ms + METHOD + path です（path には /trade-api/v2 が含まれ、クエリ 文字列は除外されます）。