Searchable documentation across 32 football data providers and tools, built for AI coding agents. Covers club and provider APIs including StatsBomb, Wyscout, SportMonks, Impect, SkillCorner, Sportradar, Driblab, API-Football, ESPN, TheSportsDB, BeSoccer, FMDB Pro, TransferRoom, Opta, public/free sources and the Reep identity register, wearable and sports-science APIs (STATSports, Firstbeat Sports, Hawkin Dynamics, VALD), plus open-source libraries people build with too (kloppy, mplsoccer, socceraction, soccerdata, databallpy, floodlight, fast-forward, unravelsports, and more). Your agent resolves provider names, looks up the real docs, compares provider concepts, resolves football entities across provider IDs, finds, reads and quotes the papers and posts behind a method, and looks up checked metric definitions, instead of guessing from training data. Works with any MCP client.
Adds football-docs to the current Claude Code project.
claude mcp add football-docs -- npx -y football-docs@latest Use this when you want football-docs available across all Claude Code projects.
claude mcp add --scope user football-docs -- npx -y football-docs@latest Use this shape in clients that accept MCP server JSON config.
{
"mcpServers": {
"football-docs": {
"command": "npx",
"args": [
"-y",
"football-docs@latest"
]
}
}
} use football-docs to find where xT comes from. get_metric returns a card or one version, and 24 versions come with reference code tested on StatsBomb open data. Read more.resolve_entity follows merged Reep IDs to the survivor, keeps the provider IDs still attached to the merged ID, marks IDs a provider has retired or removed, and reports withdrawn IDs as withdrawn instead of unknown. It gives the same answers as the new reep Python package, reads the current Reep register layout, and maps venues too.search_papers searches OpenAlex, arXiv and SportRxiv, read_paper reads open-access papers in full, and match_quote confirms a quote actually appears in the source. get_web_source reads blog posts too: ask where xT comes from and it finds Karun Singh’s original post, shows it was online by February 2019 via the Wayback Machine, and quotes the sentence where he named it.add_local_paper, or point it at your Zotero library. football-docs never logs in anywhere on your behalf and only returns short passages from those papers. Paper text stays on your machine, and FOOTBALL_DOCS_PAPERS=off turns every paper and web request off.