> ## Documentation Index
> Fetch the complete documentation index at: https://nad-aae8058d.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Tabs>
  <Tab title="Manual">
    Add this to your config file

    ```json lines theme={null}
    {
      "mcpServers": {
        "fpl": {
          "command": "uvx",
          "args": ["fpl-mcp-server"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code">
    Use the `claude mcp add` command to register the MCP server.

    ```shellscript theme={null}
    claude mcp add fpl --scope user -- uvx fpl-mcp-server
    ```
  </Tab>

  <Tab title="Gemini">
    Use the `gemini mcp add` command to register the MCP server.

    ```shellscript theme={null}
    gemini mcp add fpl uvx fpl-mcp-server --scope user
    ```
  </Tab>

  <Tab title="Codex">
    Use the `codex mcp add` command to register the MCP server.

    ```shellscript theme={null}
    codex mcp add fpl -- uvx fpl-mcp-server
    ```
  </Tab>
</Tabs>

## Option 2: Docker

Run the official image via GitHub Container Registry:

<Tabs>
  <Tab title="Manual">
    Add this to your config file

    ```json lines theme={null}
    {
      "mcpServers": {
        "fpl": {
          "command": "docker",
          "args": [
            "run",
            "--rm",
            "-i",
            "ghcr.io/nguyenanhducs/fpl-mcp-server:latest"
          ],
          "type": "stdio"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code">
    Use the `claude mcp add` command to register the MCP server.

    ```shellscript theme={null}
    claude mcp add fpl --scope user \
    -- docker run -i --rm \
    ghcr.io/nguyenanhducs/fpl-mcp-server:latest
    ```
  </Tab>

  <Tab title="Gemini">
    Use the `gemini mcp add` command to register the MCP server.

    ```shellscript theme={null}
    gemini mcp add fpl --scope user \
    docker run -i --rm \
    ghcr.io/nguyenanhducs/fpl-mcp-server:latest
    ```
  </Tab>

  <Tab title="Codex">
    Use the `codex mcp add` command to register the MCP server.

    ```shellscript theme={null}
    codex mcp add fpl \
    -- docker run -i --rm \
    ghcr.io/nguyenanhducs/fpl-mcp-server:latest
    ```
  </Tab>
</Tabs>

## Option 3: From Source

For development or contributing:

```bash theme={null}
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:

```json theme={null}
{
  "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.

<CardGroup cols={2} />