MCP SERVERAnalyse Fantasy Premier League from an assistant — compare players, read fixtures and price changes, get captain picks, and manage your own squad and mini-leagues.
LABSCO SUMMARY
suggest_captain is the tool that earns its keep: rather than a bare recommendation, it combines FPL's own expected points, form, points-per-game and fixture difficulty into a score you can see the parts of. Most of the server is open public data, so you can research players and leagues with no login at all — authentication only comes in when you want your live squad with its real selling prices, which is the harder part to set up.
A server over the Fantasy Premier League API: 23 tools for player and team data, fixture and gameweek analysis, price movement, league standings, and — once you authenticate — your own squad, transfers and captain decisions.
Python, installed as the fpl-mcp PyPI package and run as its console script or python -m fpl_mcp. Most tools need no login — public FPL data is open. The my-team and transfer tools require authentication with an FPL refresh token, which you fetch by logging in at fantasy.premierleague.com and reading it from DevTools; update_fpl_credentials stores a fresh one when it expires.
One command — pip install fpl-mcp
USE CASES
Filter the player pool by position and budget, compare the shortlist across metrics, and check whose price is about to rise before you commit.
Rate the upcoming fixtures for your candidates, and check for blank and double gameweeks so you are not caught out by a week with no fixtures or a week with two.
Get a ranked captain suggestion for your squad with the reasoning behind each score, cross-checked against the fixture difficulty for the candidates.
Confirm the login is working, pull your current squad with its real selling prices, and review your transfer history to see how you got here.
Read the standings for your league and pull richer analytics to see who is rising, who is stalling, and how the squads differ.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
analyze_fixturesAnalyze upcoming fixtures for players, teams, or positions
Args: entity_type: Type of entity to analyze ("player", "team", or "position") entity_name: Name of the specific entity num_gameweeks: Number of gameweeks to look ahead include_blanks: Whether to include blank gameweek info include_doubles: Whether to include double gameweek info
Returns: Fixture analysis with difficulty ratings and summary
analyze_player_fixturesAnalyze upcoming fixtures for a player and provide a difficulty rating
Args: player_name: Player name to search for num_fixtures: Number of upcoming fixtures to analyze (default: 5)
Returns: Analysis of player's upcoming fixtures with difficulty ratings
analyze_playersFilter and analyze FPL players based on multiple criteria
Args: position: Player position (e.g., "midfielders", "defenders") team: Team name filter min_price: Minimum player price in millions max_price: Maximum player price in millions min_points: Minimum total points min_ownership: Minimum ownership percentage max_ownership: Maximum ownership percentage form_threshold: Minimum form rating include_gameweeks: Whether to include gameweek-by-gameweek data num_gameweeks: Number of recent gameweeks to include sort_by: Metric to sort results by (default: points; bootstrap names like total_points/goals_scored are accepted as aliases) sort_order: Sort direction ("asc" or "desc") limit: Maximum number of players to return
Returns: Filtered player data with summary statistics
check_fpl_authenticationCheck if FPL authentication is working correctly
Returns: Authentication status and basic team information
compare_playersCompare multiple players across various metrics
Args: player_names: List of player names to compare (2-5 players recommended) metrics: List of metrics to compare (bootstrap names like total_points/goals_scored are accepted as aliases) include_gameweeks: Whether to include gameweek-by-gameweek comparison num_gameweeks: Number of recent gameweeks to include in comparison include_fixture_analysis: Whether to include fixture analysis including blanks and doubles
Returns: Detailed comparison of players across the specified metrics
get_blank_gameweeksGet information about upcoming blank gameweeks where teams don't have fixtures
Args: num_gameweeks: Number of upcoming gameweeks to check (default: 5)
Returns: Information about blank gameweeks and affected teams
get_double_gameweeksGet information about upcoming double gameweeks where teams play multiple times
Args: num_gameweeks: Number of upcoming gameweeks to check (default: 5)
Returns: Information about double gameweeks and affected teams
get_dream_teamGet the official dream team (highest-scoring XI) for a gameweek
Args: gameweek_id: Gameweek to fetch (defaults to the current gameweek)
Returns: The dream team with player names, teams, positions, and points
get_gameweek_live_scoresGet live player points and stats for a gameweek while matches are being played
Args: gameweek_id: Gameweek to fetch (defaults to the current gameweek) player_ids: Optional list of FPL player IDs to restrict the result to limit: Maximum number of players to return when player_ids is not given
Returns: Live scores sorted by points, plus bonus-processing status
get_gameweek_statusGet precise information about current, previous, and next gameweeks
Returns: Detailed information about gameweek timing, including exact status
get_league_analyticsGet rich analytics for a Fantasy Premier League mini-league
Returns visualization-optimized data for various types of league analysis.
Args: league_id: ID of the league to analyze analysis_type: Type of analysis to perform:
Returns: Rich analytics data structured for visualization
get_league_standingsGet standings for a specified FPL league
Args: league_id: ID of the league to fetch
Returns: League information with standings and team details
get_managerGet detailed information about an FPL manager
Args: team_id: FPL team ID to look up
Returns: Manager information including history, name, team details, and leagues
get_manager_infoGet detailed information about an FPL manager
Args: team_id: FPL team ID (defaults to authenticated user)
Returns: Manager info with leagues and performance stats
get_manager_transfer_historyGet a manager's transfer history with player names and prices
Args: team_id: FPL team ID to look up limit: Maximum number of transfers to return (most recent first)
Returns: Transfer history grouped by gameweek
get_my_current_teamGet your current team as shown on the transfers page, including selling prices, chips, and transfer state (requires authentication)
Unlike get_my_team, this uses the authenticated my-team endpoint, so it reflects pending changes and per-player purchase/selling prices.
Returns: Current squad with prices, available chips, and transfer status
get_my_teamGet your own FPL team for a specific gameweek
Args: gameweek: Gameweek number (defaults to current gameweek)
Returns: Detailed team information including player details, captain, and value
Note: This uses your authenticated team ID from the FPL credentials. To get another team's details, use get_team and provide a team_id.
get_player_informationGet detailed information and statistics for a specific player
Args: player_id: FPL player ID (if provided, takes precedence over player_name) player_name: Player name to search for (used if player_id not provided) start_gameweek: Starting gameweek for filtering player history end_gameweek: Ending gameweek for filtering player history include_history: Whether to include gameweek-by-gameweek history include_fixtures: Whether to include upcoming fixtures
Returns: Comprehensive player information including stats and history
get_price_changesGet players whose price changed in the current gameweek (risers and fallers)
Args: direction: Optional filter, "risers" or "fallers" (default: both) limit: Maximum number of players per direction
Returns: Price risers and fallers with ownership and transfer momentum
get_teamGet any team's players, captain, and other details for a specific gameweek
Args: team_id: FPL team ID (required) gameweek: Gameweek number (defaults to current gameweek)
Returns: Detailed team information including player details, captain, and value
search_fpl_playersSearch for FPL players by name with optional filtering
Args: query: Player name or partial name to search for position: Optional position filter (GKP, DEF, MID, FWD) team: Optional team name filter limit: Maximum number of results to return
Returns: List of matching players with details
suggest_captainSuggest who to captain from a team's current squad, ranked with reasoning
Combines FPL's own expected points (ep_next), form, points per game, and upcoming fixture difficulty into a transparent captain score.
Args: team_id: FPL team ID (defaults to your authenticated team) gameweek_id: Gameweek whose squad to analyze (defaults to current)
Returns: Squad ranked by captain score with per-component breakdown
update_fpl_credentialsStore a new FPL refresh token when the current one has expired.
Use this when authenticated FPL tools fail with an invalid/expired refresh token error. Ask the user to fetch a fresh token first: log in at https://fantasy.premierleague.com, open the DevTools Console (F12), run
copy(JSON.parse(localStorage.getItem(Object.keys(localStorage).find(k=>k.startsWith('oidc.user:')))).refresh_token)
(typing 'allow pasting' first if Chrome refuses), and paste the clipboard contents here. Copying the whole 'oidc.user:...' JSON value from DevTools -> Application -> Local storage works too.
Args: refresh_token: The copied oidc.user JSON value (or just its refresh_token field) team_id: FPL team ID; omit to keep the currently stored one
Returns: Whether the new token was stored and validated against the FPL API
BEFORE YOU INSTALL
23 tools when we connected. Nine of them require authentication and fail without a refresh token. All are read-only toward FPL; update_fpl_credentials only changes your locally stored credentials.
Python 3.10 or later
Both documented setups run the server on your machine.
CONTEXT COST
Rated by the size of the 23 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
pip install fpl-mcp{
"mcpServers": {
"fantasy-pl": {
"command": "python",
"args": [
"-m",
"fpl_mcp"
]
}
}
}The configuration on this page does not set FPL_REFRESH_TOKEN and FPL_TEAM_ID; the project's instructions set them with an export line. That line reaches only programs started from the same terminal, so to supply them, start your client or the server from that terminal.
{
"mcpServers": {
"fantasy-pl": {
"command": "<YOUR_PATH_TO_VENV>/bin/fpl-mcp"
}
}
}The configuration on this page does not set FPL_REFRESH_TOKEN and FPL_TEAM_ID; the project's instructions set them with an export line. That line reaches only programs started from the same terminal, so to supply them, start your client or the server from that terminal.
MCP servers
nguyenanhducs
holoduke
mpizza
pab1it0