A provenance-aware factual NFL data server for Model Context Protocol clients.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"nfl-data-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# NFL Data MCP A standalone, provenance-aware factual NFL data server for MCP clients and downstream analytics. In the default `auto` mode, the server retrieves missing or stale data from nflverse through `nflreadpy` and keeps a transparent local DuckDB cache. > **Public alpha:** tool contracts are usable, tested, and versioned, but may change > before 1.0. This project is independent and is not affiliated with the NFL. The factual v0.1 surface provides: - Canonical player search - Player profiles - Complete weekly player and team statistics across offense, defense, special teams, and miscellaneous categories - NFL schedules - Factual scoring events classified by offense, defense, or special teams - Teams, individual games, weekly rosters, injuries, depth charts, and snap counts - Player and team statistical leaderboards - Automatic on-demand retrieval with last-known-good fallback - Friendly team names and `current`/`upcoming`/`previous` season references - Multi-season cache retention - Cache, source, freshness, and as-of provenance - stdio transport Fantasy scoring, projections, rankings, ADP, recommendations, and league state are intentionally outside this package. ## Install The server requires Python 3.12. The simplest isolated installation uses [uv](https://docs.astral.sh/uv/): ```bash uv tool install nfl-data-mcp ``` This installs three commands: - `nfl-data-mcp` — start the MCP server over stdio - `nfl-data-sync` — optionally prefetch datasets - `nfl-data-doctor` — inspect the local cache Upgrade or remove it with: ```bash uv tool upgrade nfl-data-mcp uv tool uninstall nfl-data-mcp ``` The package is also available from [PyPI](https://pypi.org/project/nfl-data-mcp/). ## Connect an MCP client Configure an MCP client to launch the installed `nfl-data-mcp` executable. GUI applications often have a smaller `PATH` than your terminal, so use the absolute path printed by: ```bash command -v nfl-data-mcp ``` Example Claude Desktop entry: ```jso…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.