Thesportsdb

@pipeworx/thesportsdb

TheSportsDB MCP — 50以上のリーグを網羅するスポーツカタログ：チーム、選手、試合、会場、リーグ順位表。無料プランでは公開キーを利用できます。

Pipeworx の一部です。AI エージェントを1684以上のライブデータソースに接続するMCPゲートウェイです。

ツール

• list_sports() / list_leagues(sport?, country?)
• search_teams(query)、get_team(team_id)、league_teams(league_id)
• search_players(query) / get_player(player_id)
• team_events_last(team_id) / team_events_next(team_id)
• events_by_day(date, sport?, league?)
• league_table(league_id, season?)

認証

無料の公開プランではAPIキー 3 を使用します（広く知られており、登録不要です）。Pipeworxではこれがデフォルトです。より高いレート制限や追加エンドポイントが必要な場合は、https://www.thesportsdb.com/ で登録し、?_apiKey=<key> を指定してご自身のキーをご利用ください。

データソース

https://www.thesportsdb.com/api/v1/json/<apiKey>/

試合の詳細（event_detail、event_timeline、event_stats、event_lineup）

1試合に関する質問に答えるための4つの試合別ツールです。スコアと会場（event_detail）、得点者・アシスト・時間に加え、カードと交代（event_timeline）、チーム別統計（event_stats）、先発メンバーと控え選手（event_lineup）を取得できます。すべてTheSportsDBの event_id を受け取ります。events_by_day、team_events_last、または team_events_next で検索してください。

プレミアム限定ではありません — ただし、無料プランではデータが切り詰められます

無料の公開キーで2026-09-12に測定したところ、4つのエンドポイントすべてが実際のデータを返しました。そのためキーは不要で、いずれのツールもキーがないことを理由に拒否しません。

無料プランでは、各配列が通知なしに5行までに制限されます。idEvent 2594568（Bayern Munich 対 Bodø/Glimt、最終スコア 5-0）では、タイムラインは5行を返し、最も早い時間は45分で、2ゴールが含まれていました。前半のゴールはすべて欠落しています。event_stats は5つの統計を返しますが、枠内シュート、コーナーキック、ポゼッションは含まれません。event_lineup は5人の選手を返します。intHomeScoreHT / intAwayScoreHT はnullになります。

そのため、結果を確定する用途では、サポーターキーが重要です。必要なのはアクセスのためではなく、データを完全に取得するためです。_apiKey として渡してください。

ツールが結果を知らせる方法

event_timeline は取得できたゴールを試合の最終スコアと照合します。両者が一致しない場合、complete: false を返し、goals_in_timeline、goals_in_final_score とともに、先制得点者やハーフタイムに関する質問の確定には使わないよう注意を示します。これは推測ではなく、データが切り詰められている証拠です。event_stats と event_lineup には同等の不変条件がないため、ちょうど5行が返された場合は complete: null と報告します。データが少ない試合の全件なのか、大量のデータが切り詰められた結果なのかは、レスポンスだけでは判別できません。

カバレッジは大会ごとです

ソースがカバーしていない試合については、エラーや誤った回答ではなく、理由とともに found: false が返されます。上流から同じ形式（どちらも単独の null）で返される次の2つのケースを、ツールは区別します。no_timeline_for_event は試合が存在し、その試合名も返されているものの、その大会のタイムラインがソースにない状態です。一方、no_data_and_event_unconfirmed はイベントIDも確認できなかった状態です。市場の結果を確定する側にとって、この2つの結論は正反対です。「別のソースに問い合わせる」と「対象の試合が違う」です。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "thesportsdb": {
      "url": "https://gateway.pipeworx.io/thesportsdb/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/thesportsdb/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに共有ツールが約 30 個表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の状況を確認するうえで最も信頼できる情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、ask_pipeworx を介してカタログ全体から検索できるため、このパックでは扱わない質問にも、MCP サーバーを追加せずに回答できます。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキストコストがルーティングのメリットを上回る場合は、複数のパックエンドポイントではなく、完全なゲートウェイに一度接続してください。

または、完全な Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1684 以上のデータソースにアクセスします。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

このパックでは独自の API キー（_apiKey）が必要です。こちらでは API キーを用意していないため、キーなしで実行できる curl コマンドはありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/thesportsdb_list_sports を使います。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイへのラウンドトリップも不要です。

{
  "mcpServers": {
    "thesportsdb": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-thesportsdb"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-thesportsdb

stdin/stdout 経由で MCP を通信し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。この方法は、上記のパックエンドポイントでも完全なゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Thesportsdb data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT