Kalshi Kernel

Kalshiのイベント契約および永久市場向けの、非公式かつ安全性を重視したModel Context Protocol（MCP）サーバーです。このサーバーはHermesなどのエージェントハーネス向けに設計されており、Kalshiが公開しているAPI契約から生成された、意図的に小さなツールサーフェスを公開します。

公式パブリッシャー: CopyleftDev。ソースおよびコンテナのリリースは、それぞれgithub.com/copyleftdev/kalshi-kernelとghcr.io/copyleftdev/kalshi-kernelを使用する予定です。

[!CAUTION] プレリリース版ソフトウェア—取引には使用できません。 バージョン0.1.1は適合性テスト済みのスキャフォールドです。kernel_statusのみが動作します。マーケットデータ、ポートフォリオ、ペーパートレーディング、ライブトレーディングの各アダプターは接続されておらず、capability_not_readyでフェイルクローズします。

[!IMPORTANT] このコミュニティプロジェクトはKalshiの公式製品ではなく、KalshiEX LLCまたはその関連会社とは提携、承認、後援、支援の関係にありません。「Kalshi」という名称は、Kalshiが公開するAPIとの相互運用性を識別するためにのみ使用されています。

このプロジェクトが存在する理由

取引APIは広範で、アプリケーション開発者向けに最適化されています。エージェントには、明確な意図、厳格なスキーマ、予測可能なエラー、そしてシミュレーションと実資金での実行の強力な分離を備えた、より狭い境界が必要です。Kalshi Kernelは、生成されたクライアントを最新のアップストリーム契約に対して継続的にテストしながら、その境界を提供します。

設計上の優先事項は次のとおりです:

• デフォルトでペーパーモード;

• プロセスの存続期間中、実行モードは不変;

• ライブモードをアームする前に、明示的な確認と認証情報が必要;

• 価格と数量には固定小数点文字列を使用;

• 安全性アノテーション付きの厳格な生成ツールスキーマ;

• 機能が利用できない場合のフェイルクローズ動作;

• 正確なOpenAPIオペレーションおよびAsyncAPIチャネルとのトレーサブルな整合性;

• 再現可能なMCPプロトコル、レース、ファズ、アップストリームドリフトテスト。

Related MCP server: MCP Server Kalshi

現在のステータス

このバージョンを機能する取引統合として宣伝、デプロイ、または依存しないでください。ARCHITECTURE.md、THREAT_MODEL.md、およびPUBLICATION.mdのリリースゲートを参照してください。

エージェント向けツール

接続されたMCPクライアントは、サーバーレベルの指示も受け取ります。その指示では、最初にkernel_statusを呼び出し、ペーパーモードとライブモードを区別し、構造化レスポンスにok: trueが含まれない限り、アクションを成功として報告しないことが求められます。

ローカルでのビルドと実行

前提条件:

• Go 1.25.13以降;

• Node.js 22（公式MCP適合性ランナーのみに必要）;

• サポートされているMCPクライアント。

make test
make build
KALSHI_KERNEL_MODE=paper ./bin/kalshi-kernel

KALSHI_KERNEL_MODEが未設定の場合、ペーパーモードがデフォルトです。ペーパーモードはライブ認証情報の設定を意図的に破棄します。

Hermes

ローカルのstdioサーバーを~/.hermes/config.yamlに追加します:

mcp_servers:
  kalshi-kernel:
    command: "/absolute/path/to/kalshi-kernel/bin/kalshi-kernel"
    env:
      KALSHI_KERNEL_MODE: "paper"

Hermesを再起動し、他のツールより先にkernel_statusを呼び出します。

Claude Code

バイナリをビルドした後:

claude mcp add --scope user --transport stdio kalshi-kernel \
  --env KALSHI_KERNEL_MODE=paper -- /absolute/path/to/bin/kalshi-kernel

次に、claude mcp get kalshi-kernelを実行するか、/mcpを開いて接続を確認します。このローカル設定は、デプロイされたリモートサーバーを必要とするAnthropicの公開Connectors Directoryとは別のものです。

その他のstdioクライアント

標準のMCP設定形式を使用します:

{
  "mcpServers": {
    "kalshi-kernel": {
      "command": "/absolute/path/to/bin/kalshi-kernel",
      "env": {
        "KALSHI_KERNEL_MODE": "paper"
      }
    }
  }
}

実行モード

ペーパーモード

KALSHI_KERNEL_MODE=paper ./bin/kalshi-kernel

ペーパーモードは、そのバックエンドが実装された後、ローカルのシミュレーション台帳を使用します。Kalshiに注文を送信してはなりません。シミュレーションされた約定は、ライブの約定、流動性、レイテンシ、スリッページ、手数料、または収益性を予測または保証するものではありません。

ライブモード

ライブモードは意図的に有効化が困難になっています:

KALSHI_KERNEL_MODE=live
KALSHI_API_KEY_ID=...
KALSHI_PRIVATE_KEY_PATH=/absolute/path/to/private-key.pem
KALSHI_LIVE_TRADING_ACK=I_UNDERSTAND_THIS_TRADES_REAL_MONEY

