Openfoot MCP server
io.github.bartokulus/openfoot-mcp·v0.1.2Football fixtures, standings, lineups, live events and shot-level xG across 75 competitions.
0 stars38 downloads/wk
Reviews
Write oneNobody has reviewed Openfoot yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Openfoot tools (12)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
openfoot_competitionsList the competitions OpenFootAPI supports, with IDs, country codes, tiers and provider coverage. Use this first when you need a valid competition ID.
openfoot_healthCheck the operational status of OpenFootAPI without authentication.
openfoot_league_xgSeason-level Expected Goals analytics for a league — teams ranked by xG generated, xG conceded, over/underperformance vs real goals, and shot efficiency.
openfoot_match_contextA complete pre-match or post-match dossier assembled for analysis: recent form, Elo delta, rest days, head-to-head record and model-derived fair match probabilities.
openfoot_match_eventsTimeline of events in a match: goals, assists, yellow/red cards, substitutions, VAR checks, plus live minute-by-minute text commentary.
openfoot_match_lineupsConfirmed starting XI, benches and formations for a match.
openfoot_match_xgShot-level Expected Goals data with coordinates on the pitch, shot type, situation (open play, penalty, corner), outcome and cumulative xG.
openfoot_matchesList fixtures and results with scores, kickoff times, status and teams. Filter by competition, team, status, date or season.
openfoot_oddsFair 1X2 and over/under 2.5 probabilities derived from underlying team form, Elo delta and xG performance.
openfoot_quotaCheck your API key's tier, monthly request allowance, requests used this month and reset date.
openfoot_searchSearch for teams or competitions by fuzzy name to find their canonical OpenFootAPI IDs.
openfoot_standingsGet the league table for a competition — rank, points, played, won, drawn, lost, goals for/against, goal difference and recent form.
Public scan report
scanner v0.1.10 · 2026-10-29 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 52 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How Openfoot compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 45% of 48,243 servers
- Tools
- 12
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 38
- more than 28% of 12,306 servers with a package
What its tools let an agent do: 12 create
Install Openfoot in Claude Code, Cursor or VS Code
Runs npx -y openfoot-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add openfoot-mcp -- npx -y openfoot-mcp
What the publisher says
From the Openfoot repository's README, as published. We do not edit it. Read it on GitHub
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
npx openfoot-mcpSet your API key in the environment. Free tier: 5,000 requests/month. Get a key at openfootapi.com/pricing.
Claude Desktop / Claude Code
{
"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
Prompt: scoutteamform — resolve a team, pull its last 5 matches, read the xG behind the results.
Start with openfootsearch** 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 quotaorrate_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
npm install
npm run smoke # boots the server over stdio, lists tools, calls healthnpm run smoke works without an API key: openfoothealth returns live status, and a key-gated tool returns a readable missingapi_key error so you can tell "not configured" from "broken".
MIT.
Nothing above is checked by us. What we check is on the safety report.
Openfoot: common questions
- Is Openfoot MCP server safe?
- Mostly: it is graded B (75/100). Read the Openfoot safety report
- How do I install Openfoot?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Openfoot need an API key?
- Yes. The registry entry asks for
OPENFOOT_API_KEY. - Is Openfoot maintained?
- The last commit was 59 days ago (2026-09-07). The latest release is v0.1.2.
- What can I use instead of Openfoot?
- Servers from other publishers that do the same job: Jitsu MCP server.
- How does Openfoot compare with other MCP servers?
- safety score 75/100 (higher than 45% of 48,243 servers); tools 12 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Openfoot
Same job from other publishers: the closest match first, then the best rated.
- JitsuManage Jitsu data pipelines: destinations, streams, connections, functions, live events.not reviewedEstablishedA