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, and streamable-http transports

Related MCP server: FPL 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.txt

requirements.txt installs the runtime dependencies and this package in editable mode.

Verify that the console script is available:

command -v fotmob-mcp
fotmob-mcp --help

Usage

Run the server with the default stdio transport:

fotmob-mcp

Run with streamable HTTP:

fotmob-mcp --transport streamable-http --host 127.0.0.1 --port 8000

Default streamable HTTP endpoint:

http://127.0.0.1:8000/mcp

Client Configuration

Codex

codex mcp add fotmob -- fotmob-mcp

Hermes 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-mcp

Tools

Resources

Supported Routes

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:

Development

Run tests:

python -m unittest