Plug Onside into your stack

Name: onside-football-mcp
Author: Onside

Two ways in: an MCP server so your Claude/Cursor assistant can query the model directly, and a plain JSON API for everything else. Free, open, attribution-only. No API key, no rate limit (yet).

MCP server

CLAUDE DESKTOP · CURSOR · WINDSURF

onside-football-mcp is a Model Context Protocol server that lets any MCP-compatible AI assistant query Onside's model directly. Ask Claude "who wins World Cup 2026?" and it'll call our Monte Carlo simulator and answer with citations.

Install in Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "onside-football": {
      "command": "npx",
      "args": ["-y", "onside-football-mcp"]
    }
  }
}

Install in Cursor

Settings → MCP → Add new MCP server → paste the same config.

Manual install

npm install -g onside-football-mcp
onside-football-mcp

Tools the MCP exposes

TOOL	WHAT IT DOES	EXAMPLE ARGS
get_wc_match_prediction	Win-probability split (home / draw / away) for any matchup	home=eng away=cro
get_wc_champion_odds	Top-N champion probabilities from the Monte Carlo simulator	limit=8
get_wc_team_info	Full nation profile: group, fixtures, PL footprint, model rating	code=eng
get_wc_fixtures	Filtered fixtures by team / group / stage / date range	team=eng stage=group
get_wc_fantasy_picks	FIFA WC Fantasy captain / differential / value picks per matchday	matchday=1 category=captain
get_wc_upset_watch	Matches the model flags as upset candidates	limit=5
get_wc_live_scores	Currently in-play matches + next kickoff fallback	(no args)
compare_wc_teams	Head-to-head model + PL footprint diff between two nations	teamA=arg teamB=fra

npm: onside-football-mcp ↗GitHub ↗

JSON API

v1 · CORS-ENABLED · NO AUTH

Same data the MCP server uses — just plain HTTP. All endpoints return JSON, all responses include an attribution object pointing back to the relevant onsidearena.com page. CORS is open (Access-Control-Allow-Origin: *), caching is server-side (typically 5min via Cache-Control: public, max-age=300).

ENDPOINT	WHAT IT RETURNS
/api/v1	Self-describing API index
/api/v1/wc/predict	Match prediction (?home=...&away=...)
/api/v1/wc/champions	Top-N champion probabilities (?limit=N)
/api/v1/wc/team/[code]	Full team info + group fixtures
/api/v1/wc/fixtures	Filtered fixtures
/api/v1/wc/fantasy	Fantasy picks (?matchday=N&category=captain\|differential\|value)
/api/v1/wc/upsets	Upset watchlist (?limit=N)
/api/v1/wc/live	Live + recent + next kickoff

Try it: /api/v1/wc/predict?home=eng&away=cro · /api/v1/wc/champions?limit=8

CSV downloads

FOR ANALYSTS · CC-BY-4.0

Prefer a spreadsheet? Three CSVs cover the public dataset surface — predictions, champion board, full schedule. Linked + schema-tagged on the /data hub.

PREDICTIONS.CSV

72 group fixtures · 15 cols

License + contact

MCP server code: MIT. Data: CC-BY-4.0 — free for any use, attribution required. Commercial / high-volume use: get in touch at [email protected].

Built something on top of this? We'd love to feature it. Tweet @onsidearena.