Log inSubmit server
Footballcharts MCP logo

Footballcharts MCP

Read-only football data, calibrated match probabilities, goal timing, and Monte Carlo season projections across 90+ leagues.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Footballcharts MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "footballcharts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "footballcharts-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

footballcharts-mcp connects MCP clients to football-charts.com for read-only league data, including tables, results, fixtures, team records, goal timing, and model projections. Its ten tools cover more than 90 leagues and use exact league keys, team slugs, and competition-specific season formats returned by list_leagues. Match probabilities come from a historical baseline model rather than bookmaker odds, while season outcomes use daily 10,000-run Monte Carlo simulations. Reach for it when an agent needs structured football analysis, form and standings, or transparent model calibration data without live scores, player data, or betting odds.

Use cases

  • Compare league standings with expected points and luck categories
  • Analyze a team's season, form, and goal timing
  • Review upcoming fixtures and baseline match probabilities
  • Project title, top-four, and relegation outcomes
  • Evaluate the model's historical calibration and hit rate

Key features

  • Tables, results, and fixtures for 90+ football leagues
  • Calibrated match probabilities and team ratings
  • 10,000-run Monte Carlo season projections
  • Team and league goal-timing analysis
  • Public model track record with calibration metrics
  • Read-only MCP tools over hosted HTTP or local stdio

Tools10

What Footballcharts MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

9/9 checks healthy over the last 46d

What it can do

From the 10 tools this server returned when we ran it; 10 declare their own safety hints.

Makes network requests · 10Read-only tools · 10
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age65 days
Maintainers1

Observed 2026-10-22 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · footballcharts-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads219Package downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Tools exposed10Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Footballcharts MCP works

What footballcharts-mcp does

footballcharts-mcp exposes football-charts.com data through ten read-only MCP tools. The service covers more than 90 competitions across top divisions, lower divisions, and women's leagues. Available data includes league standings, completed and upcoming matches, team season summaries, goal timing, match-level probability details, forward-looking season projections, and the model's settled performance record.

The source is useful for questions such as who leads a competition, how a team has performed, when teams tend to score, which matches are scheduled next, and how likely different season outcomes are. It is not a source for live scores, player information, bookmaker odds, or betting advice.

How it works

Start with list_leagues to find the exact league key and an available season. Season notation varies by competition, so callers should use the returned value instead of constructing one. about_football_charts explains the source, its coverage, naming conventions, and how to interpret the model output.

Use get_league_table for current standings, form, expected points, and luck-based or goals-based ordering. get_results returns completed matches, while get_fixtures provides upcoming matches and calibrated probabilities. For a single fixture, take the slug from get_fixtures and pass it to get_match; assembling slugs manually can fail when team spellings differ.

get_season_projection covers the current season only. It reports title, top-four, and bottom-three probabilities, expected final points, point ranges, finishing-position distributions, and changes from the prior run. These projections are refreshed daily from 10,000 simulations.

Setup and configuration

The hosted Streamable HTTP endpoint can be added as a custom connector at https://mcp.football-charts.com/mcp. A keyless connection is available, while clients that support headers can send an Authorization: Bearer fc_... header for keyed access. Claude Desktop can also install the downloadable MCPB extension or launch the package with npx -y footballcharts-mcp.

For Claude Code, register the server with claude mcp add and launch the npm package through npx. FC_API_KEY can hold an optional free API key, and FC_API_BASE can override the production API for testing or self-hosted use. Requests are sent to the Football Charts API over HTTPS and are rate-limited.

Tools and capabilities

  • about_football_charts: explains coverage, limitations, naming, and probability interpretation.
  • list_leagues: enumerates covered leagues, keys, countries, and available seasons.
  • get_league_table: returns standings, form, expected points, and alternative orderings.
  • get_results: retrieves completed matches with scores, half-time results, and first-goal timing.
  • get_fixtures: lists upcoming matches with model probabilities and team ratings.
  • get_match: returns detailed probabilities, ratings, form, timing histograms, and played-match results.
  • get_team: combines a team's table row, match log, scoring periods, and first-goal distribution.
  • get_goal_timing: compares scoring periods across a league or for one team.
  • get_track_record: reports hit rate, profit or loss at flat stakes, Brier score, and calibration buckets.

Limitations and notes

The probability model uses match history and does not account for injuries, motivation, weather, or other live context. Its outputs are model estimates, not market prices or recommendations, and the public record shows that it does not beat the bookmaker market. Historical bookmaker odds are part of a paid dataset rather than the MCP data.

The server code is MIT-licensed, but football-charts.com retains rights to the served data. Free personal and research use requires attribution, and resale is not permitted. Commercial use of the paid tier requires contacting Football Charts.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Footballcharts MCP

footballcharts-mcp is an MCP server that connects AI clients to football-charts.com. Its main tools retrieve league lists, tables, results, fixtures, team data, goal timing, match probabilities, Monte Carlo season projections, and the model's public track record across more than 90 football leagues.

Install it with `npx -y footballcharts-mcp` in an MCP client such as Claude Desktop, or add the hosted endpoint `https://mcp.football-charts.com/mcp` as a custom connector. Claude Desktop can also open the downloadable MCPB extension.

Yes, footballcharts-mcp works with Claude Code. Register it with `claude mcp add football-charts -- npx -y footballcharts-mcp`; add `-e FC_API_KEY=...` when using an API key.

Yes, footballcharts-mcp includes a Cursor plugin that adds the hosted MCP server and a football-data skill. Copying the repository into Cursor's local plugins directory and reloading Cursor makes the plugin available.

No, footballcharts-mcp provides model probabilities rather than bookmaker odds or betting advice. Its `get_track_record` tool exposes historical hit rates and calibration, and the model's probabilities are based on match history without factors such as injuries, motivation, or weather.

Related MCP servers

All in Sports All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFootballcharts MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/footballcharts-mcp?style=directory)](https://allmcps.com/mcp/footballcharts-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/footballcharts-mcp"><img src="https://allmcps.com/api/badge/footballcharts-mcp?style=directory" alt="Footballcharts MCP on AllMCPs" /></a>