# fantasy-pl-mcp

> MCP Server

This repository hosts a Model Context Protocol (MCP) server providing access to Fantasy Premier League (FPL) data and tools for MCP-compatible clients like Claude Desktop, enabling rich player and team information access.

## Overview

- **Category:** Developer Tools
- **Language:** Python
- **Stars:** 75
- **Forks:** 0
- **Owner:** rishijatia
- **GitHub:** https://github.com/rishijatia/fantasy-pl-mcp
- **Created:** 2025-03-14T18:53:28+00:00
- **Updated:** 2025-03-18T01:50:12+00:00
- **Source:** https://model-context-protocol.com/servers/fantasy-premier-league-mcp-server-data

## Setup

## Setup

**Requirements**:
- Python 3.10 or higher
- Claude Desktop (for AI integration)

**Installation**:

**Option 1: Install from PyPI (Recommended)**

```bash
pip install fpl-mcp
```

**Option 1b: Install with Development Dependencies**

```bash
pip install "fpl-mcp[dev]"
```

**Option 2: Install from GitHub**

```bash
pip install git+https://github.com/rishijatia/fantasy-pl-mcp.git
```

**Option 3: Clone and Install Locally**

```bash
git clone https://github.com/rishijatia/fantasy-pl-mcp.git
cd fantasy-pl-mcp
pip install -e .
```

**Running the Server**:

1.  Using the CLI command:

```bash
fpl-mcp
```

2.  Using the Python module:

```bash
python -m fpl_mcp
```

3.  Using with Claude Desktop:

Configure Claude Desktop to use the installed package by editing your `claude_desktop_config.json` file:

**Method 1: Using the Python module directly (most reliable)**

```json
{
  "mcpServers": {
    "fantasy-pl": {
      "command": "python",
      "args": ["-m", "fpl_mcp"]
    }
  }
}
```

**Method 2: Using the installed command with full path (if installed with pip)**

```json
{
  "mcpServers": {
    "fantasy-pl": {
      "command": "/full/path/to/your/venv/bin/fpl-mcp"
    }
  }
}
```

Replace `/full/path/to/your/venv/bin/fpl-mcp` with the actual path to the executable.

## Tools

## Available Tools

1.  Rich Player Data: Access comprehensive player statistics from the FPL API.
2.  Team Information: Get details about Premier League teams.
3.  Gameweek Data: View current and past gameweek information.
4.  Player Search: Find players by name or team.
5.  Player Comparison: Compare detailed statistics between any two players.
6.  `get_gameweek_status` - Get precise information about current, previous, and next gameweeks.
7.  `analyze_player_fixtures` - Analyze upcoming fixtures for a player with difficulty ratings.
8.  `get_blank_gameweeks` - Get information about upcoming blank gameweeks.
9.  `get_double_gameweeks` - Get information about upcoming double gameweeks.
10. `analyze_players` - Filter and analyze FPL players based on multiple criteria.
11. `analyze_fixtures` - Analyze upcoming fixtures for players, teams, or positions.
12. `compare_players` - Compare multiple players across various metrics.
13. `player_analysis_prompt` - Create a prompt for analyzing an FPL player in depth.
14. `transfer_advice_prompt` - Get advice on player transfers based on budget and position.
15. `team_rating_prompt` - Create a prompt for rating and analyzing an FPL team.
16. `differential_players_prompt` - Create a prompt for finding differential players with low ownership.
17. `chip_strategy_prompt` - Create a prompt for chip strategy advice.