Skip to main content
Glama
PlayerElo MCP server

PlayerElo MCP server

PlayerElo MCP server

Give any MCP client (Claude Desktop, Cursor, …) live access to PlayerElo — player- and coach-level football Elo ratings, EAR, model market-value estimates, lineup-aware match predictions, a settled value-bet track record, playing-style profiles and recruitment-fit — through the PlayerElo REST API.

Ask things like "What's Jude Bellingham's Elo and how has it trended this season?", "Which clubs are a good tactical + financial fit for player 129718?" or "What are the predicted probabilities for today's Premier League matches?" and the model answers from live data.

It's a thin client over the public API — no database, no model code. You bring an API key (free tier available); the server just makes authenticated calls.

Install & configure

You need a PlayerElo API key — get a free one at https://playerelo.football/api-access.

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "playerelo": {
      "command": "uvx",
      "args": ["playerelo-mcp"],
      "env": { "PLAYERELO_API_KEY": "pe_live_your_key_here" }
    }
  }
}

Restart Claude Desktop. (uvx comes with uv; or use pipx run playerelo-mcp, or pip install playerelo-mcp and set "command": "playerelo-mcp".)

Cursor / other MCP clients

Same shape — command uvx, args ["playerelo-mcp"], and PLAYERELO_API_KEY in the env.

Related MCP server: Football Live MCP

Tools

Tool

What it does

search_players / list_top_players

find players by name / top by Elo

get_player, get_player_history, get_player_value, get_player_style

one player's rating, trajectory, model value, style

get_player_opportunities

reachable-club shortlist

search_coaches, get_coach

coaches by name / by id (unique to PlayerElo)

search_clubs, get_club, get_club_squad_gaps

clubs by name / by id / recruitment needs

list_leagues, get_league_ranking

competitions + Team-Elo tables (off-season only)

get_predictions

upcoming-match probabilities (refreshed every few minutes)

get_value_bets

settled value-bet track record (won/lost); not betting tips

get_transfer_fit

0–100 player→club fit score

Every tool is available on every plan; plans differ only by monthly request volume.

Config

Env var

Default

PLAYERELO_API_KEY

—

required; your key

PLAYERELO_BASE_URL

https://data-api.playerelo.football

override the API base

Develop

pip install -e ".[test]"    # or: pip install -e . mcp httpx pytest
pytest tests/

Data & docs: https://playerelo.football/api-access · A LivingMeta project.

Available Tools

17 tools
get_clubA

One club's current record by team_id: name, Team Elo, league, country and its standout player. Returns null if no club has that id.

Inputs: team_id (required). Returns: result

get_club_squad_gapsA

A club's squad-need analysis: which positions are weakest relative to its level — the recruitment gaps a sporting director would target.

Inputs: team_id (required). Returns: result

get_coachA

Full current record for one coach by id (e.g. "coach_4"): name, club, league and Elo rating. Returns null if no coach has that id.

Inputs: coach_id (required). Returns: result

get_league_rankingA

A league's clubs ranked by Team Elo (current-season strength order).

Inputs: league_id (required). Returns: result

get_playerA

Full current record for one player by id: name, age, position, club, league, Elo rating and EAR (Elo Above Replacement). Returns null if no player has that id.

Inputs: player_id (required). Returns: result

get_player_historyA

A player's Elo and EAR over time (one point per date) — the rating trajectory, useful for form/trend analysis and charts.

Inputs: player_id (required). Returns: result

get_player_opportunitiesA

Recruitment opportunity map for a player: realistically reachable clubs that could plausibly sign them, ranked by fit. Requires a Business-tier key.

Inputs: player_id (required), top_n. Returns: result

get_player_styleA

A player's playing-style profile — per-90 output and a multi-axis process fingerprint describing how they play, not just how good they are.

Inputs: player_id (required). Returns: result

get_player_valueA

PlayerElo's own model-based market-value estimate for a player (in euros), with the signals behind it. This is our computed estimate, not a third-party valuation.

Inputs: player_id (required). Returns: result

get_predictionsA

Upcoming-match win/draw/win probabilities from confirmed lineups, refreshed roughly every 10 minutes. Optionally filter by a league name/code. These are lineup-aware predictions, not just team form.

Inputs: league. Returns: result

get_transfer_fitA

A 0-100 transfer-fit score for a specific player → club move, blending tactical fit (style match to the club's system), financial fit (our value estimate vs the club's typical spend) and strategic fit (squad need, age, level), with the per-signal breakdown. Requires an Ultra-tier key or higher.

Inputs: player_id (required), target_club_id (required). Returns: result

get_value_betsA

Current value-bet signals — where PlayerElo's fair odds diverge from the market price. Optionally filter by strategy ("hs2_v6" = High Volume, "hs1_v6" = Sweet Spot). To poll for only NEW picks, pass since=; signals refresh about every 10 minutes.

Inputs: since, strategy. Returns: result

list_leaguesA

All competitions PlayerElo covers, with each league's id, name and country. Use a league_id with get_league_ranking.

Inputs: no named parameters. Returns: result

list_top_playersA

The highest-rated players worldwide by current Elo (active players only). Paginate with limit (max 100) and offset.

Inputs: limit, offset. Returns: result

search_clubsA

Find clubs by name (case-insensitive). Returns matches with their team_id, name, Team Elo (squad-derived strength), league and country. Use the team_id with the other club tools.

Inputs: query (required), limit. Returns: result

search_coachesA

Find coaches/managers by name (case-insensitive). Returns matches with their coach_id (a string like "coach_4"), name, Elo and current club — PlayerElo is the only public system that rates coaches. Use the coach_id with the other coach tools.

Inputs: query (required), limit. Returns: result

search_playersA

Find football players by name (case-insensitive). Returns matches with their player_id, name, Elo rating, position, current club and league — use the player_id with the other player tools. This is how you resolve a name like "Bellingham" to an id.

Inputs: query (required), limit. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 17 tools

    Disambiguation5/5

    Each tool targets a distinct entity or specific aspect (e.g., player history vs. player value vs. player style). Search tools are separated by entity (players, coaches, clubs). No two tools appear to perform the same function, and any conceptual overlaps (like player opportunities vs. transfer fit) are complementary rather than redundant.

    Naming Consistency5/5

    All tool names follow a consistent lowercase_underscore convention with verb prefixes: search_*, list_*, and get_*. The get_* tools use clear entity-specific suffixes (e.g., get_player_history, get_club_squad_gaps). This makes the naming predictable and easy to navigate.

    Tool Count4/5

    With 17 tools, this is slightly above the typical well-scoped range, but the server covers a broad domain (players, coaches, clubs, leagues, predictions, betting). Each tool serves a distinct purpose and the count feels justified rather than bloated.

    Completeness4/5

    The tool surface covers core read operations for all entities, including specialized analytics (player history, value, style, opportunities; club squad gaps; league rankings; predictions; value bets). Minor gaps exist, such as no coach history or player match-level stats, but these are not critical to the server's stated purpose.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables MCP clients to access live football data from FotMob, including match stats, team form, injuries, and player workload, without making predictions.
      10
      1
      MIT
    • 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.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables querying probable football lineups with per-player start probability and expected fantasy points, match analysis, model picks, and a verified public track record across major European leagues through MCP tools.
      17
      59 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables retrieval of live multi-sport scores, match video highlights, and match predictions via MCP.
      84 npm
      MIT

    Appeared in Searches