World Cup History MCP

by zafronix

Not rated
GitHub

About

Every FIFA World Cup since 1930. 23 tournaments, full squads, knockout brackets, stadium altitudes, hat-tricks. Free tier API.

Details

Author
zafronix
Categories
Other, API

Setup

Install World Cup History MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/zafronix/wc-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

by Zafronix· npm:@zafronix/wc-mcp· MIT-licensed

Model Context Protocol server giving Claude / Cursor / any MCP-aware agent grounded access to every FIFA World Cup since 1930.23 tournaments. 1,168+ matches. 2,500+ players. 206 stadiums.All exposed as 15 typed tools so the model stops hallucinating squads, scores, brackets, and stadium altitudes.

Powered by the publicZafronix World Cup API— free tier with key, 1,000 req/day, no card.

- Exact tournament results from before the trained-data window.
- Roster details (jersey numbers, DOBs, captains).
- Knockout-round paths and exact scores.
- Stadium facts (capacity, altitude, year opened).

This MCP wraps the Zafronix WC API so the model can call a tool and get the canonical answer instead of guessing.

git clone https://github.com/zafronix/wc-mcp cd wc-mcp npm install npm run build

1,000 requests/day on the free tier, no card.

Edit~/Library/Application Support/Claude/claude_desktop_config.json(macOS) /%APPDATA%\Claude\claude_desktop_config.json(Windows):

{ "mcpServers": { "wc": { "command": "npx", "args": ["-y", "@zafronix/wc-mcp"], "env": { "WC_API_KEY": "zwc_pk_your_key_here" } } } }

Restart Claude Desktop. You'll see a 🔌 icon in the input bar — click it to confirmwcis connected.

{ "mcpServers": { "wc": { "command": "npx", "args": ["-y", "@zafronix/wc-mcp"], "env": { "WC_API_KEY": "zwc_pk_..." } } } }

Example prompts (in Claude Desktop, with this MCP enabled)

- "Compare Pelé and Messi at the World Cup."
- "What was the highest-altitude World Cup stadium ever, and how did goal totals there compare to sea-level venues?"
- "Show me Italy's 2006 squad with positions and clubs."
- "Trace Argentina's 2022 path to the title — every match, every score."
- "List every African nation that has reached the World Cup quarter-finals."

npm run dev # tsx watch mode WC_API_KEY=... npm start

The server speaks stdio. You can test it with the MCP CLI:

npx @modelcontextprotocol/inspector npx tsx src/index.ts

Provides club information and advanced player statistics for Euroleague and Eurocup basketball from the Euroleague API.

Provides real-time football match information from the SoccerDataAPI using natural language.

Provides football (soccer) statistics and live match data using the API-Football service.

Analyse endurance sports activities, build training plans and sync structured workouts to your sports watch.

Access college football statistics from the College Football Data API.

Access Formula 1 data, including race results, driver standings, and circuit information.

Access extensive Formula 1 statistics and information using the FastF1 library and OpenF1 API.

Provides football (soccer) data using the API-Football service.

Access MLB game data, standings, and player statistics using the SportRadar API.

An MCP server for the NHL API, providing access to all documented endpoints.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.