Skip to main content
Glama
FotMoCP
by Margeshy

FotMoCP

I built FotMoCP so an MCP client can check live FotMob data before analyzing a football match. Its ten read-only tools cover match stats, team form, injuries, and player workload. It does not make predictions.

What you need

  • Node.js 22 or newer

  • Internet access to www.fotmob.com

Related MCP server: fotmob-mcp

Run it

FotMoCP only uses modules included with Node.js, so there is nothing to install from npm.

npm run check
npm start

npm run check runs the tests and builds dist/. Use npm run build when you only want to rebuild the runtime files.

Add it to an MCP client

{
  "mcpServers": {
    "fotmob": {
      "command": "node",
      "args": ["/absolute/path/to/FotMoCP/dist/index.js"],
      "cwd": "/absolute/path/to/FotMoCP"
    }
  }
}

On Windows, use escaped backslashes:

{
  "mcpServers": {
    "fotmob": {
      "command": "node",
      "args": ["C:\\Users\\your-name\\FotMoCP\\dist\\index.js"],
      "cwd": "C:\\Users\\your-name\\FotMoCP"
    }
  }
}

Tools

Tool

Data returned

search_fotmob(query)

Team, player, league, and match IDs

find_matches(date)

Match IDs and scores for YYYY-MM-DD

get_match_stats(matchId)

Score, team stats, and player stats; accepts an ID or FotMob URL

get_match_prediction_context(matchId)

Clock, events, lineups, momentum, form, venue, and weather; accepts an ID or FotMob URL

get_goalkeeper_match_stats(matchId)

Saves, save percentage, xGOT faced, and goals prevented; accepts an ID or FotMob URL

get_team_form(teamId, limit?)

Recent results, home/away splits, ranking, and per-match xG

get_team_season_profile(teamId)

Table record, xG, xGA, xPoints, and FIFA ranking

get_team_availability(teamId)

Reported injuries and return dates

get_team_game_state_record(teamId, limit?)

Results after leading or trailing

get_player_workload(playerId)

Recent minutes, last match, and injury status

Limits

FotMob does not document these site endpoints as a public API, so they may change without notice. FotMoCP only makes GET requests and does not cache or save responses.

Available Tools

10 tools
find_matchesA

List FotMob matches on a UTC date. Use it when you do not have a match ID.

Inputs: date (required).

get_goalkeeper_match_statsA

Get saves, shots on target faced, save percentage, xGOT faced, and goals prevented. matchId may be an ID or FotMob URL.

Inputs: matchId (required).

get_match_prediction_contextB

Get the clock, events, lineups, momentum, form, head-to-head, weather, venue, and competition. matchId may be an ID or FotMob URL.

Inputs: matchId (required).

get_match_statsC

Get the score plus deduplicated team and player stats. matchId may be an ID or FotMob URL.

Inputs: matchId (required).

get_player_workloadC

Get a player's recent minutes, last appearance, and injury status.

Inputs: playerId (required).

get_team_availabilityC

List injured players and their reported return dates.

Inputs: teamId (required).

get_team_formC

Get recent results and home/away splits, with ranking and per-match xG when present.

Inputs: teamId (required), limit.

get_team_game_state_recordC

Count recent wins, draws, and losses after a team led or trailed.

Inputs: teamId (required), limit.

get_team_season_profileC

Get a team's table record, xG, xGA, xPoints, and FIFA ranking when present.

Inputs: teamId (required).

search_fotmobB

Search names and get FotMob IDs for teams, players, leagues, and matches.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct purpose: match discovery, specific stat categories, prediction context, team/player details, etc. No two tools appear interchangeable.

    Naming Consistency5/5

    All tools follow a clear verb_noun snake_case pattern (e.g., find_matches, get_goalkeeper_match_stats), providing predictable naming.

    Tool Count5/5

    10 tools cover the core football data domains (matches, teams, players, stats) without being overwhelming or too sparse.

    Completeness4/5

    The tool set covers search, match details, team/player stats, injury updates, and prediction context. A minor gap is the lack of a direct league standings tool, but overall coverage is solid.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Provides live football data through MCP tools, enabling users to fetch today's matches and top scorers for competitions like the Premier League or World Cup.
      2
      -
    • F
      license
      B
      quality
      D
      maintenance
      Enables access to live FotMob football data for fixture lookup, team and player research, match details, lineups, league discovery, and search-based entity lookup.
      7
      10
      -
    • F
      license
      A
      quality
      B
      maintenance
      Enables querying FotMob football data including matches, match details, teams, leagues, players, and search through MCP-compatible LLM clients.
      6
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Provides live football data from API-Football over HTTP, enabling queries for upcoming matches, recent results, current standings, injuries, live matches, and team search through MCP tools.
      -