Football data MCP server — 98 leagues, lower divisions included (Football Charts)

English · 简体中文 (Simplified Chinese)

Give your AI assistant football data for 98 leagues (across 44 countries) — including the lower divisions other sources skip: tables, results, fixtures, goal timing, a public baseline model and Monte Carlo season projections from football-charts.com.

FC publishes probabilities and a public calibration record — not betting tips. Every model probability is published before kickoff and scored after; the get_track_record tool returns that record (hit rate, Brier score, reliability buckets).

No key needed

Every tool works without an API key at 100 requests/day per IP (20/min). A free key, for personal use, lifts that to 200/day, 60/min (all keys on one email address count together) — get one in seconds:

curl -X POST https://footballcharts-backend.onrender.com/api/v1/keys/register/ \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]"}'

The key (fc_...) is shown once — store it. Both tiers: all 98 leagues (top and lower divisions, women's leagues), current + previous season, model probabilities and daily 10,000-run Monte Carlo projections, no betting odds (the historical odds archive is a paid dataset at football-charts.com/data).

Use it on claude.ai (web or mobile) — nothing to install

Settings → Connectors → Add custom connector, then paste:

https://mcp.football-charts.com/mcp

That is the keyless tier. With a key, paste https://mcp.football-charts.com/fc_your_key_here/mcp instead (a connector field accepts only a URL, so the key travels in it; keys are read-only, free and replaceable). Clients that can send headers use POST https://mcp.football-charts.com/mcp with Authorization: Bearer fc_….

Use with Claude Desktop — one-click extension

Download footballcharts-mcp-<version>.mcpb from the latest release and open it; Claude Desktop installs it. The API key field can stay empty.

Use with Claude Desktop — manual config

claude_desktop_config.json (FC_API_KEY is optional since 0.4.0):

{
  "mcpServers": {
    "football-charts": {
      "command": "npx",
      "args": ["-y", "footballcharts-mcp"],
      "env": { "FC_API_KEY": "fc_your_key_here" }
    }
  }
}

Use with Claude Code

claude mcp add football-charts -e FC_API_KEY=fc_your_key_here -- npx -y footballcharts-mcp

Tools

Ten read-only tools. Each description says what the tool returns.

tool	use it for
about_football_charts	Summary of the source: leagues covered, what it does not hold, league-key and season formats, how to read the probabilities.
list_leagues	Every league covered (98 across 44 countries) with its key, country and seasons available.
get_league_table	Standings for one league season with form, expected points and a luck category; view=luck or goals for alternative rankings.
get_results	Finished matches of one league season with full-time and half-time scores and first-goal minute; filter by team, keep the latest N with last.
get_fixtures	Upcoming matches of one league with the model's calibrated probabilities.
get_match	One match in full, by slug: model probabilities, team ratings and goal-timing histograms.
get_season_projection	Title, top-four and bottom-three probabilities and points ranges from 10,000 simulations, refreshed daily.
get_team	One team's season: table row, match log, goals per 15-minute period and first-goal distribution.
get_goal_timing	Goals per 15-minute period for every team in a league season, with peak periods and league totals; pass team for one team.
get_track_record	The model's public calibration record: hit rate, Brier score and reliability buckets.

The model is a public baseline (Dixon-Coles). It is calibrated, and get_track_record shows how well; it does not beat the bookmaker market. Per-bookmaker opening and closing odds for 91 leagues, 2020 onward, are a paid dataset at football-charts.com/data.

This is the beginning of the README. Read the rest at the original. Read the full README ↗