MCP SERVER · OFFICIAL PROJECTAnswer a World Cup question from records instead of recall: every tournament from 1930 to 2026, full squads with clubs and birth dates, computed group tables, knockout brackets and 206 stadiums.
LABSCO SUMMARY
list_tournaments runs 1930 → 2026 and returns null for 2026 rather than omitting it, and get_match documents 2026-001 as the opener's id. Standings are computed with FIFA tiebreakers applied rather than stored as text, which is the difference between a table you can quote and a list of results you would have to order yourself. The tools also route between each other explicitly — get_tournament points at compare_tournaments for cross-year questions, search_players at get_player_career for a full career, and list_stadiums at get_stadium for the slug — so a question rarely needs guessing at which tool to reach for.
A FIFA World Cup reference dataset behind 15 tools — tournaments, teams, players, matches, stadiums, standings and brackets — addressed by year, canonical name or stable id.
WC_API_KEY.
One command plus a key — npm install -g @zafronix/wc-mcp, then supply credentials
USE CASES
A single year comes back with its teams, groups, brackets, awards and squads in one call, and the group tables are computed with FIFA tiebreakers applied rather than left as a list of results.
A name search returns every squad row it matches, which is how you find the canonical spelling; the career view then gives the appearances year by year with jersey, goals and captain status.
The nation list carries confederation, first and last appearance and total appearances, so a question about a region is answered before any single country is opened.
Matches are filterable by year and stage, and each has a stable {year}-{ordinal} id — 1986-052 is the 1986 final — that returns kickoff, extra time, penalties, referee and attendance, with the venue block attached on request.
Between 2 and 6 years go into one comparison that returns total goals, goals per match, attendance and the podium for each, with the venue list showing how the hosting itself changed.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
compare_tournamentsSide-by-side comparison of 2-6 World Cup tournaments. Returns total goals, goals per match, attendance, top scorer, best player, champion, runner-up, third place for each year. Use this when the user asks "compare 1986 vs 2022" or "what changed between 1990 and 2014". For a single year use get_tournament.
get_bracketFull knockout bracket for a tournament — Round of 16 through Final, with each match's teams + result. Use this for "show me the 2014 World Cup bracket" or "trace France's 2018 path to the title".
get_matchSingle match by ID. IDs follow {year}-{ordinal} zero-padded — the 1986 final is "1986-052", the 2022 final is "2022-064", the 2026 opener is "2026-001". Returns kickoff, both teams, score, extra time, penalties, stadium, city, attendance, referee, and (with denormalize=true) the full stadium block.
get_player_careerGet a player's full World Cup career: every tournament they appeared in, with team/position/jersey/goals/captain status per year. Use this when the user wants a "all of Pelé's World Cup matches" or "compare Messi's 4 World Cups" view. The name should be the canonical name (use search_players first if unsure).
get_stadiumSingle venue details by stable slug ID. Slugs are kebab-case ("estadio-azteca", "maracana", "wembley-stadium-old", "metlife-stadium"). Use list_stadiums first if you need to discover the right ID.
get_standingsComputed group standings with FIFA tiebreakers applied. Returns the order teams finished within each group of the given year, including W/D/L, GF, GA, GD, points. Use this for "show me the 1990 Group F table" or "who finished where in 2022 Group H?".
get_teamCross-tournament summary for a national team: every appearance, final position by year, total titles, knockout records. Use this for "Brazil's World Cup history" or "how many times has Argentina reached the final?". For a specific year's squad use get_team_roster.
get_team_rosterFull squad for one team in one tournament — every player with jersey, position, DOB, club, goals, captain flag. Use this for "who was on Spain's 2010 squad?" or "show me Italy's 2006 roster".
get_tournamentGet full details for a single World Cup tournament: every team that played, group stages, knockout brackets, awards (top scorer, best player, best young player, best GK), full squads with DOB/position/club, attendance, and trivia notes. Use this when the user asks about a specific year ("1986 World Cup", "what happened at Italia 90"). For comparisons across multiple tournaments use compare_tournaments instead.
get_triviaCurated factual nuggets about a tournament — record-setting moments, oddities, historical context. Each entry is a single fact with category. Use this when the user wants "interesting facts about 1958" or "tell me something I don't know about Italia 90". Far less hallucination-prone than free-recall about old tournaments.
list_matchesList World Cup matches. Filterable by year and/or stage (group_a..group_h, round_of_16, quarter_final, semi_final, third_place, final). Returns kickoff time, home/away team, score, stadium, attendance. Use this for "show me all the 1990 group matches" or "list every World Cup final". Pair with get_match for a specific match's full details.
list_stadiumsList World Cup venues. 206 stadiums total across history, with capacity, lat/long, elevation in meters, opening year, and the list of WC years each one hosted. Useful for "which stadiums hosted the most World Cup matches?" or "where was the 1986 final?". Filterable by country.
list_teamsList every national team that has ever played a World Cup, with confederation, first/last appearance year, and total appearances. Useful for "which African nations have made the World Cup?" or "list every CONMEBOL team". Pair with get_team for a specific country.
list_tournamentsList every FIFA World Cup tournament (1930 → 2026) with year, host country list, champion (or null for the upcoming 2026 cup). Useful as a starting point when the user is exploring history or needs to disambiguate a year.
search_playersSearch players by name. Returns every World Cup squad row matching the query, with team, position, DOB, club, and tournament-year goals. Use this when the user mentions a player by name. For a player's full multi-tournament career path use get_player_career.
BEFORE YOU INSTALL
15 tools when we connected. All fifteen read a World Cup dataset covering every tournament since 1930; the free key allows 1,000 requests a day.
Both documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 15 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npm install -g @zafronix/wc-mcp{
"mcpServers": {
"wc": {
"command": "npx",
"args": [
"-y",
"@zafronix/wc-mcp"
],
"env": {
"WC_API_KEY": "<YOUR_WC_API_KEY>"
}
}
}
}MCP servers
abaiii168
holoduke
opgginc