What it does
Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, and soccer.
- Connects パソコンで動く
- Account or key No key needed
- Category ゲーム・スポーツ・料理・学習
この順位の理由
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 6/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 18/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
インストール
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Sports MCP Server をインストールして。https://mcp.popnx.com/i/cyanheads-sports-mcp-server.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
AI にインストールしてもらう
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Sports MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "sports": { "command": "npx", "args": [ "-y", "@cyanheads/sports-mcp-server" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Sports MCP Server のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "sports": { "command": "npx", "args": [ "-y", "@cyanheads/sports-mcp-server" ] } } }Claude を終了してもう一度開く
追加の設定 2 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
THESPORTSDB_API_KEYTheSportsDB の API キー。既定値は '123' で、このキーではチームおよび選手検索の結果が 1 件に制限されます。プレミアムキーではより広範な検索が可能になります。英語の原文を見る
TheSportsDB API key. Defaults to '123', whose team/player searches have a one-record limit. A premium key enables broader searches.MCP_LOG_LEVEL出力する最小のログレベルを設定します(例: 'debug'、'info'、'warn')· 初期値 info英語の原文を見る
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Sports MCP Server につなげません
Sports MCP Server はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · Sports MCP Server につなげるアプリを使う
- 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- 先にパソコンへ Node.js を入れてください(1 回だけ)
- 先にパソコンへ Node.js を入れてください(1 回だけ)
- 先にパソコンへ Node.js を入れてください(1 回だけ)
B · ゲーム・スポーツ・料理・学習 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- ShipSwift✓ ChatGPT
- Anime Garden✓ ChatGPT
- Summer Engine✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Sports MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user sports -- npx -y @cyanheads/sports-mcp-server 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Sports MCP Server のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user sports -- npx -y @cyanheads/sports-mcp-serverClaude Code で /mcp と入力
Sports MCP Server が一覧にあり、接続済みと表示されれば OK です
試してみる
Sports MCP Server を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Sports MCP Server を使っていると言うか、回答に Sports MCP Server のツール名が出れば接続成功です
追加の設定 2 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
THESPORTSDB_API_KEYTheSportsDB の API キー。既定値は '123' で、このキーではチームおよび選手検索の結果が 1 件に制限されます。プレミアムキーではより広範な検索が可能になります。英語の原文を見る
TheSportsDB API key. Defaults to '123', whose team/player searches have a one-record limit. A premium key enables broader searches.MCP_LOG_LEVEL出力する最小のログレベルを設定します(例: 'debug'、'info'、'warn')· 初期値 info英語の原文を見る
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Sports MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "sports": { "command": "npx", "args": [ "-y", "@cyanheads/sports-mcp-server" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Sports MCP Server のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
Cursor の AI チャットを Agent モードで開く
試してみる
Sports MCP Server を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Sports MCP Server を使っていると言うか、回答に Sports MCP Server のツール名が出れば接続成功です
追加の設定 2 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
THESPORTSDB_API_KEYTheSportsDB の API キー。既定値は '123' で、このキーではチームおよび選手検索の結果が 1 件に制限されます。プレミアムキーではより広範な検索が可能になります。英語の原文を見る
TheSportsDB API key. Defaults to '123', whose team/player searches have a one-record limit. A premium key enables broader searches.MCP_LOG_LEVEL出力する最小のログレベルを設定します(例: 'debug'、'info'、'warn')· 初期値 info英語の原文を見る
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Sports MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "sports": { "type": "stdio", "command": "npx", "args": [ "-y", "@cyanheads/sports-mcp-server" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Sports MCP Server のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
VS Code の AI チャットを Agent モードで開く
試してみる
Sports MCP Server を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Sports MCP Server を使っていると言うか、回答に Sports MCP Server のツール名が出れば接続成功です
追加の設定 2 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
THESPORTSDB_API_KEYTheSportsDB の API キー。既定値は '123' で、このキーではチームおよび選手検索の結果が 1 件に制限されます。プレミアムキーではより広範な検索が可能になります。英語の原文を見る
TheSportsDB API key. Defaults to '123', whose team/player searches have a one-record limit. A premium key enables broader searches.MCP_LOG_LEVEL出力する最小のログレベルを設定します(例: 'debug'、'info'、'warn')· 初期値 info英語の原文を見る
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user sports -- npx -y @cyanheads/sports-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"sports": {
"command": "npx",
"args": [
"-y",
"@cyanheads/sports-mcp-server"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"sports": {
"command": "npx",
"args": [
"-y",
"@cyanheads/sports-mcp-server"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"sports": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/sports-mcp-server"
]
}
}
}自分で入力する値
THESPORTSDB_API_KEY秘密 envTheSportsDB の API キー。既定値は '123' で、このキーではチームおよび選手検索の結果が 1 件に制限されます。プレミアムキーではより広範な検索が可能になります。英語の原文を見る
TheSportsDB API key. Defaults to '123', whose team/player searches have a one-record limit. A premium key enables broader searches.MCP_LOG_LEVELenv出力する最小のログレベルを設定します(例: 'debug'、'info'、'warn')英語の原文を見る
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント cyanheads で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:20 日前
- ✓ 合格
ライセンスがある
Apache-2.0を使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
公開済みの脆弱性(OSV.dev)
OSV.dev に @cyanheads/sports-mcp-server@0.6.0 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/cyanheads-sports-mcp-server)話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
ゲーム・スポーツ・料理・学習のほかのサーバーとの比較i
- このカテゴリのほかの1619件のうち91%よりスターが多い
- このカテゴリのほかの1619件のうち57%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの1619件のうち99%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Sports MCP Serverは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は20 日前、最新バージョン(0.6.0)がレジストリに届いたのは20 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
似た働きのほかの候補
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
| これ Sports MCP Server | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | GoodWatch | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | いいえ | いいえ | いいえ | はい | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 3/3 | 4/4 | 3/4 | 4/4 |
| ライセンス | Apache-2.0 | AGPL-3.0 | MIT | MIT | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
@cyanheads/sports-mcp-server Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP. 8 Tools
Overview
Live and historical sports data from ESPN, MLB StatsAPI, and TheSportsDB. Check scores, schedules, and standings, and look up teams and players across the NFL, NBA, MLB, NHL, major soccer leagues, and college football and basketball.
Tools
| Tool | Description |
|---|---|
sports_find_team | Resolve a team name or partial name to canonical records and source IDs across providers. |
sports_find_player | Resolve a player name to canonical TheSportsDB records with ID, team, position, and bio fields. |
sports_get_scores | Live and final scores for a league on a given date, optionally filtered by team. |
sports_get_game | Game metadata, period scores, team totals, provider top performers, and paged scoring plays. |
sports_get_schedule | Upcoming and past fixtures for a team or league over a date range. |
sports_get_standings | Current standings or league table for a league and season. |
sports_get_team | Team detail combining metadata, roster, recent results, and upcoming fixtures. |
sports_get_player | Player details from TheSportsDB — biography, team, position, and physical stats. |
Agent skill
The sports-guide covers complete fixture ranges, game recaps, standings comparisons, and player identity checks. It ships with plugin installs, npm, Docker, and the desktop bundle, and is available to MCP clients as a skill resource.
Capability reference
sports_find_team tool
- Free-text
query(max 200 characters) with an optionalleaguefilter - Returns team metadata with
espnId/mlbId/tsdbIdcross-references merged across providers;totalFoundcounts returned records - Failed ESPN/MLB lookups appear in
unavailableSources; no results returnsno_match, orsources_unavailableif a source failed. The free TheSportsDB key can return incomplete results
sports_find_player tool
- Free-text
query(max 200 characters); optionalsportis advisory and does not filter - Returns player IDs, name, team, position, nationality, birth date, and thumbnail;
no_matchwhen none is found - The default key
123limits searches to one record
sports_get_scores tool
leaguerequired;date(YYYY-MM-DD) defaults to today in US Eastern time; optionalteam_namefilters games- Returns home/away teams, score, status, period or clock, and UTC start time. Empty results carry
reason,emptyReason(no_gamesorno_team_matches), andnotice limitdefaults to 100 (max 200) andoffsetto 0; responses includeavailableGames,totalReturned,effectiveLimit,offset,truncated, andnextOffset
sports_get_schedule tool
leaguerequired; optionalteam_name,date_from/date_to,limit(default 100, max 200), andoffset(default 0). A single date bound requests that day; reversed dates fail- Returns home/away teams and scores, status, UTC start time, venue, and source. A partial
team_namemust identify one team:ambiguous_teamlists candidates,team_not_foundmeans no match - Dated requests cover at most seven days. Responses include
requestedDateFrom/requestedDateTo,servedDateFrom/servedDateTo,availableGames,effectiveLimit,offset, andtruncated; follownextOffset, thennextDateFromasdate_from
sports_get_game tool
- Required
leagueand source-prefixed numericgame_idfrom scores, schedules, or team detail;mlb:IDs requireleague: "mlb" - Returns game metadata plus
periodScores,teamStats,leaders, andscoringPlays; missing values are null. Scheduled games return metadata only;game_not_foundfor a missing or wrong-league game. Athlete IDs belong to ESPN or MLB, not TheSportsDB limitdefaults to 20 (max 50) andoffsetto 0; responses includetotalCount,returnedCount,servedFrom/servedTo,effectiveLimit, andnextOffset
sports_get_standings tool
leaguerequired; optionalseason(4-digit year), current season if omitted- Returns rank, group (conference, table, or MLB division), wins, losses, ties, NHL overtime losses, points, winning percentage, division rank, streak, and games behind; inapplicable values are null.
season_not_foundwhen the season has no data limitdefaults to 100 (max 200) andoffsetto 0; responses includeavailableStandings,totalReturned,effectiveLimit,offset,truncated, andnextOffset. If the MLB team lookup fails,unavailableSourceslistsstandings_team_metadata
sports_get_team tool
leagueandteam_namerequired; exact names or abbreviations win, otherwise a partial name must identify one team (ambiguous_teamlists candidates,team_not_foundmeans no match)- Returns metadata, active roster, the latest 5 completed results, and the next 3 scheduled fixtures
- NFL rosters exclude injured-reserve/out, suspended, and practice-squad players; missing jerseys and venues are null
sports_get_player tool
player_idaccepts atsdb:-prefixed ID (fromsports_find_player) or a raw numeric TheSportsDB ID- Returns biography, team, position, nationality, birth date, height, weight, and thumbnail;
player_not_foundwhen the ID doesn't resolve espnIdis filled when TheSportsDB supplies one, otherwise null
Features
Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
Sports-specific:
- Three keyless sources — ESPN site API, MLB StatsAPI, and TheSportsDB (free tier key
123) - League routing sends each query to the best source per sport
- Normalized output types across sources —
NormalizedGame,NormalizedTeam,NormalizedPlayer,NormalizedStanding - Cross-source team IDs merged onto one record by
sports_find_team - Off-season queries return a notice (standings) or
games: []with areason(scoreboards) instead of an error
Agent-friendly output:
- Source provenance on every record —
source: 'espn' | 'mlbstats' | 'thesportsdb' - Typed error reasons (
no_match,sources_unavailable,team_not_found,ambiguous_team,player_not_found,season_not_found,game_not_found,incompatible_game_source), each with a recovery hint - Typed empty-result notices and pagination or schedule-window metadata on every response
- Provider text is escaped and treated as data, never instructions
Getting started
Add it to Claude Code:
claude mcp add sports-mcp-server -- npx -y @cyanheads/sports-mcp-server
For other clients, add this to the MCP config file:
{
"mcpServers": { "sports-mcp-server": { "command": "npx", "args": ["-y", "@cyanheads/sports-mcp-server"] } } }
No API keys are required. THESPORTSDB_API_KEY optionally enables a premium key for broader player and team searches; the default free key returns at most one record. For Docker or a source build, see Running the server.
Configuration
| Variable | Description | Default |
|---|---|---|
THESPORTSDB_API_KEY | TheSportsDB API key. The free key limits searches to one record. | 123 |
MCP_TRANSPORT_TYPE | Transport: stdio or http. | stdio |
MCP_HTTP_PORT | Port for HTTP server. | 3010 |
MCP_SESSION_MODE | HTTP session mode: stateful, stateless, or auto. | stateless |
MCP_AUTH_MODE | Auth mode: none, jwt, or oauth. | none |
MCP_LOG_LEVEL | Log level (RFC 5424). | info |
LOGS_DIR | Directory for log files (Node.js only). | /logs |
LOG_TOOL_FAILURE_PAYLOADS | Log failed tool arguments and results, redacted by key name and capped by LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES (default 16384). Free-form values are not redacted. | false |
OTEL_ENABLED | Enable OpenTelemetry instrumentation. | false |
OTEL_EXPORTER_OTLP_ENDPOINT | Base OTLP/HTTP URL for traces and metrics. | Unset |
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT | OTLP log endpoint. | Unset |
See .env.example for the full list of optional overrides.
Running the server
Local development
Requires Bun v1.4.0 or higher and Node.js v24+.
git clone https://github.com/cyanheads/sports-mcp-server.git
cd sports-mcp-server && bun install cp .env.example .env
All overrides are optional.
Serving commands execute Node, including when launched with bun run. Bun handles dependency resolution and build tooling; ESPN requests run under Node.
- Build and run:
# One-time build
bun run rebuild
Run the built server
bun run start:stdio
or
bun run start:http
- Run checks and tests:
bun run devcheck # Lint, format, typecheck, security
bun run test # Vitest test suite bun run lint:mcp # Validate MCP definitions against spec
Docker
docker run --rm -p 3010:3010 ghcr.io/cyanheads/sports-mcp-server:latest
The image builds with Bun, runs the production server under Node, defaults to HTTP transport and stateless session mode, and logs to /var/log/sports-mcp-server. For stdio, use docker run -i --rm -e MCP_TRANSPORT_TYPE=stdio ghcr.io/cyanheads/sports-mcp-server:latest. To build locally, use docker build -t sports-mcp-server .; OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.
Project structure
|