nutmeg

nutmeg

IN BETA!
Football data analytics for AI coding tools

Makes your AI agent an expert at football data. It looks up the real docs instead of guessing — qualifier IDs, coordinate systems, API endpoints, method signatures. All verified, all sourced.

Get started

Answer two questions and we'll show you exactly what to install.

What AI coding tool do you use?
What do you want?
Start here
/nutmeg
Describe what you want — it handles the rest
/nutmeg-learn
Concepts, resources, provider docs
Sub-skills auto-dispatched or called directly
/nutmeg-acquire
Fetch and download football data
/nutmeg-wrangle
Transform and reshape data
/nutmeg-compute
Derived metrics (xG, PPDA...)
/nutmeg-analyse
Explore and interpret data
/nutmeg-brainstorm
Visualisation ideation
/nutmeg-review
Check data code and charts
/nutmeg-store
Storage and publishing
/nutmeg-heal
Fix broken scrapers and pipelines
Providers
ProviderEventsStatsxGFree?
StatsBomb Open data
Opta
Wyscout
SportMonks Free tier
FBref
Understat

football-docs

football-docs

IN BETA!
Like Context7 for football data

Searchable documentation for 16 football data providers, built for AI coding agents. Your agent looks up the real docs instead of guessing from training data. Works with any tool that supports MCP.

640
searchable chunks
16
providers
4
MCP tools
Install
Claude Code
claude mcp add football-docs -- npx -y football-docs
Any MCP client
npx -y football-docs
Tools
search_docs
Full-text search across all providers
list_providers
See all indexed providers
compare_providers
Compare how providers handle concepts
request_update
Flag outdated docs or request new ones
Example queries
Indexed providers
StatsBomb
143 chunks
kloppy
100 chunks
SportMonks
71 chunks
databallpy
63 chunks
mplsoccer
62 chunks
Wyscout
61 chunks
Free sources
45 chunks
soccerdata
40 chunks
Opta
29 chunks
socceraction
26 chunks

campos banner

campos

IN BETA!
React components for football, typed and agent-native

23 React chart components, 10 data-provider adapters, one canonical coordinate frame, zero-config defaults. Typed from schema to render. Every chart is agent-discoverable via a static JSON registry at campos.withqwerty.com/r/ — nutmeg proposes and composes campos charts automatically when it detects a React project. Docs and live demos at campos.withqwerty.com.

23
chart components
10
data adapters
2333
tests
5
npm packages
Live docs and registry
Examples all generated by AI agents using campos
Install
pnpm
pnpm add @withqwerty/campos-react @withqwerty/campos-adapters @withqwerty/campos-schema @withqwerty/campos-stadia
npm
npm install @withqwerty/campos-react @withqwerty/campos-adapters @withqwerty/campos-schema @withqwerty/campos-stadia
Components
ShotMap
Half-pitch xG map with body-part shapes
PassMap
Individual pass arrows with completion
PassNetwork
Average-position network with edges
XGTimeline
Match cumulative xG step chart
Formation
Lineup card with 68 supported shapes
RadarChart
Scouting radar with comparison polygons
Heatmap
Binned event density grid
KDE
Kernel-density pitch surface
PassFlow
Zonal pass-flow arrows
PassSonar
Polar pass-direction surfaces
PizzaChart
Percentile pizza chart
ScatterPlot
Scouting scatter with quadrants
… + 11 more
Beeswarm, BumpChart, CometChart, Territory, SmallMultiples, StatBadge, etc.
Quick example
import { ShotMap } from "@withqwerty/campos-react"; import { fromStatsBomb } from "@withqwerty/campos-adapters"; const shots = fromStatsBomb.shots(rawEvents, matchInfo); export default function Match() { return <ShotMap shots={shots} />; }
Drives from nutmeg, automatically

When nutmeg detects a React project (package.json contains react or @withqwerty/campos-react), it loads a shared bridge doc, fetches the registry above, and proposes campos charts with real capability data per provider. Chart output, adapter selection, and recipe suggestion all route through the live catalogue — no hallucinated props, no training-data drift. See nutmeg on GitHub for the bridge reference.

Start building with football data

Install in 30 seconds. Your AI agent becomes a football data expert.

/plugin marketplace add withqwerty/plugins /plugin install nutmeg@withqwerty