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, value-bet signals, 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 "Any value bets in the Premier League right now?" 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.

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 (Business tier)
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
get_predictions	upcoming-match probabilities (refreshed ~every 10 min)
get_value_bets	value-bet signals; since=<last id> for just-new picks
get_transfer_fit	0–100 player→club fit score (Ultra tier)

Every tool is available on every plan; plans differ only by monthly request volume. Some recruitment tools need a higher tier (noted above) — you'll get a clear message if your key can't reach one.

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.