World Cup 2026

MCP server that exposes 2026 FIFA World Cup data as tools for clients such as Claude Desktop.

Available tools

• get_today_matches — returns the matches scheduled for today's date (home/away teams, kickoff time, venue, round, group, score and goals, when available).

Requirements

• Python >= 3.10
• uv

Installation

uv sync

Usage

Development mode (MCP Inspector)

uv run mcp dev server.py

Install into Claude Desktop

uv run mcp install server.py --name "World Cup 2026"

This adds the server under mcpServers in claude_desktop_config.json. Restart Claude Desktop for the tool to appear.

Run directly

uv run server.py

Data

Match data lives in data/worldcup.json, with the following structure per match:

Field	Description
round	Competition stage (e.g. Matchday 1, Round of 16, Final)
num	Match number
date	Date in YYYY-MM-DD format
time	Kickoff time (with UTC offset)
team1 / team2	Home / away team
group	Group stage group
ground	Match venue
score	Score (ft/ht), absent for matches not yet played
goals1 / goals2	List of goals (scorer name and minute) for each team

Project structure

.
├── server.py              # Defines the MCP server and registers tools
├── providers/
│   └── worldcup.py        # Reads and processes data/worldcup.json
└── data/
    └── worldcup.json      # Match data