Footballcharts MCP server
online · 100% uptimeio.github.ddevetak/footballcharts-mcp·v0.5.0·6 starsTables, results, fixtures, goal timing, season projections: 93 football leagues incl. lower tiers
6 stars54 downloads/wk
Reviews
Write oneNobody has reviewed Footballcharts yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Footballcharts tools (10)
write = sends, deletes, buys or postsabout_football_chartsFreeReturns a summary of the football-charts.com source: the leagues and data it covers (93 leagues, including lower divisions), what it does not hold (live scores, player data, bookmaker odds), the league-key and season-string formats, how the model probabilities are produced, and the free-tier limits. No parameters.
get_fixturesFreeReturns the upcoming matches of one league, earliest first: kick-off date and time, teams, a match slug, and the model's calibrated probabilities (home and away win, over/under goal lines, both teams to score, half-time lines; the draw probability is 1 - home - away) with team attack and defence ratings. The probabilities come from a baseline statistical model of past results (no injuries, motivation or weather) and are not bookmaker prices.
get_goal_timingFreeReturns goals per 15-minute period (0-15 to 90+) for every team in one league season, with each team's peak period or periods (ties are listed together), share of late goals and share of first-half goals, plus league totals and the league's most active period. team limits the result to teams whose name contains the given text.
get_league_tableFreeReturns the standings of one league season: one row per team with position, played, wins, draws, losses, goals, points and last-five form, plus expected points and a luck category (how far results run ahead of or behind the underlying performance). view='luck' orders the same rows by over- or under-performance and view='goals' by goals scored; the default orders by points. Without a season, returns the current season.
get_matchFreeReturns one match in full, identified by its slug ('country/league-slug/YYYY-MM-DD-home-vs-away', as listed in the slug field of upcoming fixtures): the complete model probability block (calibrated and raw), team ratings, first-goal-time histograms for both sides, recent form and, once played, the score, half-time score and status.
get_resultsFreeReturns the finished matches of one league season in chronological order: date, teams, full-time and half-time score, first-goal minute and a goalless flag. team keeps the matches where either side's name contains the given text (case-insensitive); last=N keeps only the N most recent matches. Contains no odds.
get_season_projectionFreeReturns how one league's current season is projected to finish, from 10,000 Monte Carlo simulations refreshed daily: for each team the probabilities of winning the title, finishing in the top four and finishing in the bottom three, current points, mean final points, a 10th-90th percentile points range, a finishing-position matrix, and the change since the previous run. Covers the current season only; returns a note when no projection exists for the league yet.
get_teamFreeReturns one team's season in one league: its table row (with expected points and luck category), the full match log (date, opponent, home or away, score, half-time score, first-goal minute, outcome), goals per 15-minute period, the first-goal distribution, and season averages of match statistics (shots, shots on target, possession, corners, xG) where the league has them. team is a lower-case slug with hyphens, e.g. 'arsenal' or 'manchester-city'.
get_track_recordFreeReturns the public calibration record of the model: every probability published before kick-off and scored after the result, with count, hit rate, Brier score and reliability buckets (predicted probability against observed frequency), overall and by question type (match result, total goals over 2.5 and 3.5, half-time goals over 1.5, both teams to score), plus the 50 most recent scored predictions. Misses are included. days sets the lookback window (default 90).
list_leaguesFreeReturns every league covered (93 across 42 countries) with its league key, display name, country and the seasons available, newest first. Other tools take these league keys and season strings. Season format depends on the competition: '2026-2027' for winter-calendar leagues, '2026' for summer-calendar leagues. No parameters.
Public scan report
scanner v0.1.10 · 2026-10-16 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- Live reliabilityremote reachable in 1587ms20/20
- Tool poisoning10 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Footballcharts compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 93/100
- higher than 95% of 48,243 servers
- Tools
- 10
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 418 ms
- faster than 39% of 30,027 servers
- GitHub stars
- 6
- more than 85% of 28,706 servers
- Downloads a week
- 54
- more than 43% of 12,306 servers with a package
What its tools let an agent do: 10 read
Install Footballcharts in Claude Code, Cursor or VS Code
claude mcp add --transport http footballcharts-mcp https://mcp.football-charts.com/mcp
What the publisher says
From the Footballcharts repository's README, as published. We do not edit it. Read it on GitHub
Football data MCP server — 93 leagues, lower divisions included (Football Charts)
Give your AI assistant football data for 93 leagues — 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 settled track record — not betting tips. Every model signal is published before kickoff and graded after; the gettrackrecord tool returns that ledger.
No key needed
Every tool works without an API key at 300 requests/day per IP (20/min). A free key lifts that to 5,000/day, 60/min — get one in seconds:
curl -X POST https://footballcharts-backend.onrender.com/api/v1/keys/register/ \
-H 'Content-Type: application/json' \
-d '{"email":"you@example.com"}'The key (fc...) is shown once — store it. Both tiers: all 93 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/mcpThat is the keyless tier. With a key, paste https://mcp.football-charts.com/fcyourkeyhere/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-.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
claudedesktopconfig.json (FCAPIKEY 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-mcpTools
Ten read-only tools. Descriptions are written for the model: when to use it, what comes back, one example. aboutfootballcharts needs no key.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Footballcharts: common questions
- Is Footballcharts MCP server safe?
- Yes, by our scan: it is graded A (93/100). Read the Footballcharts safety report
- How do I install Footballcharts?
- It runs remotely at mcp.football-charts.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Footballcharts need an API key?
- Yes. The registry entry asks for
FC_API_KEY. - Is Footballcharts maintained?
- The last commit was 20 days ago (2026-10-16). The latest release is v0.5.0.
- Is Footballcharts up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Footballcharts compare with other MCP servers?
- safety score 93/100 (higher than 95% of 48,243 servers); tools 10 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.