FPL MCP Server

MCP server for the Fantasy Premier League API.

Setup

pnpm install
npx playwright install chromium

Copy .env.example to .env and fill in your FPL email and password:

cp .env.example .env

Then start the server:

pnpm start

Adding to Claude Code

Start the server as a background process, then add it:

claude mcp add --transport http fpl http://localhost:3001/mcp

Available Tools

• fpl_get_current_user — Get authenticated user's manager ID
• fpl_get_gameweek_status — Current gameweek info and deadlines
• fpl_analyze_players — Filter/sort players by position, cost, form, etc.
• fpl_analyze_player_fixtures — Fixture difficulty analysis for specific players
• fpl_compare_players — Side-by-side player comparison
• fpl_get_blank_gameweeks — Find gameweeks where teams have no fixtures
• fpl_get_double_gameweeks — Find gameweeks where teams have multiple fixtures
• fpl_get_my_team — Get your current team selection (requires auth)
• fpl_get_manager_info — Get manager profile and league standings
• fpl_make_transfer — Make player transfers (requires auth)
• fpl_set_team_lineup — Set captain, formation, lineup (requires auth)

Available Resources

• fpl://players — All players with stats
• fpl://teams — Premier League teams with strength ratings
• fpl://fixtures — Season fixtures with difficulty ratings
• fpl://gameweeks — Gameweek status and deadlines