football-docs 0.5.0 → 0.5.1

package/README.md

@@ -1,10 +1,10 @@
 # football-docs
 
-Searchable football data provider documentation for AI coding agents. Like [Context7](https://context7.com) for football data.
+Searchable football data provider and tooling documentation for AI coding agents. Like [Context7](https://context7.com) for football data.
 
-**Who it's for:** Developers and analysts who use AI coding tools (Claude Code, Cursor, VS Code Copilot, Windsurf) to work with football data. Works with any tool that supports MCP.
+**Who it's for:** Developers and analysts who use AI coding tools (Claude Code, Cursor, VS Code Copilot) to work with football data. Works with any tool that supports MCP.
 
-**What it does:** Gives your AI agent a searchable index of documentation for 15 football data providers — event types, qualifier IDs, coordinate systems, API endpoints, data models, identity surfaces, and cross-provider comparisons. Your agent looks up the real docs instead of guessing from training data.
+**What it does:** Gives your AI agent a searchable index of documentation for 15 football data providers and tools — event types, qualifier IDs, coordinate systems, API endpoints, data models, identity surfaces, and cross-provider comparisons for the data providers (StatsBomb, Opta, Wyscout, Impect, SkillCorner, and more), plus the open-source libraries people build with (kloppy, mplsoccer, socceraction, soccerdata, and more). Your agent looks up the real docs instead of guessing from training data.
 
 **Why not just let the AI figure it out?** LLMs get football data specifics wrong constantly — Opta qualifier IDs, StatsBomb coordinate ranges, API endpoint URLs, library method signatures. These are mutable facts that change across versions. football-docs gives the agent verified, sourced documentation with provenance tracking so you know where every answer came from.
 
@@ -58,21 +58,6 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
-### Windsurf
-
-Add to `~/.codeium/windsurf/mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "football-docs": {
-      "command": "npx",
-      "args": ["-y", "football-docs"]
-    }
-  }
-}
-```
-
 ### Claude Desktop
 
 Add to `claude_desktop_config.json`:
@@ -127,7 +112,7 @@ Add to `claude_desktop_config.json`:
 | Soccerdonna | 7 | identity-surfaces |
 | Transfermarkt | 7 | identity-surfaces |
 
-**968 searchable chunks** across 15 providers.
+**968 searchable chunks** across 15 providers and tools.
 
 ## Contributing
 
@@ -139,17 +124,6 @@ Contributions are welcome from everyone. There are three ways to help:
 
 **You don't need to be an expert.** See **[CONTRIBUTING.md](CONTRIBUTING.md)** for the full guide.
 
-### What we especially need
-
-| Provider | Priority | Source material to start from |
-|----------|----------|-------------------------------|
-| FPL (Fantasy Premier League) | High | [FPL APIs Explained](https://www.oliverlooney.com/blogs/FPL-APIs-Explained) |
-| API-Football (RapidAPI) | High | [API-Football docs](https://www.api-football.com/documentation-v3) |
-| Football-data.org | Medium | [Football-data.org docs](https://www.football-data.org/documentation/api) |
-| TheSportsDB | Medium | [TheSportsDB API](https://www.thesportsdb.com/api.php) |
-| WhoScored | Medium | Based on Opta F24, community-documented |
-| Sofascore | Medium | Unofficial API, community-documented |
-
 ## For maintainers
 
 ### Crawl pipeline

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "football-docs",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Searchable football data provider documentation for AI coding agents. Like Context7 for football data.",
   "type": "module",
   "mcpName": "io.github.withqwerty/football-docs",

package/providers.json

@@ -150,33 +150,6 @@
       ],
       "last_crawled": null
     },
-    "api-football": {
-      "description": "REST API for football data via RapidAPI (fixtures, standings, players, live scores)",
-      "version": "3",
-      "package": null,
-      "sources": [
-        { "url": "https://www.api-football.com/documentation-v3", "type": "api_docs" }
-      ],
-      "last_crawled": null
-    },
-    "football-data-org": {
-      "description": "REST API for football competition data (v4) — fixtures, standings, teams, players",
-      "version": "4",
-      "package": null,
-      "sources": [
-        { "url": "https://docs.football-data.org/general/v4/index.html", "type": "api_docs" }
-      ],
-      "last_crawled": null
-    },
-    "fpl": {
-      "description": "Fantasy Premier League unofficial API — player stats, fixtures, gameweeks, transfers",
-      "version": null,
-      "package": null,
-      "sources": [
-        { "type": "curated", "note": "Unofficial undocumented API; compiled from community sources" }
-      ],
-      "last_crawled": null
-    },
     "floodlight": {
       "description": "Python library for spatial football data analysis (tracking, pitch control, metrics)",
       "version": null,
@@ -187,26 +160,6 @@
       ],
       "last_crawled": null
     },
-    "thesportsdb-v1": {
-      "description": "TheSportsDB v1 API — free tier, search-based endpoints for teams, players, events, livescores",
-      "version": "1",
-      "package": null,
-      "sources": [
-        { "url": "https://www.thesportsdb.com/api/spec/v1/openapi.yaml", "type": "openapi" },
-        { "url": "https://www.thesportsdb.com/documentation", "type": "api_docs" }
-      ],
-      "last_crawled": null
-    },
-    "thesportsdb-v2": {
-      "description": "TheSportsDB v2 API — paid tier, expanded endpoints with schedules, statistics, lookups",
-      "version": "2",
-      "package": null,
-      "sources": [
-        { "url": "https://www.thesportsdb.com/api/spec/v2/openapi.yaml", "type": "openapi" },
-        { "url": "https://www.thesportsdb.com/documentation", "type": "api_docs" }
-      ],
-      "last_crawled": null
-    },
     "free-sources": {
       "description": "Free football data sources (FBref, Understat, ClubElo, football-data.co.uk)",
       "version": null,