football-docs MCP
An MCP server searching documentation of 31 football data providers: StatsBomb, Opta, Wyscout and more. Context7 for football.
- 226 ★ on the repository
- Last commit
Minimal access
Why this level
- The server reads a local documentation index, and requests go to the external Reep register only when a key is configured.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/football-docsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The server reads a local documentation index, and requests go to the external Reep register only when a key is configured.
This is third-party code. Review the repository files before installing.
What it does
football-docs gives an agent a documentation index for 31 football data providers and tools: event types, qualifier IDs, coordinate systems, API endpoints, data models and comparisons between providers. The index covers data providers (StatsBomb, Opta, Wyscout, Impect, SkillCorner, Sportradar, TheSportsDB and others), open-source libraries (kloppy, mplsoccer, socceraction, soccerdata, floodlight) and sports-science APIs (STATSports, Firstbeat, Hawkin Dynamics, VALD). The agent searches real documentation with the source and version shown instead of guessing from training data: Opta qualifier IDs, StatsBomb coordinate ranges and method signatures change between versions. Tools: `search_docs`, `resolve_provider_id`, `get_provider_docs`, `list_providers`, `compare_providers`, `request_update` and `resolve_entity`, which maps a player, team or match to its IDs at each provider through the Reep register. The server starts with `npx -y football-docs` on Node.js 22.13 or newer and uses built-in SQLite with no native module build.
Who it is for. Analysts and developers who build football analytics with Claude Code, Cursor or VS Code Copilot and work with data from several providers.
Good fit when
- You need to know how Opta encodes event qualifiers without relying on model memory.
- You want to compare how StatsBomb and Wyscout describe pitch coordinates.
- A player has to be matched to IDs at different providers.
- A method signature is checked before a kloppy or mplsoccer script.
Not a fit when
- You need the match data itself: the server serves documentation and not events or statistics.
- You work with a provider outside the index: there will be no answer and the server will say so.
- The agent does not support MCP.
Example request
Using football-docs find how Opta encodes the pass event type and the pass length qualifiers and cite the source.MCP
- Transport
- stdio
- Authentication
- not required
Environment variables
REEP_API_KEYsecret- Reep API key for the resolve_entity tool when there is no local copy of the register.
REEP_DUCKDB_PATH- Path to a local copy of the free Reep register.
Limitations
The server serves documentation and reference facts, while match and event data has to come from the providers themselves. `resolve_entity` needs a local copy of the free Reep register (`REEP_DUCKDB_PATH`) or a `REEP_API_KEY`, which is issued by hand on request. Node.js 22.13 or newer is required. After an update through `npx` an already running server stays on the old version until reconnected (in Claude Code with `/mcp`). No license file was found in the repository. The last commit dates from November 2026.
How to disable. Run `claude mcp remove football-docs` or delete the `football-docs` entry from the Cursor, VS Code or Claude Desktop configuration and restart the agent.
FAQ
How do I connect football-docs to Claude Code?
Run `claude mcp add football-docs -- npx -y football-docs`. Node.js 22.13 or newer is required.
Which providers are indexed?
31 providers and tools: StatsBomb, Opta, Wyscout, Impect, SkillCorner, Sportradar, TheSportsDB, the kloppy, mplsoccer and socceraction libraries and the STATSports, Firstbeat and VALD APIs.
What if a provider is not indexed?
Call `request_update`: the request is queued locally and points to the matching GitHub issue template.
Where do the answers come from?
From the indexed documentation with the source and version, so you can see where each answer comes from.
How do I update the server?
`npx` updates its cache itself, and a running server has to be reconnected: in Claude Code with `/mcp`.
Discussion
No questions or reviews yet.
Related
MCP serversA Python skill and package that turn a WhoScored match URL into a report with pass maps, shot maps, xG and player dashboards.
An agent queries GreptimeDB metrics, logs and traces with SQL, TQL and RANGE, with write protection and data masking
A single-binary MCP server for MySQL, MariaDB, PostgreSQL and SQLite: read-only by default, with optional PII redaction
One MCP server for SQLite, SQL Server, PostgreSQL and MySQL: read and change data, edit schemas and export to CSV and JSON
Official Couchbase MCP server: the agent inspects schemas, finds documents and builds SQL++, read-only by default
A lightweight database workspace with an MCP server: the agent reads the schema, runs queries and explores data in PostgreSQL, MySQL and more
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| football-docs (this card) | no | not required | 226 | |
| Context7 | yes | API key | 64,656 | Context7 indexes general-purpose library documentation, while football-docs specializes in football data providers and tools. |
| football-match-report | no | 120 | football-match-report builds match reports, while football-docs serves documentation on provider data formats. |
README in short
A documentation index for 31 football data providers for agents: event types, coordinates, APIs, provider comparison and ID mapping.