PlayerElo MCP server
Click on "Deploy 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., "@PlayerElo MCP server Any value bets in the Premier League right now?"
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.
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 |
| find players by name / top by Elo |
| one player's rating, trajectory, model value, style |
| reachable-club shortlist |
| coaches by name / by id (unique to PlayerElo) |
| clubs by name / by id / recruitment needs |
| competitions + Team-Elo tables (off-season only) |
| upcoming-match probabilities (refreshed every few minutes) |
| settled value-bet track record (won/lost); not betting tips |
| 0–100 player→club fit score |
Every tool is available on every plan; plans differ only by monthly request volume.
Config
Env var | Default | |
| — | required; your key |
|
| 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 toolsget_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
Scored across 17 tools
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.
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.
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.
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
Related MCP Connectors
API-Football MCP — comprehensive soccer/football data
Unofficial SportsDataIO MCP — wraps SportsDataIO's Big-Six sports data API (sportsdata.io)
Hosted MCP for live Pinnacle odds, drops, fair prices and closing lines.
Football-Data.org MCP — soccer competitions, matches, standings
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables MCP clients to access live football data from FotMob, including match stats, team form, injuries, and player workload, without making predictions.101MIT
- FlicenseNot gradedqualityCmaintenanceProvides 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.-
- AlicenseAqualityCmaintenanceEnables 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.1759 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables retrieval of live multi-sport scores, match video highlights, and match predictions via MCP.84 npmMIT