footballcharts-mcp
MCP server for football-charts.com — tables, results, model probabilities and Monte Carlo season projections for 90+ football leagues
Documentation
football-charts MCP server
Give your AI assistant live football data for 90+ leagues: tables, results,
fixtures, model probabilities and Monte Carlo season projections from
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/mcpThe 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-mcpTools
| Tool | What 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 var | Default | Purpose |
|---|---|---|
| `FC_API_KEY` | — (required) | Your API key |
| `FC_API_BASE` | FC production API | Override 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
🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
Official remote MCP server for Atlassian. Securely connect Jira, Confluence, Jira Service Management, Bitbucket, and Compass to Claude, ChatGPT, Cursor, VS Code, and other AI tools using OAuth 2.1 or API tokens.
🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients. JavaScript-based implementation.
This is a 12306 ticket search server based on the Model Context Protocol (MCP).
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP