Server data from the Official MCP Registry
Football fixtures, standings, lineups, live events and shot-level xG across 75 competitions.
About
Football fixtures, standings, lineups, live events and shot-level xG across 75 competitions.
Security Report
Valid MCP server (4 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: OPENFOOT_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-bartokulus-openfoot-mcp": {
"env": {
"OPENFOOT_API_KEY": "your-openfoot-api-key-here"
},
"args": [
"-y",
"openfoot-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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.
12 tools, 1 prompt. Node ≥ 20, no build step.
Install
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
{
"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
| Tool | What it returns |
|---|---|
openfoot_competitions | Supported competitions, season metadata, data source and licence per competition |
openfoot_search | Free-text team/competition name → stable IDs |
openfoot_matches | Fixtures and results, filtered by date / competition / team / status / season / round, cursor-paginated |
openfoot_standings | Standings table for a competition and season |
openfoot_match_lineups | Starting XI, bench, formation |
openfoot_match_events | Goals, cards, substitutions, commentary timeline |
openfoot_match_xg | One entry per shot: pitch coordinates + xG value |
openfoot_match_context | Derived context — form, head-to-head, pre-computed signals |
openfoot_league_xg | League xG table: xG for, xG against, over/under-performance vs actual goals |
openfoot_odds | Bookmaker benchmark + implied fair probabilities. Informational, not betting advice |
openfoot_quota | Remaining monthly quota — this call does not consume quota |
openfoot_health | Reachability 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 75 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, 15 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_limiterror 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 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.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption