# footballcharts-mcp

Connects an AI agent to football tables, results, fixtures and projections across 93 leagues, including lower divisions. Useful for match and season analysis.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: ddevetak
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ddevetak/footballcharts-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/footballcharts-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.football-charts.com/mcp`
- Environment variables: `FC_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http footballcharts-mcp https://mcp.football-charts.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env FC_API_KEY=<FC_API_KEY> --transport stdio footballcharts-mcp -- npx -y footballcharts-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add footballcharts-mcp --url https://mcp.football-charts.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add footballcharts-mcp --env FC_API_KEY=<FC_API_KEY> -- npx -y footballcharts-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "footballcharts-mcp": {
            "url": "https://mcp.football-charts.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "footballcharts-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "footballcharts-mcp"
            ],
            "env": {
                "FC_API_KEY": "<FC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "footballcharts-mcp": {
            "type": "http",
            "url": "https://mcp.football-charts.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "footballcharts-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "footballcharts-mcp"
            ],
            "env": {
                "FC_API_KEY": "<FC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http footballcharts-mcp https://mcp.football-charts.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e FC_API_KEY=<FC_API_KEY> footballcharts-mcp npx -y footballcharts-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md