Quickstart

Get the FPL MCP Server running in minutes using uvx or Docker. Choose the one that best fits your needs.

Prerequisites

You need an MCP-compatible client (for example, Claude Desktop).

Option 1: uvx (Recommended)

Fastest path with zero install.

Manual

Add this to your config file

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

Claude Code

Use the claude mcp add command to register the MCP server.

claude mcp add fpl --scope user -- uvx fpl-mcp-server

Gemini

Use the gemini mcp add command to register the MCP server.

gemini mcp add fpl uvx fpl-mcp-server --scope user

Codex

Use the codex mcp add command to register the MCP server.

codex mcp add fpl -- uvx fpl-mcp-server

Option 2: Docker

Run the official image via GitHub Container Registry:

Manual

Add this to your config file

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

Claude Code

Use the claude mcp add command to register the MCP server.

claude mcp add fpl --scope user \
-- docker run -i --rm \
ghcr.io/nguyenanhducs/fpl-mcp-server:latest

Gemini

Use the gemini mcp add command to register the MCP server.

gemini mcp add fpl --scope user \
docker run -i --rm \
ghcr.io/nguyenanhducs/fpl-mcp-server:latest

Codex

Use the codex mcp add command to register the MCP server.

codex mcp add fpl \
-- docker run -i --rm \
ghcr.io/nguyenanhducs/fpl-mcp-server:latest

Option 3: From Source

For development or contributing:

git clone https://github.com/nguyenanhducs/fpl-mcp-server.git
cd fpl-mcp-server
uv sync
uv run python -m src.main

Use the following configuration:

{
  "mcpServers": {
    "fpl": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/fpl-mcp-server",
        "run",
        "python",
        "-m",
        "src.main"
      ]
    }
  }
}

Replace /absolute/path/to/fpl-mcp-server with your actual installation path.

Verify

In your MCP client, ask: List available FPL tools

You should see the full tool list, including player search, fixture analysis, and transfer tracking.