kingsplaybook-mcp

kingsplaybook-mcp

KingsPlaybook Developer API 用の公式 MCP サーバーです。スポーツベッティングボット、モデル、分析ツールなどを構築する AI エージェントが、KingsPlaybook のデータにネイティブツールとして直接アクセスできます。

• 確定ラインアップ — NBA、MLB、NHL
• 選手の予測値 — 予測エンジンの生出力
• 標準化された試合ライン — マネーライン／スプレッド／合計、複数のブックを集約
• ピック履歴アーカイブ — 公開済みの記録。結果と締め切り時のラインを含む

/v1 REST API を利用する、薄いローカル（stdio）ラッパーです。 同じデータを、別のプロトコルで利用できます。

API キーを取得する

kingsplaybook.org/devs で登録してください。 Free プランではラインアップを利用でき、有料プランでは予測値、ライン、履歴も利用できます。 キーは kp_live_… の形式です。

インストール

インストールは不要です。npx で直接実行します。MCP クライアントの設定（Claude Desktop、Cursor など）に追加してください。

{
  "mcpServers": {
    "kingsplaybook": {
      "command": "npx",
      "args": ["-y", "kingsplaybook-mcp"],
      "env": {
        "KINGSPLAYBOOK_API_KEY": "kp_live_your_key_here"
      }
    }
  }
}

これで、エージェントから KingsPlaybook のツールを利用できます。

ツール

ツール	返される内容	最低プラン
kingsplaybook_get_lineups	リーグと日付を指定した確定ラインアップ	Free
kingsplaybook_get_projections	リーグと日付を指定した選手の生の予測値	Starter
kingsplaybook_get_lines	リーグと日付を指定した標準化された試合ライン	Pro
kingsplaybook_get_pick_history	日付を指定した公開済みピックと結果	Premium
kingsplaybook_get_freshness	ドメインごとのデータ経過時間の指標	Free

すべてのツールは JSON を返します。プランの利用範囲を超えるツールを呼び出すと、アップグレードリンク付きのわかりやすい 403 メッセージが返されます。

例

• 「今夜の NBA の試合予定は？」 → kingsplaybook_get_lineups({ league: "nba", date: "2026-05-21" })
• 「今日の MLB の予測値を取得して」 → kingsplaybook_get_projections({ league: "mlb", date: "2026-05-21" })
• 「昨日の KingsPlaybook のプロップピックの結果は？」 → kingsplaybook_get_pick_history({ date: "2026-05-20", type: "prop" })

設定

環境変数	必須	デフォルト	用途
KINGSPLAYBOOK_API_KEY	はい	—	kp_live_ API キー
KINGSPLAYBOOK_API_URL	いいえ	https://api.kingsplaybook.org	API のベース URL を上書きします

ローカル開発

npm install
npm run build      # compile TypeScript to dist/
npm start          # run the built server (needs KINGSPLAYBOOK_API_KEY)
npm run dev        # watch mode

リンク

• Developer API とプラン
• Model Context Protocol

ライセンス

MIT