fotmob-mcp
Click on "Install 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-mcplist 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.
| Name | Required | Description | Default |
|---|---|---|---|
| route_key | Yes | ||
| use_cache | No | ||
| params_json | No | {} |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided; description does not disclose behavioral traits like read-only, caching behavior, or authentication needs.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence is concise but lacks necessary detail. Every word earns its place in stating purpose, but overall structure is too minimal.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description fails to explain how to use the tool, including parameter behavior and expected input. Incomplete for a 3-parameter tool with no param descriptions.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, and description adds no meaning to parameters. Does not clarify what 'route_key' represents or the format of 'params_json'.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states it fetches a FotMob JSON route, but 'route' is vague and not differentiated from sibling tools like get_match_details. Purpose is clear in verb but ambiguous in resource.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus specific sibling tools. Does not mention prerequisites or context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_league_top_statsB
Fetch top league player/team stats and resolve FotMob internal season ids automatically.
| Name | Required | Description | Default |
|---|---|---|---|
| stat | No | goals | |
| limit | No | ||
| season | Yes | ||
| team_id | No | ||
| league_id | Yes | ||
| stat_type | No | players |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries burden. Mentions automatic season ID resolution as a behavioral trait, but lacks details on side effects, permissions, or limitations. Adequate for a read tool but not fully transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, 15 words, front-loaded with main action. No redundancy or filler. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description omits parameter details and usage context for a 6-parameter tool. Lacks explanation of stat_type, limit, or team_id. Insufficient for an agent to invoke correctly without external knowledge.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 6 parameters with 0% description coverage. Description only hints at 'season' via ID resolution, failing to explain other parameters like stat, limit, team_id, stat_type, or league_id. Schema has defaults but no semantic context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states 'Fetch top league player/team stats', specifying action (fetch) and resource (league stats). Mention of automatic season ID resolution adds unique functionality, distinguishing it from sibling tools like get_match_details or search_fotmob.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool over alternatives. Absence of conditions, prerequisites, or exclusions leaves the agent without direction for selection among siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_live_fixturesC
Fetch live league fixtures from the league payload's live fixture poll link.
| Name | Required | Description | Default |
|---|---|---|---|
| ccode3 | No | INT | |
| season | Yes | ||
| league_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behavioral traits. It only states the action without mentioning authentication, rate limits, data freshness, or whether the operation is read-only. The bare minimum is covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence, which is concise but lacks depth. It is front-loaded with the core action, but no additional structure or elaboration is provided to aid understanding.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description fails to explain what 'live league fixtures' entails or how parameters relate to the fetch. For a tool with 3 parameters and no schema descriptions, the description is insufficiently complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, and the description adds no meaning to the parameters (league_id, season, ccode3). It only references the source (live fixture poll link) without explaining how parameters are used or what valid values are.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it fetches live league fixtures, specifying the source as the league payload's live fixture poll link. This distinguishes it from sibling tools like get_match_details or get_match_liveticker, but the technical phrasing slightly reduces clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given on when to use this tool versus alternatives like search_fotmob or list_fotmob_routes. The description does not mention prerequisites or exclusions, leaving the agent without context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_match_detailsB
Fetch FotMob match details from a match id or FotMob match URL. Fresh data is fetched by default.
| Name | Required | Description | Default |
|---|---|---|---|
| use_cache | No | ||
| match_id_or_url | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions that 'Fresh data is fetched by default,' which implies a caching mechanism and the use_cache parameter. However, it does not disclose other behavioral aspects such as error handling, rate limits, or whether the tool is read-only. Without annotations, the description carries the burden but only partially fulfills it.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is only two sentences, with the first sentence conveying the core purpose and the second adding a key behavioral detail. Every word serves a purpose, and the structure is front-loaded for quick scanning. No unnecessary text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 2 parameters and an output schema, the description is fairly complete in stating its purpose and caching behavior. However, it lacks usage guidance and detailed parameter descriptions. The output schema exists, so return values need not be explained, but the description could still mention the type of details returned. Sibling tools suggest overlap, so more context would help.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It explains that match_id_or_url can be a match ID or URL, adding meaning beyond the schema. However, it does not clarify the expected format (e.g., numeric ID vs. full URL). The use_cache parameter is implied but not explicitly described. This partially addresses the gap but is not exhaustive.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Fetch' and the resource 'FotMob match details' and specifies input via match id or URL. It distinguishes from siblings like get_match_liveticker by focusing on general details, but does not explicitly contrast with other similar tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus its siblings (e.g., get_match_liveticker, get_league_top_stats). It lacks any context about prerequisites, typical use cases, or conditions where alternatives are preferred.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_match_livetickerA
Fetch FotMob live ticker/commentary events from a match id or FotMob match URL. Fresh data is fetched by default.
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | en | |
| use_cache | No | ||
| match_id_or_url | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. Mentions 'Fresh data is fetched by default' which hints at caching, but lacks details on authentication, rate limits, or error states.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise sentences with no fluff, front-loading the core purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
While an output schema exists, the description lacks prerequisites or context for when the tool should be invoked. Adequate for a simple read tool but could be more complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so description must compensate. Only partially explains match_id_or_url and hints at use_cache, but ignores lang. Incomplete coverage for 3 parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it fetches live ticker/commentary events using a match id or URL, distinguishing it from sibling tools like get_match_details.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives like get_match_details or search_fotmob. Usage is implied but not clarified.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_fotmob_routesB
List the verified FotMob route inventory, optionally filtered by a keyword.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It only states the core functionality without mentioning behavioral traits such as read-only nature, authorization requirements, rate limits, or response structure. The tool name suggests safety, but this is not confirmed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence with no extraneous information. It is well-structured and front-loaded, efficiently conveying the tool's purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (one optional parameter, no required fields, and presence of an output schema), the description adequately covers the core functionality. It omits details like pagination or filtering specifics, but these are not critical for a basic list endpoint.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, but the description explains the 'query' parameter as an optional keyword filter. This adds meaning beyond the minimal schema. However, it does not detail filter behavior or valid patterns, leaving room for ambiguity.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool lists verified FotMob routes with an optional keyword filter. It effectively implies a listing operation, distinguishing from the sibling 'fetch_fotmob_route' which likely retrieves a specific route. However, explicit differentiation is absent.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like 'fetch_fotmob_route'. The description only implies usage for listing, but lacks explicit context about when not to use it or what alternatives exist.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_fotmobC
Fetch FotMob search suggestions for a term.
| Name | Required | Description | Default |
|---|---|---|---|
| hits | No | ||
| lang | No | en | |
| term | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavior. It only states the basic function without mentioning expected behavior like read-only nature, rate limits, or result characteristics.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that immediately conveys the main purpose. However, it may be too brief given the lack of other documentation.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description fails to explain what kind of suggestions are returned or any details about the three parameters. It is insufficient for a search tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, and the description adds no meaning beyond the parameter names and defaults. It does not explain 'hits' or 'lang', leaving the agent uninformed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool fetches FotMob search suggestions for a term, which is specific and distinguishes it from siblings like get_match_details or get_live_fixtures.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, nor any exclusions or context for usage. Siblings exist but are not referenced.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
7 tool updates
v0.1.0- First observed
fetch_fotmob_route - First observed
get_league_top_stats - First observed
get_live_fixtures - First observed
get_match_details - First observed
get_match_liveticker - First observed
list_fotmob_routes - First observed
search_fotmob
TDQS
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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Football fixtures, standings, and odds intelligence for AI agents.
API-Football MCP — comprehensive soccer/football data
Historical football results, teams, competitions and draw/streak statistics via 10 read-only tools.
Live sports stats and pre-computed analysis for AI assistants across NBA, MLB, NFL, and NHL.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables 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.3-
- AlicenseNot gradedqualityCmaintenanceEnables fetching football fixtures, match details, league tables, and squad information from the matchday app through natural language.14MIT
- AlicenseNot gradedqualityCmaintenanceProvides comprehensive soccer/football data including standings, team search, league search, match predictions, and head-to-head records via the API-Football service.20MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ccdejene/fotmob-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server