これらの変数は現在、設定検証のみをアームします。ライブ実行アダプターは接続されていません。認証情報、秘密鍵、.envファイルをコミットしないでください。利用可能な場合は短期認証情報を使用し、本番環境ではシークレットマネージャーを使用し、必要最小限の権限と資本を持つアカウントまたはサブアカウントを使用してください。

仕様駆動の生成

キュレーションされたエージェントインターフェースはspecs/mcp-tools.yamlにあります。各MCPツールを正確なOpenAPIオペレーションIDおよびAsyncAPIチャネルにマッピングします。管理およびアカウント管理エンドポイントは、アップストリームに存在するという理由だけで自動的に公開されることはありません。

4つの権威ある契約がhttps://docs.kalshi.comから取得されます:

• openapi.yaml — イベント契約REST API;

• asyncapi.yaml — イベント契約WebSocket API;

• perps_openapi.yaml — 永久市場REST API;

• perps_asyncapi.yaml — 永久市場WebSocket API。

フェッチャーはHTTPSとソースホスト名を固定し、レスポンスサイズを制限し、期待されるダイアレクトと非空のサーフェスを検証し、ハッシュとHTTP来歴を記録します。アップストリームの契約本文はGitで無視され、必要に応じてローカルキャッシュに取得されます。アップストリームから派生したRESTクライアントもローカルで生成され、ソースリリースから除外されます。来歴ロック、キュレーションされたMCPオーバーレイ、生成されたMCPツール境界のみがバージョン管理されます。テスト済みのロックとMCP境界がプロモートされる前に、再生成とテストは一時的なリポジトリコピーで行われます。

make upstream-test      # test latest contracts without requiring snapshot parity
make upstream-check     # require parity and run MCP conformance
make upstream-promote   # promote only the exact artifacts that passed

すべてのCI実行で厳格なアップストリームチェックが行われます。CIは毎日も実行されるため、リポジトリがアイドル状態でもドリフトが検出されます。

[!WARNING] ダウンロードされたKalshi契約ファイルは、アップストリームの素材の少なくとも一部をプロプライエタリとして識別します。これらはこのプロジェクトのApache-2.0ライセンスの対象外であり、コミットまたは再配布してはなりません。生成されたアーティファクトを公開する前に、THIRD_PARTY_NOTICES.mdを確認してください。

検証

make test              # unit, integration, and contract alignment tests
make test-alignment    # OpenAPI, AsyncAPI, and MCP overlay alignment
make check-generated   # deterministic generated-code check
make test-race         # concurrent calls under Go's race detector
make test-fuzz         # execution-mode parser safety fuzzing
make conformance       # pinned official MCP protocol scenarios
make release-test      # complete local release gate
make public-check      # vulnerability, metadata, and public-readiness gate
make upstream-check    # latest Kalshi contracts plus conformance

このスイートは、トランスポートセキュリティ、認証契約、ミューテーションセキュリティ、オペレーションIDの一意性、固定小数点型、キュレーションされたサーフェス領域、必須フィールドのパリティ、厳格なJSONスキーマ、ツールのタイトルと安全性ヒント、フェイルクローズ動作、並行性、Streamable HTTPネゴシエーションをチェックします。

配布とレジストリ

リポジトリには、公式MCPレジストリ向けの公開メタデータと、OpenAI Plugins DirectoryおよびAnthropicディレクトリ向けの提出書類が含まれています。メタデータは準備であり、承認、推奨、または公開の証拠ではありません。

Anthropicの現在のコネクターレビュー基準では、金銭またはその他の金融資産を移転するコネクターは受け入れられません。したがって、このプロジェクトのClaude Connectors Directoryビルドは、ライブ注文ツールを省略した明確に区別された読み取り専用および/またはペーパーのみのアーティファクトであり、Anthropicのレビューの対象となります。

正確なチャネルマトリックス、現在のブロッカー、リリース手順、リスティングコピー、レビューテストケースについては、PUBLICATION.mdを参照してください。外部レジストリへの提出は自動的には実行されません。

コントリビューションとセキュリティ

プルリクエストを開く前にCONTRIBUTING.mdをお読みください。脆弱性はSECURITY.mdに従って非公開で報告してください。認証情報の漏洩や取引安全性の脆弱性が疑われる場合は、公開イシューを開かないでください。一般的な使用法のヘルプはSUPPORT.mdにあります。

法的およびリスクに関する通知

このソフトウェアは開発および研究用に提供されています。投資、財務、法律、税務、コンプライアンス、または取引に関するアドバイスを提供するものではありません。イベント契約およびレバレッジ商品は、コミットした全額の損失を含む、急速かつ重大な損失をもたらす可能性があります。アカウントの適格性、管轄区域の制限、取引所の規則、規制要件、税金、戦略、注文、および損失については、お客様の責任となります。

AIシステムおよびソフトウェアは、意図を誤解し、不正確なパラメータを生成し、リクエストを繰り返し、または予期しない動作をする可能性があります。ライブデプロイメントの前には、人間によるレビュー、取引所側のリスク制限、最小権限の認証情報、監視、および独立した緊急停止が必要です。

完全なDISCLAIMER.md、PRIVACY.md、およびSECURITY.mdをお読みください。このプロジェクトはApache License 2.0の下でライセンスされています。サードパーティの素材は、THIRD_PARTY_NOTICES.mdに記載されているように除外されます。