footballcharts-mcp — Claude Code MCP server
Connects an AI agent to football tables, results, fixtures and projections across 93 leagues, including lower divisions. Useful for match and season analysis.
claude mcp add --transport http footballcharts-mcp https://mcp.football-charts.com/mcpWhat footballcharts-mcp does
footballcharts-mcp exposes Football Charts data through MCP. An agent can inspect league standings, finished matches, upcoming fixtures, first-goal timing, team records and season projections. Coverage includes 93 leagues, with lower divisions and women’s competitions included.
The server provides ten read-only tools. They cover league discovery, table views, match details, team summaries, goal-timing splits and the model’s calibration record. Season projections use daily Monte Carlo runs, while match tools return calibrated probabilities.
An API key is optional. A free key raises the request allowance, but the hosted endpoint also accepts keyless access. The model publishes probabilities rather than betting recommendations, so its output should be read as football data and model context, not wagering advice.
What it helps with
- inspect a league table and current form
- compare a team’s results across a season
- find when a team scores most often
- check probabilities for upcoming fixtures
- review title and relegation projections
Example prompts for the agent
- Show the Allsvenskan title race after the latest round and compare the leading teams.
- Tell me whether Flamengo tends to score earlier or later in matches.
- Give me the K League table and identify teams outperforming the model’s expectation.
How to install footballcharts-mcp
1Platform CLI: remote server
claude mcp add --transport http footballcharts-mcp https://mcp.football-charts.com/mcp2Platform CLI
claude mcp add --env FC_API_KEY=<FC_API_KEY> --transport stdio footballcharts-mcp -- npx -y footballcharts-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add footballcharts-mcp --url https://mcp.football-charts.com/mcp2Platform CLI
codex mcp add footballcharts-mcp --env FC_API_KEY=<FC_API_KEY> -- npx -y footballcharts-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"footballcharts-mcp": {
"url": "https://mcp.football-charts.com/mcp"
}
}
}{
"mcpServers": {
"footballcharts-mcp": {
"command": "npx",
"args": [
"-y",
"footballcharts-mcp"
],
"env": {
"FC_API_KEY": "<FC_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"footballcharts-mcp": {
"type": "http",
"url": "https://mcp.football-charts.com/mcp"
}
}
}{
"servers": {
"footballcharts-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"footballcharts-mcp"
],
"env": {
"FC_API_KEY": "<FC_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http footballcharts-mcp https://mcp.football-charts.com/mcp2Platform CLI
gemini mcp add -e FC_API_KEY=<FC_API_KEY> footballcharts-mcp npx -y footballcharts-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about footballcharts-mcp
How do I install footballcharts-mcp in Claude Code?
Run claude mcp add --transport http footballcharts-mcp https://mcp.football-charts.com/mcp. This adds the hosted MCP server without a local package install.
What does footballcharts-mcp do?
It gives an agent football data for 93 leagues, including tables, results, fixtures, goal timing, match probabilities and season projections. Its tools are read-only.
Do I need an API key to use footballcharts-mcp?
No. Keyless access is available, while a free FC_API_KEY increases the request allowance for clients that need more calls.
