io.github.nguyenanhducs/fpl-mcp-server
An MCP server that provides Fantasy Premier League analysis and strategy tools.
Open source Open in the app JSON README (API)
About
An MCP server that provides Fantasy Premier League analysis and strategy tools.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- nguyenanhducs
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.3
- Stars
- 1
- Last push
- 2026-02-20T04:40:37Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 04:00:53
- Updated
- 2026-08-29 04:00:53
- Origin id
io.github.nguyenanhducs/fpl-mcp-server
README
# 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.
[](https://pypi.org/project/fpl-mcp-server/)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://nad-aae8058d.mintlify.app/)
## 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.
<!-- mcp-name: io.github.nguyenanhducs/fpl-mcp-server -->