footballstack-mcp

FootballStack のフットボールデータ API 用の MCP サーバーです。LLM クライアントに、幻覚のスコアラインではなく、実際のフットボールデータ（試合日程、順位表、ラインナップ、ライブイベント、ピッチ座標付きのショットレベル xG、モデル導出のフェアオッズ）を提供します。

12 ツール、1 プロンプト。Node ≥ 20、ビルドステップ不要。

インストール

npx footballstack-mcp

環境変数に API キーを設定してください。無料プランは月 1,000 リクエストです。footballstackapi.com/sign-in でキーを取得できます。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "footballstack": {
      "command": "npx",
      "args": ["-y", "footballstack-mcp"],
      "env": { "FOOTBALLSTACK_API_KEY": "fs_live_..." }
    }
  }
}

Cursor / Windsurf / 任意の stdio MCP クライアント

同じブロックを、そのクライアントの MCP 設定ファイルに追加します。

Related MCP server: worldcup-ai-forecaster

ツール

プロンプト: scout_team_form — チームを特定し、直近 5 試合を取得し、結果の背後にある xG を読み取ります。

footballstack_search から始めて ID を特定してください。ID を推測するとクォータを浪費します: 404 や空の結果も他のリクエストと同様に計上されます。

カバレッジ（正直に言うと）

カタログには 75 の競技が掲載されています。深さは均一ではなく、カタログは深いカバレッジよりも広いです。

• 最も深い: Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României

• 拡張ヨーロッパ: Eredivisie, Primeira Liga, Süper Lig, Pro League, Scottish Premiership

• 歴史 / 分析のみ: Premier League, La Liga, Serie A, Ligue 1 (xG は Understat 由来)

footballstack_competitions を呼び出して、構築する前に自分のリーグを確認してください。

クォータの動作

• 無料: 月 1,000 リクエスト、毎分 10 リクエスト。Developer $9/月: 月 10,000 リクエスト、毎分 60 リクエスト、xG、ショットマップ、ラインナップ、ライブイベント、フェアオッズを含む。Pro $29/月: 月 50,000 リクエスト、毎分 180 リクエスト。

• 超過請求はありません。 クォータを使い切ると API は 429 を返します。このサーバーはそれを空の結果ではなく quota_or_rate_limit エラーとして表面化します。

• クォータは毎月 1 日 (UTC) にリセットされます。

• すべてのリクエストが計上されます。404 や空の結果も含みます。

このツールが適さない場合

• 多くの競技にわたる高頻度のライブポーリング。 月間クォータはそれに適していません — 他の場所の日次または秒単位のプランの方がコストが低くなります。

• 上記の深いカバレッジリストにないリーグ。

• 契約上の SLA、稼働時間クレジット、または指名されたサポート窓口が必要な場合。 これらの価格では提供されていません。

開発

npm install
npm run smoke   # boots the server over stdio, lists tools, calls health

npm run smoke は API キーなしで動作します: footballstack_health はライブステータスを返し、キーが必要なツールは読みやすい missing_api_key エラーを返すため、「未設定」と「壊れている」を区別できます。

MIT.