fotmob-mcp
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., "@fotmob-mcp list upcoming matches for Manchester City"
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.

FotMob MCP
Model Context Protocol server for live FotMob football data.
FotMob MCP exposes a small set of MCP tools and resources for working with football data from FotMob. It is intended for agents and local tooling that need fixture lookup, league pages, team/player data, match details, live fixture polling, and league stats.
Features
Verified FotMob route catalog
Search suggestions for teams, players, leagues, and matches
Direct fetch tool for supported FotMob JSON routes
Helpers for live match details, live fixtures, and league top stats
MCP resources for route reference and reusable prompt context
Optional local response cache
stdio,sse, andstreamable-httptransports
Related MCP server: api-football-mcp-server
Installation
From the repository root:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txtrequirements.txt installs the runtime dependencies and this package in editable mode.
Verify that the console script is available:
command -v fotmob-mcp
fotmob-mcp --helpUsage
Run the server with the default stdio transport:
fotmob-mcpRun with streamable HTTP:
fotmob-mcp --transport streamable-http --host 127.0.0.1 --port 8000Default streamable HTTP endpoint:
http://127.0.0.1:8000/mcpClient Configuration
Codex
codex mcp add fotmob -- fotmob-mcpHermes Agent
Install the package in the runtime environment used by Hermes, then add the MCP server entry:
{
"mcpServers": {
"fotmob": {
"command": "fotmob-mcp",
"args": []
}
}
}Verify that Hermes can resolve the command from the same environment:
command -v fotmob-mcpTools
Tool | Description |
| List supported routes, optionally filtered by keyword. |
| Fetch a supported route by route key and JSON parameters. Fresh by default. |
| Query FotMob search suggestions. |
| Fetch match details from a FotMob match id or URL. Fresh by default. |
| Fetch match live ticker/commentary events from a match id or URL. Fresh by default. |
| Fetch live fixtures from a league payload's poll link. |
| Fetch league player or team stats and resolve internal season ids when possible. |
Resources
Resource | Description |
| Markdown reference for the supported FotMob API routes. |
| Route catalog generated by the server. |
| Reusable prompt context for agents. |
Supported Routes
Key | Endpoint |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Use list_fotmob_routes to inspect parameters and notes for each route.
For match pages, prefer get_match_details when you have a FotMob URL:
get_match_details("https://www.fotmob.com/en-GB/matches/japan-vs-brazil/1uqadm#4653711")For match commentary/live ticker events, use the same URL or match id:
get_match_liveticker("https://www.fotmob.com/en-GB/matches/japan-vs-brazil/1uqadm#4653711")The match page slug can vary; the helper extracts the match id from the URL fragment. If FotMob has no live ticker file for a match, the tool returns status: unavailable with an empty events array.
All MCP tools fetch fresh FotMob data by default, including search, league, team, player, match, fixture, heatmap, transfer, TV, audio, and provider routes. fetch_fotmob_route and get_match_details still expose use_cache=true for explicit opt-in caching.
Configuration
Optional environment variables:
Variable | Description |
| Override the default FotMob base URL. |
| Change the local cache directory for explicit cache use. |
| Change cache lifetime in seconds for explicit cache use. |
| Default transport: |
| HTTP bind host. |
| HTTP bind port. |
| SSE endpoint path. |
| Streamable HTTP endpoint path. |
Development
Run tests:
python -m unittestAvailable Tools
7 toolsfetch_fotmob_routeC
Fetch one of the verified FotMob JSON routes through the shared FotMob client.
Inputs: route_key (required), use_cache, params_json. Returns: object
get_league_top_statsB
Fetch top league player/team stats and resolve FotMob internal season ids automatically.
Inputs: season (required), league_id (required), stat, limit, +2 more. Returns: object
get_live_fixturesC
Fetch live league fixtures from the league payload's live fixture poll link.
Inputs: season (required), league_id (required), ccode3. Returns: object
get_match_detailsB
Fetch FotMob match details from a match id or FotMob match URL. Fresh data is fetched by default.
Inputs: match_id_or_url (required), use_cache. Returns: object
get_match_livetickerA
Fetch FotMob live ticker/commentary events from a match id or FotMob match URL. Fresh data is fetched by default.
Inputs: match_id_or_url (required), lang, use_cache. Returns: object
list_fotmob_routesB
List the verified FotMob route inventory, optionally filtered by a keyword.
Inputs: query. Returns: object
search_fotmobC
Fetch FotMob search suggestions for a term.
Inputs: term (required), hits, lang. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct data source or action: fetching specific routes, league stats, live fixtures, match details, liveticker, listing routes, and searching. No two tools have overlapping purposes.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_match_details, list_fotmob_routes). The naming is predictable and easy to understand.
Seven tools is well-scoped for a sports data API, covering common queries without being excessive. Each tool serves a clear need.
The tool set covers search, live data, match details, and league stats. The generic fetch_fotmob_route allows access to any API endpoint, compensating for missing specific tools like team info or league tables.
Maintenance
Related MCP Connectors
Football fixtures, standings, and odds intelligence for AI agents.
API-Football MCP — comprehensive soccer/football data
Live sports data: scores, play-by-play, box scores, odds and props. No key needed to start.
Football fixtures, historical scores, team/venue profiles, archived squads and availability reports.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables MCP clients to access live football data from FotMob, including match stats, team form, injuries, and player workload, without making predictions.101MIT
- FlicenseNot gradedqualityDmaintenanceEnables natural language querying of football/soccer data via the API-Football service, providing access to leagues, teams, players, fixtures, standings, and statistics.2-
- AlicenseNot gradedqualityBmaintenanceProvides comprehensive soccer/football data including standings, team search, league search, match predictions, and head-to-head records via the API-Football service.88 npmMIT
- FlicenseAqualityBmaintenanceEnables querying FotMob football data including matches, match details, teams, leagues, players, and search through MCP-compatible LLM clients.6-