DunkAPI

DunkAPI MCP サーバー

バスケットボールデータ API です。 すべてのショット位置を含む NBA のプレーごとのデータ、ボックススコア、勝率、順位表、負傷情報、独自のチーム Elo レーティング、スポーツブックのオッズと選手プロップのオッズに加え、WNBA、男女の NCAA ディビジョン I 大学バスケットボールのデータを提供します。REST API と MCP サーバーです。毎月 500 クレジット無料で、カードは不要です。

ウェブサイト：https://dunkapi.com · ドキュメント：https://dunkapi.com/docs · キーを取得：https://dunkapi.com/signup

You:    "What was each sportsbook's closing spread for every Celtics home game in 2023-24?"
Claude: [calls get_odds]

You:    "Which players took the most shots at the rim in the 2025 playoffs?"
Claude: [calls get_shot_chart]

You:    "How often has Jalen Brunson gone over his points line this season?"
Claude: [calls get_prop_history]

ローカルで実行する（stdio）

ほとんどのクライアントは https://mcp.dunkapi.com/mcp に直接接続します。代わりにローカルプロセスを起動するクライアントの場合：

git clone https://github.com/noahowsh/dunkapi-mcp.git && cd dunkapi-mcp && npm install
DUNKAPI_API_KEY=your_key node index.js

{ "mcpServers": { "dunkapi": { "command": "node", "args": ["/path/to/dunkapi-mcp/index.js"], "env": { "DUNKAPI_API_KEY": "your_key" } } } }

キーを使ってホスト型サーバーに転送するため、すべてのツールとクレジットの料金は同じです。

スキル

skills/ には、Claude を NBA、WNBA、男女の大学バスケットボールのアナリストにする 16 個の無料 Claude スキルがあります。各スキルは Markdown ファイルで、使用する場面、呼び出す DunkAPI ツールとその料金、手法（ショットゾーンと期待得点、ペースと効率、直近の試合ログ、プロップのモデリング、控除率の除去、バックテスト）、実際の API レスポンスから抜粋した例を記載しています。

git clone https://github.com/noahowsh/dunkapi-mcp.git

または、Claude Code プラグインとしてインストールできます：

/plugin marketplace add noahowsh/dunkapi-mcp
/plugin install dunkapi-skills@dunkapi

skills CLI からインストールすることもできます：npx skills add noahowsh/dunkapi-mcp。

Claude に skills/ フォルダーを指定し、以下の MCP サーバーに接続して、質問してください。どのスキルを使えばよいかわからない場合は、dispatch スキルから始めてください。スキルは自分の CSV ファイルや JSON ファイルでも、キーなしで利用できます。全スキルの一覧はこちらです：skills/README.md。

Python

公式 Python クライアントは PyPI にあります：dunkapi。

pip install dunkapi
export DUNKAPI_API_KEY=sk_live_...

from dunkapi import Client, to_dataframe

client = Client()

props = client.get_player_props(
    game_id="401810726",
    market="player_points",
    bookmaker="draftkings",
)
df = to_dataframe(props, key="props")
print(df[["player_name", "line", "over_odds", "under_odds"]].head(10))

不正なキー、クレジット切れ、未検出、レート制限に対応する型付きエラー、自動リトライ、pandas 用の to_dataframe を利用できます。

クイックスタート

これは Streamable HTTP を使うホスト型（リモート）MCP サーバーです。インストールは不要です。

Claude Code

claude mcp add --transport http dunkapi "https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop、Cursor、その他のクライアント

