Fantasy Premier League

You can harness this MCP server to perform data-driven Fantasy Premier League analysis, access curated data resources, and use strategic prompts to optimize your mini-leagues. It provides interactive tools, data feeds, and ready-to-run configurations to speed up your analysis workflow.

How to use

You interact with the Fantasy Premier League MCP server through your MCP client by selecting the tools and prompts that align with your current task, such as evaluating fixtures, comparing managers, tracking transfers, or planning transfers and captain choices. Start by choosing a tool that fits your objective, then describe your question in natural language and let the server guide you through structured analysis prompts and data resources.

How to install

Prerequisites: you should have a runtime environment for running the MCP server, such as uvx for quick start or Docker for a containerized setup. Ensure you have internet access to pull images or run local utilities.

Option 1: uvx Recommended for fastest setup with no installation

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

Option 2: Docker Use the official Docker image to run the MCP server in a container

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

Additional setup notes

For additional installation guidance or alternative options, explore the options that fit your environment and workflow. You can run the MCP server locally or in a container, then connect your MCP client to the configured endpoint to start querying tools and data resources.

Data sources

The server relies on the official Fantasy Premier League API for data on players, teams, gameweeks, and bootstrap data for the current gameweek.

Notes on usage and data freshness

Smart caching reduces API calls by maintaining bootstrap data with a four-hour refresh window to keep information reasonably fresh while minimizing load.

Security and contributions

When using this server in shared or public environments, limit access to trusted clients and rotate any credentials if you introduce API keys or tokens in your deployment.

Troubleshooting tips

If you encounter connectivity issues, verify that your MCP client is pointing to the correct stdio configuration and that the container or runtime is running without errors. Check for any environment-specific restrictions that might block network access used by the MCP server.

Example startup configurations

You can start with the following two standard configurations to connect your MCP client to the fpl MCP server. These examples show explicit runtime commands and are intended for quick adoption.

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

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