# io.github.ddevetak/footballcharts-mcp (npm · footballcharts-mcp)

Tables, results, fixtures, goal timing, season projections: 93 football leagues incl. lower tiers

- Trust score: 80/100 (high trust)
- Change this week: −1
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-24

## Components

- remote · `mcp.football-charts.com`: 78/100, [markdown](https://verifymcp.io/servers/ddevetak-footballcharts-mcp/mcp.md), [page](https://verifymcp.io/servers/ddevetak-footballcharts-mcp/mcp)
- npm · `footballcharts-mcp`: 80/100 (this document), [markdown](https://verifymcp.io/servers/ddevetak-footballcharts-mcp/footballcharts-mcp.md), [page](https://verifymcp.io/servers/ddevetak-footballcharts-mcp/footballcharts-mcp)

## Channel facts

- Registry: `npm`
- Package: `footballcharts-mcp`
- Version: `0.5.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-24.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 96 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 17 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 70/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2377 tokens (~237/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 75/100
  - Stability check failed: the tool surface changed between 0.2.0 and 0.5.0: 1 tool removals, 1 breaking changes, 1 additions.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 10 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 10 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the io.github.ddevetak/footballcharts-mcp server?

io.github.ddevetak/footballcharts-mcp runs locally as an npm package, launched with npx -y footballcharts-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add ddevetak-footballcharts-mcp -- npx -y footballcharts-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "ddevetak-footballcharts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "footballcharts-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "ddevetak-footballcharts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "footballcharts-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add ddevetak-footballcharts-mcp -- npx -y footballcharts-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ddevetak-footballcharts-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "footballcharts-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ddevetak-footballcharts-mcp --command npx --arg -y --arg footballcharts-mcp
```

### Hermes

```yaml
mcp_servers:
  ddevetak-footballcharts-mcp:
    command: "npx"
    args: ["-y", "footballcharts-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "ddevetak-footballcharts-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "footballcharts-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add ddevetak-footballcharts-mcp -t stdio -c npx -a -y footballcharts-mcp
```

### Other

```json
{
  "mcpServers": {
    "ddevetak-footballcharts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "footballcharts-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-24 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 72 to 75.

### 2026-09-22 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 65 to 68.

### 2026-09-21 (score 78, −3)

No change was recorded against any check on this day. Stability & Change Management went from 85 to 65.

### 2026-09-20 (score 81, +1)

No change was recorded against any check on this day. Stability & Change Management went from 82 to 85.

### 2026-09-18 (score 80, −1)

No change was recorded against any check on this day. Stability & Change Management went from 85 to 78.

### 2026-09-17 (score 81, +1)

No change was recorded against any check on this day. Stability & Change Management went from 82 to 85.

### 2026-09-14 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 72 to 75.

### 2026-09-12 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 65 to 68.

## MCP tools (10)

### `about_football_charts` (~106 tokens)

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.

Output parameters:

- `do_not_use_for` (array)
- `free_tier` (string)
- `get_a_key` (string)
- `how_to_answer_well` (array)
- `tools` (object)
- `use_this_source_when` (array)
- `what` (string)

### `list_leagues` (~139 tokens)

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.

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `count`
- `leagues` (array)
- `season_window`

### `get_league_table` (~310 tokens)

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.

Input parameters:

- `league` (string, required): League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name.
- `season` (string): Season string exactly as list_leagues returns it: winter-calendar leagues look like '2026-2027', summer-calendar leagues (Brazil, Sweden, Norway, Japan…) like '2026'. Omit for the current season. The…
- `view`: Row order; default 'classic' (by points)

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `current_season`
- `league`
- `season`
- `season_state`: 'in_season' or 'finished'
- `table`
- `view`

### `get_results` (~317 tokens)

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.

Input parameters:

- `last`: Keep only the N latest matches of the season, e.g. 5 for recent form (default: all)
- `league` (string, required): League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name.
- `season` (string): Season string exactly as list_leagues returns it: winter-calendar leagues look like '2026-2027', summer-calendar leagues (Brazil, Sweden, Norway, Japan…) like '2026'. Omit for the current season. The…
- `team` (string|null): Team name substring, e.g. 'Liverpool'

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `count`
- `current_season`
- `league`
- `matches`
- `note`
- `season`
- `season_state`: 'in_season' or 'finished'

### `get_fixtures` (~250 tokens)

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"].

Input parameters:

- `league` (string, required): League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name.

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `count`
- `league`
- `matches`

### `get_match` (~208 tokens)

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'.

Input parameters:

- `slug` (string, required): Match slug from get_fixtures, e.g. 'england/premier-league/2026-09-05-brentford-vs-sunderland'

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `match` (object)

### `get_season_projection` (~210 tokens)

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.

Input parameters:

- `league` (string, required): League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name.

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `projection` (object)

### `get_team` (~328 tokens)

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, 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".

Input parameters:

- `league` (string, required): League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name.
- `season` (string): Season string exactly as list_leagues returns it: winter-calendar leagues look like '2026-2027', summer-calendar leagues (Brazil, Sweden, Norway, Japan…) like '2026'. Omit for the current season. The…
- `team` (string, required): Team slug, e.g. 'arsenal', 'manchester-city' (from the table's team names, lower-case, spaces as hyphens)

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `first_goal_bins`
- `league`
- `matches`
- `ranking`: The team's table row
- `season`
- `seasons`
- `slug`
- `team`

### `get_goal_timing` (~303 tokens)

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".

Input parameters:

- `league` (string, required): League key from list_leagues, e.g. 'premier' (England), 'spain1', 'brazil1', 'sweden1', 'wgermany1' (women). Not the display name.
- `season` (string): Season string exactly as list_leagues returns it: winter-calendar leagues look like '2026-2027', summer-calendar leagues (Brazil, Sweden, Norway, Japan…) like '2026'. Omit for the current season. The…
- `team` (string|null): Team name substring, e.g. 'Flamengo' — returns that team's row only

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `data`
- `league`
- `note`
- `season`
- `stats`
- `team_filter`
- `team_not_found`
- `time_bins`

### `get_track_record` (~206 tokens)

Model track record

The public settled ledger: every model lean 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 leans, 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.

Input parameters:

- `days`: Lookback window in days (default 90)

Output parameters:

- `attribution` (string|null): Cite as "Data by football-charts.com"
- `track_record` (object)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/ddevetak-footballcharts-mcp/footballcharts-mcp#diagnostics

## Score history

- 2026-09-24: 80
- 2026-09-23: 79
- 2026-09-22: 79
- 2026-09-21: 78
- 2026-09-20: 81
- 2026-09-19: 80
- 2026-09-18: 80
- 2026-09-17: 81
- 2026-09-16: 80
- 2026-09-15: 80
- 2026-09-14: 80
- 2026-09-13: 79
- 2026-09-12: 79
- 2026-09-11: 78
- 2026-09-10: 78
- 2026-09-09: 77
- 2026-09-08: 77
- 2026-09-07: 76
- 2026-09-06: 50
- 2026-09-05: 61
- 2026-09-04: 79
- 2026-09-03: 78
- 2026-09-02: 78
- 2026-09-01: 77
- 2026-08-31: 77
- 2026-08-30: 76
- 2026-08-29: 76
- 2026-08-28: 75
- 2026-08-27: 75
- 2026-08-26: 74

## Common questions

### What is the io.github.ddevetak/footballcharts-mcp server?

io.github.ddevetak/footballcharts-mcp is listed in the public MCP registry as io.github.ddevetak/footballcharts-mcp. Tables, results, fixtures, goal timing, season projections: 93 football leagues incl. lower tiers. This page covers its npm package (footballcharts-mcp).

### Is the io.github.ddevetak/footballcharts-mcp server safe to use?

io.github.ddevetak/footballcharts-mcp scores 80 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 24 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.ddevetak/footballcharts-mcp server expose?

io.github.ddevetak/footballcharts-mcp exposes 10 tools: about_football_charts, list_leagues, get_league_table, get_results, get_fixtures, and 5 more. Their descriptions and schemas cost roughly 2,377 tokens of context every time the server is loaded.

### Is the io.github.ddevetak/footballcharts-mcp server still maintained?

io.github.ddevetak/footballcharts-mcp is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the io.github.ddevetak/footballcharts-mcp server under?

io.github.ddevetak/footballcharts-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/footballcharts-mcp
- Socket report: https://socket.dev/npm/package/footballcharts-mcp
- Repository: https://github.com/ddevetak/footballcharts-mcp
- Website: https://www.football-charts.com/developers
- Changelog RSS feed: https://verifymcp.io/servers/ddevetak-footballcharts-mcp/footballcharts-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/ddevetak-footballcharts-mcp/footballcharts-mcp.json
- HTML version of this page: https://verifymcp.io/servers/ddevetak-footballcharts-mcp/footballcharts-mcp