kalshi

Kalshi MCP サーバー

mcp-name: io.github.yakub268/kalshi

Kalshi の予測市場向け Model Context Protocol サーバーです。 Claude Desktop から予測市場を直接検索、分析、取引できます。

4 か月以上稼働しているライブ取引システムの、本番環境レベルの認証とレート制限を採用しています。

機能

ツール（6）

• search_markets - キーワードで検索し、価格と取引量を取得します
• get_market_details - 市場の詳細情報と注文板の厚さを取得します
• get_portfolio - 口座残高と保有中のポジションを取得します
• get_trending_markets - 24 時間の取引量上位の市場を取得します
• place_order - 指値注文を実行します
• get_series_markets - シリーズ内のすべての市場を取得します（例：Fed のイベント）

リソース（2）

• kalshi://balance - 現在の口座残高
• kalshi://positions - 保有中のポジション一覧

インストール

前提条件

1. Kalshi API 認証情報：kalshi.com/profile/api-keys から取得します

   • API キー ID をダウンロードします
   • RSA 秘密鍵（.pem ファイル）をダウンロードします

2. Python 3.10 以降

クイックインストール（PyPI）

pip install kalshi-mcp

ソースからインストール

# Clone repository
git clone https://github.com/yakub268/kalshi-mcp.git
cd kalshi-mcp

# Install dependencies
pip install -e .

Claude Desktop の設定

Claude Desktop の設定ファイルに追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kalshi": {
      "command": "python",
      "args": ["-m", "kalshi_mcp"],
      "env": {
        "KALSHI_API_KEY": "your-api-key-here",
        "KALSHI_PRIVATE_KEY_PATH": "C:\\Users\\YourName\\.trading_keys\\kalshi_private_key.pem"
      }
    }
  }
}

注：

• your-api-key-here を実際の Kalshi API キーに置き換えてください
• 秘密鍵のパスを、.pem ファイルを保存した場所に更新してください
• Windows では、パスに二重のバックスラッシュ（\\）を使用してください

接続をテストする

Claude Desktop を再起動してから、次を試してください。

What's my Kalshi balance?

または

Search for bitcoin prediction markets

使用例

市場を検索する

Search for markets about the Federal Reserve

市場を分析する

Show me details for ticker KXFED-26MAR19-B5.25

ポートフォリオを確認する

What's my current Kalshi portfolio?

注文を出す

Buy 10 contracts of KXHIGHNYC-26FEB20-B34.5 YES at 25 cents

認証

このサーバーはRSA-PSS 署名認証を使用します。

1. 各リクエストに秘密鍵で署名します
2. Kalshi が公開鍵を使って署名を検証します
3. スレッドセーフなレート制限（リクエスト間隔は 150ms）
4. 429 レート制限エラー発生時に自動で再試行します

セキュリティ：秘密鍵がマシンの外に出ることはありません。サーバーはリクエストにローカルで署名するだけです。

レート制限

• リクエスト間に 150ms の間隔を設けます（約 6.6 リクエスト/秒）
• 429 エラー発生時に指数バックオフで自動再試行します（0.5 秒 → 1 秒 → 2 秒）
• 複数の Claude の会話から同時に安全に使用できます

アーキテクチャ

ライブの Kalshi 取引ボットで使われている本番コードを基に構築されています。

• 認証：kalshi_client.py から再利用しています（4 か月以上の稼働実績）
• レート制限：すべてのクライアントインスタンス間で共有されます
• エラー処理：実運用で検証済みの再試行ロジック
• 市場の検出：scanner.py の流動性スコアリング

コントリビューション

イシューや PR を歓迎します！MCP エコシステムの不足を補うために構築されたオープンソースプロジェクトです。

ライセンス

MIT ライセンス - LICENSE ファイルを参照してください

謝辞

• FastMCP を使って構築
• Kalshi API のドキュメント：docs.kalshi.com
• 私の取引ボット群の本番コードを使用

---

ご質問がありますか？ イシューを作成するか、GitHub でご連絡ください。