trackmcp
Back to directory
ddevetak

footballcharts-mcp

View on GitHub

MCP server for football-charts.com — tables, results, model probabilities and Monte Carlo season projections for 90+ football leagues

0 stars JavaScriptOthers Updated Sep 2, 2026
apifootballfootball-datamcpmcp-servermodel-context-protocolsoccersports-data

Documentation

football-charts MCP server

npm
license
MCP registry

Give your AI assistant live football data for 90+ leagues: tables, results,

fixtures, model probabilities and Monte Carlo season projections from

football-charts.com.

FC publishes probabilities and a settled track record — not betting tips.

Every model signal is published before kickoff and graded after; the

`get_track_record` tool returns that ledger.

Free tier

  • All 90+ leagues (top and lower divisions, women's leagues)
  • Current + previous season per league
  • Model probabilities (Dixon-Coles based) and daily 10,000-run Monte Carlo

season projections

  • 5,000 requests/day, 60/minute
  • No betting odds (odds + full historical archive are part of the paid tier —

contact contact@football-charts.com)

Get a key

bash
curl -X POST https://footballcharts-backend.onrender.com/api/v1/keys/register/ \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'

The key (`fc_...`) is shown once — store it.

Use it on claude.ai (web or mobile) — nothing to install

Settings → Connectors → Add custom connector, then paste:

code
https://mcp.football-charts.com/fc_your_key_here/mcp

The key sits in the URL because a connector field accepts only a URL. If your

client can send headers, `POST https://mcp.football-charts.com/mcp` with

`Authorization: Bearer fc_your_key` works identically. Keys are read-only,

free and replaceable, so a key in a URL grants published statistics and

nothing else.

Use with Claude Desktop

`claude_desktop_config.json`:

json
{
  "mcpServers": {
    "football-charts": {
      "command": "npx",
      "args": ["-y", "footballcharts-mcp"],
      "env": { "FC_API_KEY": "fc_your_key_here" }
    }
  }
}

Use with Claude Code

bash
claude mcp add football-charts -e FC_API_KEY=fc_your_key_here -- npx -y footballcharts-mcp

Tools

ToolWhat it returns
`list_leagues`All leagues + the seasons your key can query. Call first.
`get_league_table`Standings: points, W/D/L, goals, form.
`get_rankings`Luck-adjusted or goals-based re-ranking of the table.
`get_results`Finished matches with FT/HT scores + first-goal minute.
`get_fixtures`Upcoming matches with model probabilities.
`get_match`One match: full probability block across markets.
`get_season_projection`Title / top-4 / relegation %, points ranges (10k sims, daily).
`get_team`One team: match log, goal timing, stats.
`get_goal_timing`Goals per 15-minute bin, per team.
`get_track_record`FC's settled public prediction ledger.

Things to ask

  • "How does the Allsvenskan title race look after this weekend?"
  • "When does Flamengo usually score — early or late?"
  • "Show me the K League table, and who's overperforming what the market expected."
  • "Which team in Serie B hasn't conceded in the first 15 minutes?"
  • "What is Football Charts' actual prediction track record this season?"

Configuration

Env varDefaultPurpose
`FC_API_KEY`— (required)Your API key
`FC_API_BASE`FC production APIOverride for self-hosted/testing

Terms

Free for personal and research use with attribution

("Data by football-charts.com"). No resale of the data. Commercial use of the

paid tier: contact@football-charts.com.

License

MIT (server code only). The data served by the football-charts.com API

remains © football-charts.com, provided under the terms at

https://www.football-charts.com/developers.

Frequently asked questions

What is footballcharts-mcp?

footballcharts-mcp is MCP server for football-charts.com — tables, results, model probabilities and Monte Carlo season projections for 90+ football leagues

How do I install footballcharts-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is footballcharts-mcp open source?

Yes — it is hosted on GitHub at https://github.com/ddevetak/footballcharts-mcp.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP