MCP Server
footballcharts-mcp
io.github.ddevetak/footballcharts-mcp
What this MCP does
Provides football league tables, fixtures, results, team statistics, goal timing, season projections, probabilities, and model calibration records.
Capabilities
Tools
10
tools
about_football_charts
About this source
What football-charts.com covers (93 leagues incl. lower divisions), what it does NOT hold (live scores, players, odds), how league keys and season strings work, how to phrase model probabilities honestly, and which tool answers what. Call when unsure whether this source fits a question, or once before the first call in a session. No parameters. Example: "Can you get me Estonian league data?" â about_football_charts, then list_leagues.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['what', 'use_this_source_when', 'do_not_use_for', 'how_to_answer_well', 'free_tier', 'get_a_key', 'tools'], 'properties': {'what': {'type': 'string'}, 'tools': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'free_tier': {'type': 'string'}, 'get_a_key': {'type': 'string'}, 'do_not_use_for': {'type': 'array', 'items': {'type': 'string'}}, 'how_to_answer_well': {'type': 'array', 'items': {'type': 'string'}}, 'use_this_source_when': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}
get_fixtures
Upcoming fixtures
Upcoming matches of one league, earliest first: kick-off date and time, teams, a slug, and the model's calibrated probabilities (home/away, over/under ladders, both teams to score, half-time lines; draw = 1 â home â away) with team attack/defence ratings. Use for "who plays this weekend", kick-off times, or the chances in an upcoming match. The slug on each row is the input to get_match, which returns one fixture in full â call this first when you need one match in depth. Use get_results for matches already played. Probabilities are a baseline model from match history alone (no injuries, motivation or weather) and are not market prices or advice â say so. Example: "What are the chances of goals in Brentford v Sunderland?" â get_fixtures premier, read model_predictions.dc_v2.calibrated["over_2.5"].
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['league'], 'properties': {'league': {'type': 'string', 'description': "League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'count': {}, 'league': {}, 'matches': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'home_team', 'away_team'], 'properties': {'slug': {'type': 'string', 'description': 'Input to get_match'}, 'time': {'$ref': '#/properties/league'}, 'league': {'$ref': '#/properties/league'}, 'status': {'$ref': '#/properties/league'}, 'country': {'$ref': '#/properties/league'}, 'away_team': {'type': 'string'}, 'home_team': {'type': 'string'}, 'match_date': {'$ref': '#/properties/league'}, 'real_league_name': {'$ref': '#/properties/league'}, 'model_predictions': {'anyOf': [{'type': 'object', 'properties': {'dc_v2': {'anyOf': [{'type': 'object', 'properties': {'model': {'$ref': '#/properties/league'}, 'calibrated': {'anyOf': [{'type': 'object', 'properties': {'away': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'home': {}, 'btts_yes': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_0.5': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_1.5': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_2.5': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_3.5': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_4.5': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'ht_over_0.5': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'ht_over_1.5': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'expected_ht_goals': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'expected_away_goals': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'expected_home_goals': {'$ref': '#/properties/matches/anyOf/0/items/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}}, 'description': 'Probabilities 0â\x80\x931. The draw is NOT a field: draw = 1 â\x88\x92 home â\x88\x92 away.', 'additionalProperties': True}, {'type': 'null'}], 'description': 'Use these. Calibrated on settled matches.'}, 'computed_at': {'$ref': '#/properties/league'}, 'data_through': {'$ref': '#/properties/league', 'description': 'Last match date the model has seen'}}, 'additionalProperties': True}, {'type': 'null'}]}}, 'additionalProperties': True}, {'type': 'null'}]}}, 'additionalProperties': True}}, {'type': 'null'}]}, 'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}}, 'additionalProperties': True}
get_goal_timing
Goal timing
Goals per 15-minute bin (0-15 ⦠90+) for every team in a league season, each with peak_bins (the bin or bins with most goals â ties are listed; report a tie as a tie), late_share_pct and first_half_pct, plus league totals and the most active period. Use for "when does X score", late goals, fast starters, who concedes early, or which period a league's goals fall in. Pass team (name substring) for one team only. For one team's timing next to its match log get_team is more direct. Answer from peak_bins, never by eyeballing the bins. Example: "When does Flamengo score most?" â get_goal_timing brazil1, team="Flamengo".
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['league'], 'properties': {'team': {'type': ['string', 'null'], 'description': "Team name substring, e.g. 'Flamengo' â\x80\x94 returns that team's row only"}, 'league': {'type': 'string', 'description': "League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name."}, 'season': {'type': 'string', 'description': "Season string exactly as list_leagues returns it: winter-calendar leagues look like '2026-2027', summer-calendar leagues (Brazil, Sweden, Norway, Japanâ\x80¦) like '2026'. Omit for the current season. The free tier serves the current and previous season only."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'data': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['team'], 'properties': {'bins': {'anyOf': [{'type': 'object', 'additionalProperties': {'type': 'number'}}, {'type': 'null'}], 'description': "Goals per bin: '0-15','15-30','30-45','45+','46-60','60-75','75-90','90+'"}, 'team': {'type': 'string'}, 'total': {'$ref': '#/properties/stats/anyOf/0/properties/total_goals'}, 'peak_bins': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'description': 'Bin(s) with most goals â\x80\x94 ties are listed; report a tie as a tie'}, 'peak_goals': {'$ref': '#/properties/stats/anyOf/0/properties/total_goals'}, 'first_half_pct': {'$ref': '#/properties/data/anyOf/0/items/properties/late_share_pct'}, 'late_share_pct': {'description': '% of goals from 75â\x80² on'}}, 'additionalProperties': True}}, {'type': 'null'}]}, 'note': {'$ref': '#/properties/league'}, 'stats': {'anyOf': [{'type': 'object', 'properties': {'late_goals': {'$ref': '#/properties/stats/anyOf/0/properties/total_goals'}, 'match_count': {'$ref': '#/properties/stats/anyOf/0/properties/total_goals'}, 'total_goals': {}, 'most_active_period': {'$ref': '#/properties/league'}}, 'additionalProperties': True}, {'type': 'null'}]}, 'league': {}, 'season': {'$ref': '#/properties/league'}, 'time_bins': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}, 'team_filter': {'$ref': '#/properties/league'}, 'team_not_found': {'$ref': '#/properties/league'}}, 'additionalProperties': True}
get_league_table
League table
Standings for one league season: one row per team with position, played, W/D/L, goals, points, last-five form, plus expected points and a luck category (how far results run ahead of or behind the underlying numbers). Use for "who is top", "how many points", "what is the form", or any question about the table as ranked by points. view="luck" re-orders the same rows by over/under-performance (who is lucky, unlucky, flattered by the table); view="goals" by scoring. For one team in depth use get_team; for how the season is projected to END use get_season_projection. Omit season for the current one. Example: "Is Hull really a top-four side?" â get_league_table premier, view=luck, compare points with expected_points.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['league'], 'properties': {'view': {'anyOf': [{'enum': ['classic', 'luck', 'goals'], 'type': 'string'}, {'type': 'null'}], 'description': "Row order; default 'classic' (by points)"}, 'league': {'type': 'string', 'description': "League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name."}, 'season': {'type': 'string', 'description': "Season string exactly as list_leagues returns it: winter-calendar leagues look like '2026-2027', summer-calendar leagues (Brazil, Sweden, Norway, Japanâ\x80¦) like '2026'. Omit for the current season. The free tier serves the current and previous season only."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'view': {'$ref': '#/properties/league'}, 'table': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['team'], 'properties': {'won': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'lost': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'team': {'type': 'string'}, 'drawn': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'played': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'points': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'position': {}, 'goals_for': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'last_5_form': {'$ref': '#/properties/league', 'description': "Latest results as letters, e.g. 'WWDLW'"}, 'clean_sheets': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'goals_against': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'last_5_points': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'luck_category': {'$ref': '#/properties/league', 'description': "'lucky' | 'fair' | 'unlucky'"}, 'expected_points': {'description': 'Points the underlying numbers say the team should have'}, 'goal_difference': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'luck_difference': {'$ref': '#/properties/table/anyOf/0/items/properties/expected_points', 'description': 'points â\x88\x92 expected_points; positive = ahead of the numbers'}, 'avg_goals_scored': {'$ref': '#/properties/table/anyOf/0/items/properties/expected_points'}, 'expected_position': {'$ref': '#/properties/table/anyOf/0/items/properties/position'}, 'avg_goals_conceded': {'$ref': '#/properties/table/anyOf/0/items/properties/avg_goals_scored'}, 'over_25_percentage': {'$ref': '#/properties/table/anyOf/0/items/properties/avg_goals_scored'}}, 'additionalProperties': True}}, {'type': 'null'}]}, 'league': {}, 'season': {'$ref': '#/properties/league'}, 'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}, 'season_state': {'$ref': '#/properties/league', 'description': "'in_season' or 'finished'"}, 'current_season': {'$ref': '#/properties/league'}}, 'additionalProperties': True}
get_match
Match detail
One match in full: the complete model probability block (calibrated and raw, all markets), team ratings, first-goal-time histograms for both sides (fgt_h, fgt_a), recent form, and â once played â the score, half-time score and status. Use for one named fixture. slug has the form 'country/league-slug/YYYY-MM-DD-home-vs-away'; take it from a get_fixtures row rather than assembling it, because team spellings must match exactly. Use get_fixtures for a league's whole upcoming slate, get_results for scores of many matches. Probabilities are model output, not advice. Example: slug 'england/premier-league/2026-09-05-brentford-vs-sunderland'.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "Match slug from get_fixtures, e.g. 'england/premier-league/2026-09-05-brentford-vs-sunderland'"}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['match'], 'properties': {'match': {'type': 'object', 'properties': {'slug': {}, 'time': {'$ref': '#/properties/match/properties/slug'}, 'fgt_a': {'anyOf': [{'type': 'array'}, {'type': 'null'}], 'description': 'Away side first-goal-time histogram'}, 'fgt_h': {'anyOf': [{'type': 'array'}, {'type': 'null'}], 'description': 'Home side first-goal-time histogram'}, 'label': {'$ref': '#/properties/match/properties/slug'}, 'league': {'$ref': '#/properties/match/properties/slug'}, 'season': {'$ref': '#/properties/match/properties/slug'}, 'country': {'$ref': '#/properties/match/properties/slug'}, 'away_team': {'$ref': '#/properties/match/properties/slug'}, 'home_team': {'$ref': '#/properties/match/properties/slug'}, 'ht_result': {'$ref': '#/properties/match/properties/slug'}, 'away_score': {'$ref': '#/properties/match/properties/home_score'}, 'home_score': {}, 'match_date': {'$ref': '#/properties/match/properties/slug'}, 'match_status': {'$ref': '#/properties/match/properties/slug', 'description': "'scheduled' before kick-off; 'ft' when finished"}, 'real_league_name': {'$ref': '#/properties/match/properties/slug'}, 'model_predictions': {'anyOf': [{'type': 'object', 'properties': {'dc_v2': {'anyOf': [{'type': 'object', 'properties': {'model': {'$ref': '#/properties/match/properties/slug'}, 'calibrated': {'anyOf': [{'type': 'object', 'properties': {'away': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'home': {}, 'btts_yes': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_0.5': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_1.5': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_2.5': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_3.5': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'over_4.5': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'ht_over_0.5': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'ht_over_1.5': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'expected_ht_goals': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'expected_away_goals': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}, 'expected_home_goals': {'$ref': '#/properties/match/properties/model_predictions/anyOf/0/properties/dc_v2/anyOf/0/properties/calibrated/anyOf/0/properties/home'}}, 'description': 'Probabilities 0â\x80\x931. The draw is NOT a field: draw = 1 â\x88\x92 home â\x88\x92 away.', 'additionalProperties': True}, {'type': 'null'}], 'description': 'Use these. Calibrated on settled matches.'}, 'computed_at': {'$ref': '#/properties/match/properties/slug'}, 'data_through': {'$ref': '#/properties/match/properties/slug', 'description': 'Last match date the model has seen'}}, 'additionalProperties': True}, {'type': 'null'}]}}, 'additionalProperties': True}, {'type': 'null'}]}}, 'additionalProperties': True}, 'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}}, 'additionalProperties': True}
get_results
Match results
Finished matches of one league season, one row per match: date, teams, full-time and half-time score, first-goal minute, goalless flag. Rows are in chronological order, earliest first. last=N keeps only the N latest matches and still returns them earliest-first. team filters on a case-insensitive substring of either side's name. Use for scores, "how did X do lately", head-to-head within a season, half-time scores or first-goal minutes. Use get_fixtures for matches not yet played, get_match for one match's probability detail, get_team for one team's season in full. No odds. Example: "Last five Liverpool results" â get_results premier, team="Liverpool", last=5.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['league'], 'properties': {'last': {'anyOf': [{'type': 'integer', 'maximum': 500, 'minimum': 1}, {'type': 'null'}], 'description': 'Keep only the N latest matches of the season, e.g. 5 for recent form (default: all)'}, 'team': {'type': ['string', 'null'], 'description': "Team name substring, e.g. 'Liverpool'"}, 'league': {'type': 'string', 'description': "League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name."}, 'season': {'type': 'string', 'description': "Season string exactly as list_leagues returns it: winter-calendar leagues look like '2026-2027', summer-calendar leagues (Brazil, Sweden, Norway, Japanâ\x80¦) like '2026'. Omit for the current season. The free tier serves the current and previous season only."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'$ref': '#/properties/league'}, 'count': {}, 'league': {}, 'season': {'$ref': '#/properties/league'}, 'matches': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['homeTeam', 'awayTeam'], 'properties': {'date': {'$ref': '#/properties/league'}, 'time': {'$ref': '#/properties/league'}, 'score': {'$ref': '#/properties/league', 'description': "Full-time 'home:away', e.g. '3:0'"}, 'awayTeam': {'type': 'string'}, 'goalless': {'type': ['boolean', 'null']}, 'homeTeam': {'type': 'string'}, 'ht_result': {'$ref': '#/properties/league', 'description': "Half-time 'home:away'"}, 'first_goal_time': {'$ref': '#/properties/count', 'description': 'Minute of the first goal; null when goalless'}, 'first_goal_time_extra': {'$ref': '#/properties/count', 'description': 'Stoppage-time minutes added to first_goal_time'}}, 'additionalProperties': True}}, {'type': 'null'}]}, 'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}, 'season_state': {'$ref': '#/properties/league', 'description': "'in_season' or 'finished'"}, 'current_season': {'$ref': '#/properties/league'}}, 'additionalProperties': True}
get_season_projection
Season projection
How one league's CURRENT season is projected to finish: 10,000 Monte Carlo simulations refreshed daily, per team the title, top-four and relegation (bottom3) probabilities, points now, mean final points, a 10thâ90th percentile points range and a full finishing-position matrix, plus the change since the previous run. Use for forward-looking questions â who wins the league, who goes down, how safe a position is, likely final points. Use get_league_table for where things stand NOW and get_fixtures for individual match probabilities. Always the current season; there is no season parameter. Example: "Can Hull stay up?" â get_season_projection premier, read projection.teams.Hull.bottom3.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['league'], 'properties': {'league': {'type': 'string', 'description': "League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projection'], 'properties': {'projection': {'type': 'object', 'required': ['teams'], 'properties': {'teams': {'type': 'object', 'description': 'Keyed by team name', 'additionalProperties': {'type': 'object', 'properties': {'top4': {'$ref': '#/properties/projection/properties/teams/additionalProperties/properties/title'}, 'title': {}, 'gd_now': {'$ref': '#/properties/projection/properties/n_sims'}, 'played': {'$ref': '#/properties/projection/properties/n_sims'}, 'bottom1': {'$ref': '#/properties/projection/properties/teams/additionalProperties/properties/title'}, 'bottom2': {'$ref': '#/properties/projection/properties/teams/additionalProperties/properties/title'}, 'bottom3': {'$ref': '#/properties/projection/properties/teams/additionalProperties/properties/title', 'description': 'Relegation-zone probability (bottom three)'}, 'p10_pts': {'$ref': '#/properties/projection/properties/n_sims'}, 'p90_pts': {'$ref': '#/properties/projection/properties/n_sims'}, 'pts_now': {'$ref': '#/properties/projection/properties/n_sims'}, 'mean_pts': {'$ref': '#/properties/projection/properties/teams/additionalProperties/properties/title'}, 'position_matrix': {'anyOf': [{'type': 'array', 'items': {'type': 'number'}}, {'type': 'null'}], 'description': 'Probability of finishing 1stâ\x80¦last'}}, 'additionalProperties': True}}, 'league': {}, 'n_sims': {}, 'season': {'$ref': '#/properties/projection/properties/league'}, 'run_date': {'$ref': '#/properties/projection/properties/league'}, 'deltas_vs_prev': {'anyOf': [{'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'top4': {'$ref': '#/properties/projection/properties/teams/additionalProperties/properties/title'}, 'title': {'$ref': '#/properties/projection/properties/teams/additionalProperties/properties/title'}, 'bottom3': {'$ref': '#/properties/projection/properties/teams/additionalProperties/properties/title'}}, 'additionalProperties': True}}, {'type': 'null'}], 'description': 'Change since the previous run'}, 'partial_schedule': {'type': ['boolean', 'null']}, 'expected_remaining': {'$ref': '#/properties/projection/properties/n_sims'}, 'scheduled_remaining': {'$ref': '#/properties/projection/properties/n_sims'}}, 'additionalProperties': True}, 'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}}, 'additionalProperties': True}
get_team
Team page
Everything held on one team in one league season: its table row (with luck and expected points), the full match log (date, opponent, venue H/A, score, half-time score, first-goal minute, outcome), goals per 15-minute bin, first-goal distribution, season match-stat averages where the league is covered (shots, shots on target, shots against, possession, corners, xG for/against â null when not held), and the seasons available. team is a slug: lower-case, spaces as hyphens, e.g. 'arsenal', 'manchester-city'. Take the exact name from get_league_table first when unsure. Use for one team in depth ("tell me about Arsenal's season"). Use get_league_table for every team shallowly, get_results with a team filter for just the scores, get_goal_timing to compare timing across the whole league. Example: "How is Arsenal doing?" â get_team premier, team="arsenal".
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['league', 'team'], 'properties': {'team': {'type': 'string', 'description': "Team slug, e.g. 'arsenal', 'manchester-city' (from the table's team names, lower-case, spaces as hyphens)"}, 'league': {'type': 'string', 'description': "League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name."}, 'season': {'type': 'string', 'description': "Season string exactly as list_leagues returns it: winter-calendar leagues look like '2026-2027', summer-calendar leagues (Brazil, Sweden, Norway, Japanâ\x80¦) like '2026'. Omit for the current season. The free tier serves the current and previous season only."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'slug': {'$ref': '#/properties/team'}, 'team': {}, 'stats': {'anyOf': [{'type': 'object', 'properties': {'xg_avg': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}, 'shots_avg': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}, 'corners_avg': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}, 'possession_avg': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}, 'xg_against_avg': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}, 'shots_against_avg': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}, 'matches_with_stats': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'shots_on_target_avg': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}}, 'additionalProperties': True}, {'type': 'null'}], 'description': 'Per-match averages over this season, computed from stored match statistics; null where the league has none'}, 'league': {'$ref': '#/properties/team'}, 'season': {'$ref': '#/properties/team'}, 'matches': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'ht': {'$ref': '#/properties/team'}, 'away': {'$ref': '#/properties/team'}, 'date': {'$ref': '#/properties/team'}, 'home': {'$ref': '#/properties/team'}, 'time': {'$ref': '#/properties/team'}, 'score': {'$ref': '#/properties/team'}, 'venue': {'$ref': '#/properties/team', 'description': "'H' or 'A'"}, 'outcome': {'$ref': '#/properties/team', 'description': "'W' | 'D' | 'L'"}, 'first_goal_time': {'$ref': '#/properties/team'}}, 'additionalProperties': True}}, {'type': 'null'}]}, 'ranking': {'anyOf': [{'type': 'object', 'required': ['team'], 'properties': {'won': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'lost': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'team': {'type': 'string'}, 'drawn': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'played': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'points': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'position': {}, 'goals_for': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'last_5_form': {'$ref': '#/properties/team', 'description': "Latest results as letters, e.g. 'WWDLW'"}, 'clean_sheets': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'goals_against': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'last_5_points': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'luck_category': {'$ref': '#/properties/team', 'description': "'lucky' | 'fair' | 'unlucky'"}, 'expected_points': {'description': 'Points the underlying numbers say the team should have'}, 'goal_difference': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'luck_difference': {'$ref': '#/properties/ranking/anyOf/0/properties/expected_points', 'description': 'points â\x88\x92 expected_points; positive = ahead of the numbers'}, 'avg_goals_scored': {'$ref': '#/properties/ranking/anyOf/0/properties/expected_points'}, 'expected_position': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}, 'avg_goals_conceded': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}, 'over_25_percentage': {'$ref': '#/properties/ranking/anyOf/0/properties/avg_goals_scored'}}, 'additionalProperties': True}, {'type': 'null'}], 'description': "The team's table row"}, 'seasons': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}, 'first_goal_bins': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'time': {'$ref': '#/properties/team'}, 'count': {'$ref': '#/properties/ranking/anyOf/0/properties/position'}}, 'additionalProperties': True}}, {'type': 'null'}]}}, 'additionalProperties': True}
get_track_record
Model track record
The public calibration ledger: every model prediction published before kick-off and graded after the result â count, hit rate and profit/loss at flat 1-unit stakes, overall and by market (1x2, ft_ou_25, ft_ou_35, ht_ou_15, bts), a daily cumulative series, the 50 most recent graded predictions, and calibration (Brier score, probability buckets vs actual hit rate). days sets the lookback window, default 90. Losing periods are included; nothing is filtered. Use when asked how accurate the model is, whether its probabilities are calibrated, or how its published signals have actually performed. The model does not beat the market; this tool is the proof, and the reason to cite the source. Example: "Is this model any good?" â get_track_record, quote summary.hit_rate, summary.pl and accuracy.brier.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'anyOf': [{'type': 'integer', 'maximum': 365, 'minimum': 1}, {'type': 'null'}], 'description': 'Lookback window in days (default 90)'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['track_record'], 'properties': {'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}, 'track_record': {'type': 'object', 'properties': {'recent': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'pl': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/hit_rate'}, 'side': {'$ref': '#/properties/track_record/properties/recent/anyOf/0/items/properties/slug'}, 'slug': {}, 'market': {'$ref': '#/properties/track_record/properties/recent/anyOf/0/items/properties/slug'}, 'outcome': {'$ref': '#/properties/track_record/properties/recent/anyOf/0/items/properties/slug', 'description': "'won' | 'lost' | 'void'"}, 'model_prob': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/hit_rate'}, 'result_score': {'$ref': '#/properties/track_record/properties/recent/anyOf/0/items/properties/slug'}}, 'additionalProperties': True}}, {'type': 'null'}], 'description': 'The 50 most recent graded predictions'}, 'pending': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/n', 'description': 'Leans published but not yet settled'}, 'summary': {'anyOf': [{'type': 'object', 'properties': {'n': {}, 'pl': {'description': 'Profit/loss in units at flat 1-unit stakes'}, 'won': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/n'}, 'lost': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/n'}, 'void': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/n'}, 'hit_rate': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/pl'}}, 'additionalProperties': True}, {'type': 'null'}], 'description': 'Whole window'}, 'accuracy': {'anyOf': [{'type': 'object', 'properties': {'n': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/n'}, 'brier': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/pl', 'description': 'Brier score over settled probabilities; lower is better, 0.25 = coin flip'}, 'buckets': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/n'}, 'hi': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/hit_rate'}, 'lo': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/hit_rate'}, 'avg_prob': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/hit_rate'}, 'hit_rate': {'$ref': '#/properties/track_record/properties/summary/anyOf/0/properties/hit_rate'}}, 'additionalProperties': True}}, {'type': 'null'}]}}, 'additionalProperties': True}, {'type': 'null'}]}, 'by_market': {'anyOf': [{'type': 'object', 'additionalProperties': {'$ref': '#/properties/track_record/properties/summary/anyOf/0'}}, {'type': 'null'}]}, 'signals_only': {'type': ['boolean', 'null']}}, 'additionalProperties': True}}, 'additionalProperties': True}
list_leagues
List leagues
Every league this source covers â 93 across 42 countries â with country, league key, display name and the seasons available, newest first. No parameters. Call first in any workflow: every other tool takes a league key and most take a season string, and both must match these values exactly. Season format differs by competition (winter leagues '2026-2027', summer leagues '2026'), so read the season here rather than constructing it. ("list" rather than "get": it enumerates everything, it does not fetch one thing.) Example: "Which Polish league do you have?" â list_leagues, filter by country.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['leagues'], 'properties': {'count': {}, 'leagues': {'type': 'array', 'items': {'type': 'object', 'required': ['league', 'name', 'country', 'seasons'], 'properties': {'url': {}, 'name': {'type': 'string'}, 'league': {'type': 'string', 'description': 'The key to pass as `league`'}, 'country': {'type': 'string'}, 'seasons': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Newest first; exact strings for `season`'}}, 'additionalProperties': True}}, 'attribution': {'type': ['string', 'null'], 'description': 'Cite as "Data by football-charts.com"'}, 'season_window': {'$ref': '#/properties/leagues/items/properties/url'}}, 'additionalProperties': True}
History
Recent tool changes
Added
get_track_record
Sept. 17, 2026, 12:41 p.m.
Added
get_goal_timing
Sept. 17, 2026, 12:41 p.m.
Added
get_team
Sept. 17, 2026, 12:41 p.m.
Added
get_season_projection
Sept. 17, 2026, 12:41 p.m.
Added
get_match
Sept. 17, 2026, 12:41 p.m.
Added
get_fixtures
Sept. 17, 2026, 12:41 p.m.
Added
get_results
Sept. 17, 2026, 12:41 p.m.
Added
get_league_table
Sept. 17, 2026, 12:41 p.m.
Added
list_leagues
Sept. 17, 2026, 12:41 p.m.
Added
about_football_charts
Sept. 17, 2026, 12:41 p.m.
Discover
Similar MCP servers
LiveDataLink
io.github.blackboxfoundry/livedatalink
Exposes public-data tools covering economics, labor, banking, transport, books, legal opinions, carriers, environmental data, and…
AlpineDataWorks Intelligence Server
com.alpinedataworks/adw-intelligence-server
Provides economic, market, supply-chain, real-estate, energy, consumer, labor, and other scored intelligence indices with histori…
SharksAPI.AI
ai.sharksapi/marketing
Provides marketing analytics and actions across GA4, Search Console, Google Ads, social channels, SEO, WordPress, and marketing p…
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…