MCP 服务器

footballcharts-mcp

io.github.ddevetak/footballcharts-mcp
数据与分析 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Provides football league tables, fixtures, results, team statistics, goal timing, season projections, probabilities, and model calibration records.

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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'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"].
只读 可访问外部资源 幂等
输入模式
{'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}
输出模式
{'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".
只读 可访问外部资源 幂等
输入模式
{'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}
输出模式
{'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.
只读 可访问外部资源 幂等
输入模式
{'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}
输出模式
{'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'.
只读 可访问外部资源 幂等
输入模式
{'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}
输出模式
{'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.
只读 可访问外部资源 幂等
输入模式
{'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}
输出模式
{'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.
只读 可访问外部资源 幂等
输入模式
{'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}
输出模式
{'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".
只读 可访问外部资源 幂等
输入模式
{'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}
输出模式
{'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.
只读 可访问外部资源 幂等
输入模式
{'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}
输出模式
{'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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'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}
已添加
get_track_record
2026年9月17日 12:41
已添加
get_goal_timing
2026年9月17日 12:41
已添加
get_team
2026年9月17日 12:41
已添加
get_season_projection
2026年9月17日 12:41
已添加
get_match
2026年9月17日 12:41
已添加
get_fixtures
2026年9月17日 12:41
已添加
get_results
2026年9月17日 12:41
已添加
get_league_table
2026年9月17日 12:41
已添加
list_leagues
2026年9月17日 12:41
已添加
about_football_charts
2026年9月17日 12:41