fpl-mcp-server

Fantasy Premier League MCP Server

A comprehensive Model Context Protocol (MCP) server for Fantasy Premier League analysis and strategy. This server provides AI assistants with powerful tools, resources, and prompts to help you dominate your FPL mini-leagues with data-driven insights.

Features

This MCP server provides comprehensive FPL analysis capabilities through:

• 19 Interactive Tools - Search players, analyze fixtures, compare managers, track transfers, and more
• 4 Data Resources - access to players, teams, gameweeks, and current gameweek bootstrap data
• 10 Strategy Prompts - Structured templates for gameweek analysis, squad analysis, transfer planning, chip strategy, lineup selection, and captain selection
• Smart Caching - 4-hour cache for bootstrap data to minimize API calls while keeping data fresh
• Fuzzy Matching - Find players even with spelling variations or nicknames
• Live Transfer Trends - Track the most transferred in/out players for current gameweek
• Manager Insights - Analyze squads, transfers, and chip usage
• Fixture Analysis - Assess team fixtures and plan transfers around favorable runs

Quick Start

Option 1: uvx (Recommended)

The fastest way to get started - no installation required:

{
  "mcpServers": {
    "fpl": {
      "command": "uvx",
      "args": ["fpl-mcp-server"],
      "type": "stdio"
    }
  }
}

Option 2: Docker

Use the official Docker image from GitHub Container Registry:

{
  "mcpServers": {
    "fpl": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/nguyenanhducs/fpl-mcp-server:latest"
      ],
      "type": "stdio"
    }
  }
}

For detailed installation instructions and more options, see Installation Guide.

Usage & Documentation

Once configured, you can interact with the FPL MCP server through Claude Desktop using natural language.

For detailed guidance, see:

• Tool Selection Guide - Choose the right tool for your analysis task

Data Sources

This server uses the official Fantasy Premier League API, see here for more details.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.