FPL-MCP-Server

AhmS3cOps/FPL-MCP-Server

3.2

If you are the rightful owner of FPL-MCP-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The FPL MCP Server is a Model Context Protocol server that integrates Fantasy Premier League with Claude Desktop, providing AI-powered FPL team management and analysis.

Tools
1
Resources
0
Prompts
0

FPL MCP Server 🚀⚽

A Model Context Protocol (MCP) server that integrates Fantasy Premier League with Claude Desktop, enabling AI-powered FPL team management and analysis.

OverView

  • vpn.jpg

Features ✨

  • Squad Management - View current squad with detailed player stats
  • Injury Updates - Real-time injury and suspension alerts
  • Mini-League Intelligence - Track rival teams and strategies
  • Weekly Briefings - Comprehensive AI-powered insights
  • Transfer Analysis - Data-driven transfer recommendations (coming soon)
  • Captain Strategy - Optimal captain selection (coming soon)

Tech Stack 🛠️

  • Python 3.12 - Core server implementation
  • MCP Protocol - AI-tool integration
  • Docker - Containerized deployment
  • FPL API - Official Fantasy Premier League data
  • Claude Desktop - AI assistant interface

Installation 📦

Prerequisites

  • Docker Desktop with MCP Toolkit enabled
  • Claude Desktop
  • FPL Team ID

Quick Start

  1. Clone the repository
git clone https://github.com/yourusername/fpl-mcp-server.git
cd fpl-mcp-server
  1. Build Docker image
docker build -t fpl-mcp-server .
  1. Set up your FPL Team ID
docker mcp secret set FPL_TEAM_ID="your-team-id"
  1. Configure Claude Desktop
  • Add custom catalog configuration
  • Update Claude Desktop config
  • Restart Claude Desktop

Full installation guide in the documentation.

Usage 💬

Once installed, ask Claude:

  • "Show me my FPL squad"
  • "Get injury updates"
  • "How am I doing in my mini-leagues?"
  • "Give me my weekly FPL briefing"

Architecture 🏗️

Claude Desktop → MCP Gateway → FPL Server → FPL API
                      ↓
              Docker Secrets

Security 🔒

  • Runs in Docker container with non-root user
  • Secrets managed through Docker Desktop
  • No authentication required (FPL API is public)
  • Latest Python 3.12 with security patches

Contributing 🤝

Contributions welcome! Feel free to:

  • Report bugs
  • Suggest new features
  • Submit pull requests

Future Enhancements 🎯

  • Transfer recommendations with ML predictions
  • Lineup optimization algorithm
  • Captain selection AI
  • Fixture difficulty analysis
  • Price change predictions
  • Differential player suggestions

License 📄

MIT License - see LICENSE file for details

Author

Ahmed Mohammed - FPL enthusiast

Built with ❤️ for the FPL community