{
  "mcpServers": {
    "dunkapi": {
      "url": "https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

キーは x-api-key ヘッダーまたは Authorization: Bearer で送信することもできます。キーなしでも接続とツールの一覧表示はできますが、ツールの呼び出しにはキーが必要です。

REST

curl -X POST https://mcp.dunkapi.com/v1/list_teams -H "x-api-key: YOUR_API_KEY"

すべてのツールは、JSON ボディを使う POST /v1/{tool} です。

使用例

Python（標準ライブラリのみ）と Node 18+（依存関係なし）の実行可能な例は、examples/ にあります：

• examples/python/quickstart.py と examples/node/quickstart.mjs：スケジュールとヘッドラインの呼び出し。
• examples/python/nba_player_props.py：試合結果と選手プロップのオッズを比較します。

export DUNKAPI_API_KEY=your_key
python3 examples/python/quickstart.py
node examples/node/quickstart.mjs

詳細は examples/README.md をご覧ください。https://dunkapi.com/signup で無料キーを取得できます（毎月 500 クレジット、カード不要）。

ツール（18）

ツール	返される内容
list_teams	シーズンのチーム ID、略称、カラー
search_players	名前で選手を検索
list_games	シーズン、日付、期間、またはチーム別のスコア付き試合
get_schedule	スポーツブック全体の中央値ライン付きの今後の試合
get_standings	すべての最終試合の順位：全体、カンファレンス、ホーム、アウェー、直近10試合
get_injuries	最新の負傷者レポート：ステータス、負傷内容、復帰予定（NBA、WNBA）
get_ratings	チームのEloレーティングを順位順に表示
get_game	1試合分のデータ：両チームのボックススコア、全選手の成績、各ブックのライン、勝率
get_player	プロフィール、シーズン別平均とシュート成功率の内訳、直近10試合
get_player_games	選手の全試合ログ
get_leaders	シーズンの1試合あたり、割合、または合計によるリーダー
get_team_stats	ペース、オフェンス、ディフェンス、ネットレーティング、および4つのファクター
get_odds	試合（5）または1日（10）の、全スポーツブックのマネーライン、スプレッド、合計得点と、ラインに対する結果
get_plays	ショット位置、ゾーン、期待得点、勝率付きのプレーバイプレー
get_shot_chart	選手、チーム、またはディフェンスのゾーン別シュートプロファイルと、全ショットのx/y座標
get_line_movement	ティップオフ前の各スポーツブックのラインのスナップショット
get_player_props	スポーツブック別の選手プロップライン、オープニングとクロージング
get_prop_history	試合ごとの、選手のプロップラインと結果

リーグ：nba（デフォルト）、wnba、ncaam、ncaaw（任意のツールに league を渡します）。

データ

• 2003-04シーズン以降のNBAの試合。プレーバイプレーとショット位置（x/y、ゾーン、期待得点、勝率）を含みます
• WNBA、ならびに男子・女子のNCAAディビジョンIバスケットボールも同じツールで利用できます
• チームのEloレーティング、すべての最終試合に基づく順位、負傷者レポート（NBA、WNBA）
• スポーツブック別のマネーライン、スプレッド、合計得点：2013-14から2023-24シーズンまでのNBAレギュラーシーズンの1試合あたり4～12ブック（2020-21シーズン以降は10～12ブック）。2020年7月以降はオープニングとクロージングのラインも含みます（2020-21から2022-23シーズンのNBAでは1試合あたり中央値で7ブック、それ以降は8ブック）。提供開始時からの試合前ラインのスナップショット：1日1回、今後2日以内の試合は1時間ごと
• スポーツブック別の選手プロップライン（得点、リバウンド、アシスト、スリーポイント、得点＋リバウンド＋アシスト、ブロック、スティール）：NBAとWNBAは2023年5月以降、男子大学バスケットボールは2023-24シーズン以降。各ラインに対する結果も含みます（get_player_props、get_prop_history）
• 女子大学バスケットボール：2024年11月以降のオープニングとクロージングのライン（中央値で4ブック）。選手プロップはありません

シーズン別の対象範囲はデータベースからリアルタイムで読み込まれます：https://dunkapi.com/docs

便利なページ

• ライブのオッズとライン：https://dunkapi.com/odds
• 今日の選手プロップ（各選手についてブックメーカー間の最良価格を掲載。2026-27シーズン開幕からライブ更新）：https://dunkapi.com/props
• 今日の大学バスケットボール選手プロップ（2026-27シーズンからライブ更新）：https://dunkapi.com/props/college-basketball
• 大学プロップの履歴ガイド：得点、リバウンド
• プロップガイド：得点プロップ履歴、スリーポイントプロップ履歴
• ガイド（Python、ライブ API を使用）：https://dunkapi.com/guides
  • NBA のプレーごとの記録、ゾーン別ショットチャート、終値ラインのバックテスト、チームのペースと効率、選手の試合ログと移動平均
• ドキュメントとエンドポイントリファレンス：https://dunkapi.com/docs
• シーズン別のデータ範囲：https://dunkapi.com/docs/atlas
• データセット：https://dunkapi.com/data (プレーごとの記録、ショットチャート、オッズ履歴、選手プロップ)
• 料金：https://dunkapi.com/pricing
• 比較：BallDontLie、nba_api と stats.nba.com、Basketball Reference、Sportradar、SportsDataIO
• リーグ：WNBA、男子大学バスケットボール、女子大学バスケットボール

料金

毎月500クレジットを無料で利用できます。カード登録は不要です。プラン：Starter 月額 $19（10,000 クレジット）、Pro 月額 $49（30,000 クレジット）、Scale 月額 $149（125,000 クレジット）。ウォレットへのチャージは $5 からで、有効期限はありません。https://dunkapi.com/pricing

帰属表示

レーティングは当社独自のものです。NBA、WNBA、NCAA、またはいずれのチームとも提携していません。

ライセンス

このリポジトリの内容は MIT ライセンスです。データの利用条件は上記のとおりです。

Codex での使用

このリポジトリを Codex プラグインマーケットプレイスとして追加し、プラグインをインストールします。

codex plugin marketplace add noahowsh/dunkapi-mcp

次に、Codex でプラグインディレクトリを開き、dunkapi マーケットプレイスから dunkapi-skills をインストールします。このプラグインには、skills/ 内のスキルと DunkAPI MCP サーバー（https://mcp.dunkapi.com/mcp）が含まれています。先にキーを設定してください（https://dunkapi.com/signup で無料取得できます）。

export DUNKAPI_API_KEY=your_key

Codex はこれをベアラートークンとして送信します。

Gemini CLI での使用

export DUNKAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/dunkapi-mcp

この拡張機能は DunkAPI MCP サーバー（https://mcp.dunkapi.com/mcp）を追加し、`x-api-key` ヘッダーでキーを送信します。https://dunkapi.com/signup で無料キー（毎月500クレジット）を取得してください。