Skip to main content
Glama
Sign In
Fpl Universal MCP Server

Fpl Universal MCP Server

by universal-mcp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Fpl Universal MCP Server

This repository contains an implementation of an Fpl Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Fpl's tools and services through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Fpl directly from agentr.dev. Visit agentr.dev/apps and enable Fpl.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Related MCP server: Tavily Universal MCP Server

Available Tools

The full list of available tools is at Tools

Local Development

šŸ“‹ Prerequisites

Ensure you have the following before you begin:

  • Python 3.11+ (recommended)

  • uv (install globally with pip install uv)

šŸ› ļø Setup Instructions

Follow the steps below to set up your development environment:

  1. Sync Project Dependencies

    uv sync

    This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

  2. Activate the Virtual Environment

    For Linux/macOS:

    source .venv/bin/activate

    For Windows (PowerShell):

    .venv\Scripts\Activate

  3. Start the MCP Inspector

    mcp dev src/universal_mcp_fpl/server.py

    This will start the MCP inspector. Make note of the address and port shown in the console output.

  4. Install the Application

    mcp install src/universal_mcp_fpl/server.py

šŸ“ Project Structure

.
ā”œā”€ā”€ src/
ā”‚   ā””ā”€ā”€ universal_mcp_fpl/
ā”‚       ā”œā”€ā”€ __init__.py       # Package initializer
ā”‚       ā”œā”€ā”€ server.py         # Server entry point
ā”‚       ā”œā”€ā”€ app.py            # Application tools
ā”‚       ā””ā”€ā”€ README.md         # List of application tools
ā”œā”€ā”€ tests/                    # Test suite
ā”œā”€ā”€ .env                      # Environment variables for local development
ā”œā”€ā”€ pyproject.toml            # Project configuration
ā””ā”€ā”€ README.md                 # This file

šŸ“„ License

This project is licensed under the MIT License.

Generated with MCP CLI ā€” Happy coding! šŸš€

Available Tools

12 tools
fpl_analyze_fixturesC

Analyze upcoming fixtures for players, teams, or positions

Inputs: entity_name, entity_type, num_gameweeks, include_blanks, +1 more.

fpl_analyze_player_fixturesA

Analyze upcoming fixtures for a player and provide a difficulty rating

Inputs: player_name (required), num_fixtures.

fpl_analyze_playersC

Filter and analyze FPL players based on multiple criteria

Inputs: team, limit, sort_by, position, +9 more.

fpl_compare_playersC

Compare multiple players across various metrics

Inputs: player_names (required), metrics, num_gameweeks, include_gameweeks, +1 more.

fpl_get_blank_gameweeksB

Get information about upcoming blank gameweeks where teams don't have fixtures

Inputs: num_weeks.

fpl_get_double_gameweeksB

Get information about upcoming double gameweeks where teams have multiple fixtures

Inputs: num_weeks.

fpl_get_gameweek_statusB

Get precise information about current, previous, and next gameweeks.

Inputs: no named parameters.

fpl_get_league_analyticsC

Get rich analytics for a Fantasy Premier League mini-league

Inputs: league_id (required), end_gw, start_gw, analysis_type.

fpl_get_league_standingsB

Get standings for a specified FPL league

Inputs: league_id (required).

fpl_get_player_informationC

Get detailed information and statistics for a specific player

Inputs: player_id, player_name, end_gameweek, start_gameweek, +2 more.

fpl_search_fpl_playersC

Search for FPL players by name with optional filtering

Inputs: query (required), team, limit, position.

fpl_team_infoC

Get information about a team

Inputs: team_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogā€¦

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    B3.4/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have distinct purposes (player info, search, gameweek status, league standings, team info), but fpl_analyze_players and fpl_search_fpl_players overlap somewhat in filtering/analyzing players, and fpl_analyze_player_fixtures vs fpl_analyze_fixtures could be confused despite one being player-specific.

    Naming Consistency4/5

    All tools use a consistent fpl_ prefix with verb_noun structure (get_, search_, analyze_, compare_, etc.). Minor inconsistency: fpl_team_info breaks the verb pattern compared to fpl_get_* tools, but overall the naming is predictable.

    Tool Count5/5

    12 tools is well-scoped for an FPL server covering players, fixtures, gameweeks, and leagues. Each tool serves a distinct aspect of Fantasy Premier League data without feeling bloated.

    Completeness4/5

    The server covers player lookup, search, analysis, comparison, fixture analysis, gameweek info, and league standings/analytics. Missing obvious operations like getting overall FPL standings or user/team-specific data, but the core fantasy football workflows are well covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers