Back to Browse

Footballcharts MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Tables, results, model probabilities and Monte Carlo projections for 90+ football leagues.

About

Tables, results, model probabilities and Monte Carlo projections for 90+ football leagues.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (6 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

8 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

football-charts.com API key (free: POST https://footballcharts-backend.onrender.com/api/v1/keys/register/ with {"email": ...}, or use the form at https://www.football-charts.com/developers)Required

Environment variable: FC_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-ddevetak-footballcharts-mcp": {
      "env": {
        "FC_API_KEY": "your-fc-api-key-here"
      },
      "args": [
        "-y",
        "footballcharts-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

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:

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:

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

Use with Claude Code

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

Tools

ToolWhat it returns
list_leaguesAll leagues + the seasons your key can query. Call first.
get_league_tableStandings: points, W/D/L, goals, form.
get_rankingsLuck-adjusted or goals-based re-ranking of the table.
get_resultsFinished matches with FT/HT scores + first-goal minute.
get_fixturesUpcoming matches with model probabilities.
get_matchOne match: full probability block across markets.
get_season_projectionTitle / top-4 / relegation %, points ranges (10k sims, daily).
get_teamOne team: match log, goal timing, stats.
get_goal_timingGoals per 15-minute bin, per team.
get_track_recordFC'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_BASEFC 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.

Reviews

No reviews yet

Be the first to review this server!