Live data · Model Context Protocol

Give your AI
the matchday.

An open-source MCP server that streams live football data — standings, fixtures, form and scorers — straight into Claude and any MCP client. Built with TypeScript & Zod.

Try the live demo Install in Claude

See it live

Every figure below is fetched in real time through the same data layer the MCP server exposes — no mock data. Each tab maps to a tool an AI assistant can call.

tool: get_standings

Six tools
your AI can call

Each tool has a typed, Zod-validated schema, so the model knows exactly how to call it — and gets clean, readable results back.

GitHub ↗ npm ↗
get_standings
Full league table for any of 12 top competitions.
get_matches
Fixtures and results, filtered by matchday or status.
get_top_scorers
The Golden Boot race for a competition.
find_team
Look up any club — country, stadium, founding year.
get_team_matches
A club's recent form and upcoming fixtures.
compare_teams
Head-to-head on recent form and W/D/L.

Install in under a minute

  1. 1

    Grab a free API token at football-data.org (about a minute).

  2. 2

    Add the server to your Claude Desktop config:

    claude_desktop_config.json 
    {
  "mcpServers": {
    "matchday": {
      "command": "npx",
      "args": ["-y", "matchday-mcp"],
      "env": { "FOOTBALL_DATA_TOKEN": "your_free_token" }
    }
  }
}
  3. 3

    Restart Claude and ask: "How's Real Madrid doing this season?"

Works in any MCP client. In Claude Code: claude mcp add matchday -e FOOTBALL_DATA_TOKEN=… -- npx -y matchday-mcp