footballcharts-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FC_API_KEY | Yes | Your API key (required) | |
| FC_API_BASE | No | Override for self-hosted/testing | FC production API |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_leaguesA | All 90+ leagues on football-charts.com with country, league key and the seasons available to your key (newest first). Call this first to resolve league keys and season strings. |
| get_league_tableA | Current standings for a league season: position, points, W/D/L, goals, goal difference, last-5 form. |
| get_rankingsA | The table re-ranked by FC's alternative views: 'luck' (luck-adjusted — who over/under-performs their underlying numbers) or 'goals' (highest-scoring matches). |
| get_resultsA | Finished matches of a league season with FT/HT scores and first-goal minute, oldest first. Optionally filter by team name substring and cap the number of most recent matches. |
| get_fixturesC | Upcoming matches of a league with FC's model probabilities (Dixon-Coles based) for HT over 1.5 and FT over 2.5. Probabilities, not betting advice. |
| get_matchA | One match by slug (country/league-slug/date-home-vs-away, as returned by get_fixtures): full model probability block across markets (1X2, over/under lines, BTTS, HT lines), team ratings, first-goal-time histograms. |
| get_season_projectionA | Monte Carlo season projection (10,000 simulations, refreshed daily): per team the title / top-4 / relegation probability, mean final points and a 10th-90th percentile points range. |
| get_teamA | One team in a league season: table row, full match log (scores, HT, venue, outcome), goal-timing bins, first-goal distribution and per-team stats. |
| get_goal_timingA | When each team in a league scores: goals per 15-minute bin per team, plus league-level stats (most active period, late-goal share). |
| get_track_recordA | FC's public, settled prediction track record — every published model signal graded against real results. Transparency data: hit rates and P/L by market, no cherry-picking. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool targets a distinct function: leagues, tables, rankings, results, fixtures, matches, projections, teams, goal timing, and track records. There is minor overlap between get_league_table and get_team (both include table position), but their broader scopes differentiate them clearly.
Names follow a consistent 'get_' prefix with descriptive nouns (e.g., get_league_table, get_fixtures). One tool uses 'list_' (list_leagues) instead of 'get_', which is a minor inconsistency but still clear. Overall pattern is predictable and readable.
Ten tools cover the core domain of football data exploration and betting analytics comprehensively without bloat. Each tool addresses a specific need from listings to deep stats, making the set well-scoped for the server's purpose.
The set covers league info, tables, alternative rankings, results, fixtures, match details, season projections, team stats, goal timing, and historical track records. A minor gap is the absence of a tool to search for teams across leagues or to get player-specific data, but the coverage is solid for a football-charts API.