Kalshi MCP Server

@quantish/kalshi-server

⚠️ お知らせ：Quantish はサービスを終了します。 Quantish プラットフォーム（quantish.live）は終了します。この MCP サーバーはセルフホスト型で、独立して引き続き動作しますが、Quantish チームによる本プロジェクトの保守や更新は今後行われません。予測市場分野で開発しており、リアルタイムデータ基盤が必要な場合は、polynode.devをご確認ください。

Solana 上の DFlow を介して Kalshi 市場で取引するための、セルフホスト型 Kalshi MCP サーバーです。

概要

このパッケージは、Solana 上の DFlow プロトコルを介して、AI エージェントが Kalshi の予測市場で取引できる MCP（Model Context Protocol）サーバーを提供します。

機能

• Kalshi での完全な取引機能 - 任意の Kalshi 市場で売買できます
• Solana ウォレット管理 - Solana ウォレットを生成、管理できます
• DFlow 連携 - DFlow の Solana インフラストラクチャを介して取引できます
• Jupiter スワップ - Jupiter Aggregator を介して SOL／USDC をスワップできます
• MCP 互換 - Claude、Quantish Agent、およびあらゆる MCP クライアントで動作します
• セルフホスト可能 - Railway、Fly.io、または任意の Node.js ホストで実行できます

クイックスタート

git clone https://github.com/joinQuantish/kalshi-mcp
cd kalshi-mcp
npm install

環境変数

変数	必須	説明
DATABASE_URL	はい	PostgreSQL 接続文字列
ENCRYPTION_KEY	はい	ウォレット暗号化用の 64 文字の 16 進文字列
DFLOW_API_KEY	いいえ	DFlow API キー（任意。認証が必要なエンドポイントで使用）
JUPITER_API_KEY	いいえ	スワップツール用の portal.jup.ag で取得する Jupiter API キー
SOLANA_RPC_URL	いいえ	Solana RPC エンドポイント（デフォルトはメインネット）
ADMIN_API_KEY	いいえ	管理用エンドポイントの管理者 API キー
PORT	いいえ	サーバーのポート（デフォルトは 3002）

API キーの取得

DFlow API キー：

DFlow へのアクセスには承認が必要な場合があります。API アクセスについては、dflow.net から DFlow チームにお問い合わせください。

Jupiter API キー：

portal.jup.ag から無料の API キーを取得できます（Basic ティア、1 RPS）。スワップ機能に必要です。

Quantish の公開サーバーを利用していますか？ プラットフォームの終了に伴い、Quantish の公開サーバーは利用できなくなりました。この MCP サーバーを使用するには、セルフホストする必要があります。上記のセットアップ手順に従って、ご自身のインスタンスを実行してください。

暗号化キーの生成

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

データベースのセットアップ

任意の PostgreSQL データベースを使用できます。選択肢は次のとおりです。

プロバイダー	備考
Railway	PostgreSQL サービスを追加し、変数から DATABASE_URL をコピーします
Supabase	supabase.com で無料プランを利用できます。Settings > Database から接続文字列をコピーします
Neon	neon.tech のサーバーレス Postgres。無料プランも利用できます
ローカル Docker	docker run -e POSTGRES_PASSWORD=pass -p 5432:5432 postgres

DATABASE_URL を設定してから、次を実行します。

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

利用可能なツール

アカウント管理

• kalshi_signup - Solana ウォレットを使用してアカウントを作成
• kalshi_request_api_key - アクセスコードを使用して API キーを申請
• kalshi_get_wallet_info - ウォレットアドレスと種類を取得
• kalshi_get_wallet_status - 残高を含むウォレットの完全なステータスを取得
• kalshi_get_balances - SOL と USDC の残高を取得
• kalshi_get_deposit_address - 入金用アドレスを取得
• kalshi_export_private_key - ウォレットの秘密鍵をエクスポート
• kalshi_import_private_key - 既存の Solana ウォレットをインポート

市場の検索

• kalshi_search_markets - キーワードで Kalshi 市場を検索
• kalshi_get_market - ティッカーで市場の詳細を取得
• kalshi_get_event - ネストされたすべての市場を含むイベントを取得
• kalshi_get_events - フィルターを指定してイベントを閲覧
• kalshi_get_live_data - ライブ価格データを取得

取引

• kalshi_get_quote - 予測市場取引の見積もりを取得
• kalshi_buy_yes - YES の結果トークンを購入
• kalshi_buy_no - NO の結果トークンを購入
• kalshi_sell_position - 結果トークンを USDC に売却
• kalshi_get_positions - 現在のポジションを表示
• kalshi_get_orders - 注文履歴を表示

スワップ（SOL/USDC）

• kalshi_get_swap_quote - Jupiter のスワップ見積もりを取得
• kalshi_execute_swap - トークンのスワップを実行
• kalshi_swap_sol_to_usdc - SOL を USDC にスワップ
• kalshi_swap_usdc_to_sol - USDC を SOL にスワップ

送金

• kalshi_send_sol - 別のウォレットに SOL を送金
• kalshi_send_usdc - 別のウォレットに USDC を送金
• kalshi_send_token - 任意の SPL トークンを送金

マーケット操作

• kalshi_check_market_initialization - マーケットがオンチェーンでトークン化されているか確認
• kalshi_initialize_market - マーケットをオンチェーンで初期化（SOL 手数料がかかります）
• kalshi_check_redemption_status - マーケットが決済済みか確認
• kalshi_get_market_by_mint - トークンのミントアドレスからマーケットを検索

償還

• kalshi_get_redeemable_positions - 請求可能なポジションを検索
• kalshi_redeem_winnings - 特定の勝ちポジションを償還
• kalshi_redeem_all_positions - すべての勝ちポジションを一度に償還

API キー管理

• kalshi_list_api_keys - API キーを一覧表示
• kalshi_create_additional_api_key - 新しい API キーを作成
• kalshi_revoke_api_key - API キーを無効化

API 形式

サーバーは /mcp に JSON-RPC 2.0 エンドポイントを公開します。

curl -X POST https://your-server.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "kalshi_get_positions",
      "arguments": {}
    },
    "id": 1
  }'

Quantish Agent への接続

サーバーを使用するよう CLI を設定します。

export KALSHI_MCP_URL=https://your-server.com/mcp
export KALSHI_API_KEY=your-api-key
quantish

または、~/.quantish/config.json に追加します。

{
  "kalshiMcpUrl": "https://your-server.com/mcp",
  "kalshiApiKey": "your-api-key"
}

開発

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Run migrations
npm run db:push

# Start development server
npm run dev

リソース

• NPM: @quantish/kalshi-server
• GitHub: joinQuantish/kalshi-mcp
• Quantish Agent: @quantish/agent
• DFlow ドキュメント: pond.dflow.net
• Jupiter ポータル: portal.jup.ag

ライセンス

このプロジェクトは、PolyForm Noncommercial License 1.0.0 の下でライセンスされています。

個人利用、研究、非商用目的であれば無料で利用できます。 商用利用には、Quantish Inc. の明示的な許可が必要です。商用ライセンスについては [email protected] までお問い合わせください。

---

Quantish Inc. が開発