Openfoot Mcp

io.github.bartokulus由 GitHub 帳號 bartokulus 發布v0.1.2更新於 Oct 24, 2026

Football fixtures, standings, lineups, live events and shot-level xG across 75 competitions.

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

本機 MCP 伺服器，透過 OpenFootAPI 讓助理取得真實足球資料：賽程、積分榜、陣容、即時事件、逐射門 xG 與公平賠率。

可以做什麼
查詢賽事、賽季與資料來源，並以自由文字搜尋把球隊或賽事名稱解析成穩定 ID。依日期、賽事、球隊、狀態、賽季或輪次篩選取得賽程與賽果，以及積分榜。讀取比賽細節：先發陣容與陣型、進球、紅黃牌、換人與文字直播時間軸。取得含球場座標的逐射門 xG、聯賽 xG 表，以及狀態、對戰紀錄等衍生背景資訊。查看博彩公司基準與隱含公平機率、當月剩餘額度與 API 是否可連線。
適用情境
適合讓助理以真實資料回答足球問題，而不是憑空編造比分，尤其是覆蓋最深的聯賽（德甲、德乙、德國盃、羅馬尼亞超級聯賽）與擴充的歐洲賽事。也適合搭配內建的球探提示，做以 xG 為基礎的球隊狀態分析。
執行需求
透過 npx 以 stdio 在本機執行，需要 Node.js 20 或更新版本。需要 OpenFootAPI 金鑰，透過環境變數 OPENFOOT_API_KEY 提供；有每月 5,000 次請求的免費額度。需要能連線至 OpenFootAPI 服務的網路。
安裝前請注意
API 金鑰屬敏感資訊，透過環境變數傳入。每次請求都會計費，包括 404 與空結果，因此猜測 ID 會浪費額度；伺服器會把額度或限流問題回報為錯誤，而非空結果。另有付費方案，額度按月重置。賠率資料僅供參考，不構成投注建議。各賽事覆蓋深度不一，依賴前請先確認該聯賽。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Openfoot Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

openfoot-mcp

MCP server for the OpenFootAPI football intelligence API. Gives an LLM client real football data — fixtures, standings, lineups, live events, shot-level xG with pitch coordinates, and model-derived fair odds — instead of a hallucinated scoreline.

15 tools, 1 prompt. Node ≥ 20, no build step.

Install

bash
npx openfoot-mcp

Set your API key in the environment. Free tier: 5,000 requests/month. Get a key at openfootapi.com/pricing.

Claude Desktop / Claude Code

json
{  "mcpServers": {    "openfoot": {      "command": "npx",      "args": ["-y", "openfoot-mcp"],      "env": { "OPENFOOT_API_KEY": "of_live_..." }    }  }}

Cursor / Windsurf / any stdio MCP client

Same block, in that client's MCP config file.

Tools

ToolWhat it returns
openfoot_competitionsSupported competitions, season metadata, data source and licence per competition
openfoot_searchFree-text team/competition name → stable IDs
openfoot_matchesFixtures and results, filtered by date / competition / team / status / season / round, cursor-paginated
openfoot_standingsStandings table for a competition and season
openfoot_match_lineupsStarting XI, bench, formation
openfoot_match_eventsGoals, cards, substitutions, commentary timeline
openfoot_match_xgOne entry per shot: pitch coordinates + xG value
openfoot_match_contextDerived context — form, head-to-head, pre-computed signals
openfoot_league_xgLeague xG table: xG for, xG against, over/under-performance vs actual goals
openfoot_oddsBookmaker benchmark + implied fair probabilities. Informational, not betting advice
openfoot_quotaRemaining monthly quota — this call does not consume quota
openfoot_healthReachability check. Works without an API key

Prompt: scout_team_form — resolve a team, pull its last 5 matches, read the xG behind the results.

Start with openfoot_search to resolve IDs. Guessing IDs wastes quota: 404s and empty results are metered like any other request.

Coverage, stated honestly

The catalogue lists 120 competitions. Depth is not uniform, and the catalogue is wider than the deep coverage.

  • Deepest: Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României
  • Expanded European: Eredivisie, Primeira Liga, Süper Lig, Pro League, Scottish Premiership
  • Historical / analytics only: Premier League, La Liga, Serie A, Ligue 1 (xG is Understat-derived)

Call openfoot_competitions and check your league before you build on it.

Quota behaviour

  • Free: 5,000 requests/month, 60 req/min. Developer $14/month: 250,000 requests/month, 100 req/min, includes xG, shot maps, lineups, live events and fair odds. Pro $39/month: 2,000,000/month, 250 req/min.
  • No overage billing. When the quota is spent the API returns 429; this server surfaces that as a quota_or_rate_limit error rather than an empty result.
  • Quota resets on the 1st of the month, UTC.
  • Every request is metered, including 404s and empty results.

When this is the wrong tool

  • High-frequency live polling across many competitions. A monthly quota is the wrong shape for it — a per-day or per-second plan elsewhere will cost you less.
  • Leagues outside the deep-coverage list above.
  • You need a contractual SLA, uptime credits or a named support contact. Not offered at these prices.

Development

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

npm run smoke works without an API key: openfoot_health returns live status, and a key-gated tool returns a readable missing_api_key error so you can tell "not configured" from "broken".

MIT.

來源：README.md，提交 2b70ef1

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分