fifa-public-api-mcp
Provides tools to query FIFA data: competitions, seasons, stages, matches, live match data, teams, stadiums, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fifa-public-api-mcp get matches for the FIFA World Cup 2026"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fifa-public-api-mcp
⚽ Live FIFA World Cup & football data for your AI assistant: an MCP server for competitions, fixtures, live scores, lineups, squads, and stadiums.
Give Claude, or any Model Context Protocol client, instant read-only access to the public FIFA data API for football (soccer): every FIFA competition (the men's and women's World Cups, club competitions, and more), their fixtures and results, live match detail, and reference data. No API key, no auth, no rediscovering FIFA's undocumented endpoints. Just install and ask.
⚡ What you can ask
Once it's connected, ask your assistant things like:
"Who's hosting the 2026 FIFA World Cup, and which stadiums are being used?"
"List the knockout-stage fixtures for the FIFA Women's World Cup."
"What was the final score, lineup, and attendance for that match?"
"Which six confederations does FIFA recognise, and how many member associations are there?"
Your assistant picks the right tools and chains the FIFA IDs for you behind the scenes.
Related MCP server: mcp-opensky
✨ Features
⚽ 12 read-only tools spanning competitions, seasons, stages, fixtures, results, live matches, teams, stadiums, and reference data.
🔑 No API key or sign-up: wraps the public FIFA API directly.
🌍 Localised output via a
languagearg, plus arawescape hatch that returns the untouched FIFA payload.📦 One-line install with
npx: nothing to clone or build.🛡️ Typed and tested: unit-tested response normalizers and provenance-signed npm releases.
🚀 Install
The server is published to npm and runs via npx, so there is nothing to clone or compile.
Claude Code:
claude mcp add fifa -- npx -y fifa-public-api-mcpClaude Desktop: add this to mcpServers in your config:
{
"mcpServers": {
"fifa": {
"command": "npx",
"args": ["-y", "fifa-public-api-mcp"]
}
}
}npx downloads and caches the package on first use; later runs are offline-fast. Requires Node 22+ on the PATH.
🧰 Tools
Every tool also accepts two optional args: raw (default false; return FIFA's untouched payload) and language (default en).
Tool | Inputs | Returns |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| none |
|
| none |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
IDs are stable string handles chained between endpoints. A typical flow: search_competitions → list_seasons → list_stages → get_matches → get_match_timeline / get_live_match.
Example IDs (FIFA World Cup 2026): idCompetition=17, idSeason=285023. These are examples for trying the tools, not defaults baked into the server.
⚠️ Known limitations
No standings. FIFA's
/calendar/standingendpoint returns200 nullfor every competition and season tested, so no standings tool ships.No real pagination on
get_matches. The API's continuation cursor is non-functional, socountis only a single-request hard limit. Set a largecount(e.g. 500) for a full fixture list, and narrow withidStage/idGroup; there is no way to page pastcount.get_live_matchreturns data for any match state, not just live matches. A not-started match has an empty lineup and a null score.
🛠️ Develop from source
git clone https://github.com/chrispickford/fifa-public-api-mcp.git
cd fifa-public-api-mcp
npm install
npm run build # compiles TS to build/index.js (with shebang + executable bit)
npm test # vitest unit tests over the normalizers (no network, CI-safe)
npm run smoke # manual live end-to-end hit of every tool against the real API (needs network)Point a client at the local build with an absolute path, e.g. claude mcp add fifa-dev -- node /absolute/path/to/build/index.js.
The code is four small, single-purpose layers: src/client.ts (the only module that touches the network; encodes the FIFA base-API conventions and throws a structured FifaApiError), src/shape.ts (pure, unit-tested response normalizers), src/tools.ts (tool definitions and handlers wiring client → shape), and src/index.ts (bootstrap: register tools, connect StdioServerTransport).
License
MIT © Chris Pickford
Available Tools
12 toolsget_competitionA
Get details for one FIFA competition by its idCompetition (name, organizer, type). Use search_competitions first if you only have the competition's name.
Inputs: idCompetition (required), raw, language.
get_live_matchA
Get rich detail for one match: starting lineups, substitutes, officials, attendance, and weather, plus live score and status. Works for any match state (a not-yet-started match has an empty lineup and a null score). Takes idCompetition + idSeason + idStage + idMatch.
Inputs: idMatch (required), idStage (required), idSeason (required), idCompetition (required), +2 more.
get_matchesA
List a competition's matches: fixtures, kickoff times (UTC), and final scores for a season (e.g. every 2026 World Cup game). Takes idCompetition + idSeason; narrow with idStage/idGroup. Pagination is non-functional, so pass a large count for a full list; no continuation token is returned.
Inputs: idSeason (required), idCompetition (required), raw, count, +3 more.
get_match_timelineB
Get one match's event timeline in order: goals, cards, substitutions, and other key events. Takes idCompetition + idSeason + idStage + idMatch (idMatch comes from get_matches).
Inputs: idMatch (required), idStage (required), idSeason (required), idCompetition (required), +2 more.
get_seasonA
Get one season/edition (e.g. the 2026 FIFA World Cup) by idSeason: its dates, participating member associations, host teams, and resolved crest/logo image URLs.
Inputs: idSeason (required), raw, language.
get_stadiumB
Get a stadium/venue by its idStadium: name, city, and capacity.
Inputs: idStadium (required), raw, language.
get_teamA
Get a national team or club by its idTeam: name, abbreviation, country, home city, and stadium. Surfaces idStadium so you can chain to get_stadium.
Inputs: idTeam (required), raw, language.
list_confederationsA
List the six FIFA confederations (UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC), each with its idConfederation.
Inputs: raw, language.
list_countriesB
List FIFA countries and member associations (reference data), each with its idCountry.
Inputs: raw, language.
list_seasonsA
List a competition's seasons/editions (e.g. each World Cup year), newest first, with start and end dates. Takes an idCompetition; returns the idSeason that stage, fixture, and squad lookups need.
Inputs: idCompetition (required), raw, count, language.
list_stagesA
List a season's stages, e.g. Group Stage, Round of 16, Final. Takes idCompetition + idSeason; returns the idStage used to scope fixtures and match lookups.
Inputs: idSeason (required), idCompetition (required), raw, language.
search_competitionsA
Start here. Find a FIFA competition (the FIFA World Cup, Women's World Cup, club competitions and more) by name or fragment, e.g. 'world cup'. Returns the matching competitions, each with the string idCompetition that every other tool builds on.
Inputs: name (required), raw, language.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct entity or action: competitions, seasons, matches (list, live, timeline), teams, stadiums, confederations, countries. No overlap; even search vs get vs list are clearly different.
All tool names follow a consistent verb_noun pattern in snake_case (get_, list_, search_). No mixed conventions or vague verbs.
12 tools cover the core entities of FIFA data (competitions, seasons, stages, matches, teams, stadiums, confederations, countries). The count feels well-scoped for the domain.
Covers basic CRUD-like operations for major entities. Missing player/squad data and standings, but the core workflow (find competition, list seasons, get matches, drill into a match) is complete.
Maintenance
Related MCP Connectors
Sports MCP — wraps TheSportsDB API (free tier, test key 3, no auth required)
ESPN MCP — keyless multi-sport live scores, teams, and news via ESPN's public site API.
Keyless sports scores, betting odds, injuries & news: NFL NBA MLB NHL soccer. No API key.
Historical football results, draws and no-draw streaks. 11 read-only tools, 6 need no API key.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides programmatic access to comprehensive football statistics and live match data via API-Football, enabling applications to retrieve league standings, team fixtures, player statistics, and real-time match events.6-
- AlicenseNot gradedqualityCmaintenanceEnables querying real-time flight data from the OpenSky Network API with anonymous access.101 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables querying university data from the Hipolabs Universities API without authentication.77 npmMIT
- AlicenseNot gradedqualityBmaintenanceAccess football (soccer) data including competitions, matches, standings, and team details via the Football-Data.org API.95 npm2MIT