io.github.nguyenanhducs/fpl-mcp-server
An MCP server that provides Fantasy Premier League analysis and strategy tools.
What can you do with io.github.nguyenanhducs/fpl-mcp-server?
- 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
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
fpl-mcp-serverclaude mcp add fpl-mcp-server -- uvx fpl-mcp-server==1.0.3
{
"mcpServers": {
"fpl-mcp-server": {
"command": "uvx",
"args": [
"fpl-mcp-server==1.0.3"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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.
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:
{
"mcpServers": {
"fpl": {
"command": "uvx",
"args": ["fpl-mcp-server"],
"type": "stdio"
}
}
}
Option 2: Docker
Use the official Docker image from GitHub Container Registry:
{
"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.
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 - Choose the right tool for your analysis task
Data Sources
This server uses the official Fantasy Premier League API, see here for more details.
Contributing
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Frequently asked questions
What is io.github.nguyenanhducs/fpl-mcp-server?
An MCP server that provides Fantasy Premier League analysis and strategy tools.
How do I install io.github.nguyenanhducs/fpl-mcp-server?
It runs on your machine. In Claude Code: claude mcp add fpl-mcp-server -- uvx fpl-mcp-server==1.0.3. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.nguyenanhducs/fpl-mcp-server need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.nguyenanhducs/fpl-mcp-server open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.nguyenanhducs/fpl-mcp-server?
It is published by nguyenanhducs. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.