Metadata-Version: 2.4
Name: fpl-mcp-server
Version: 1.0.1
Summary: Fantasy Premier League MCP Server
Project-URL: Homepage, https://github.com/nguyenanhducs/fpl-mcp-server
Project-URL: Repository, https://github.com/nguyenanhducs/fpl-mcp-server
Project-URL: Issues, https://github.com/nguyenanhducs/fpl-mcp-server/issues
Project-URL: Documentation, https://github.com/nguyenanhducs/fpl-mcp-server#readme
Author: Anh Duc Nguyen
License-Expression: MIT
License-File: LICENSE
Keywords: fantasy-premier-league,fpl,mcp,model-context-protocol
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Games/Entertainment :: Simulation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: httpx>=0.28.0
Requires-Dist: mcp>=1.20.0
Requires-Dist: pydantic>=2.12.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.14.0; extra == 'dev'
Description-Content-Type: text/markdown

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

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/downloads/)
[![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)

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

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

### Option 2: Docker

Use the official Docker image from GitHub Container Registry:

```json
{
  "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](./docs/installation.md)**.

## 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](./docs/tool-selection-guide.md)** - Choose the right tool for your analysis task

## Data Sources

This server uses the official **Fantasy Premier League API**, see [here](./docs/fpl-api.md) for more details.

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
