get_my_team
Retrieve your Fantasy Premier League team details for any gameweek, including player information, captain selection, and team value.
Instructions
Get your own FPL team for a specific gameweek
Args:
gameweek: Gameweek number (defaults to current gameweek)
Returns:
Detailed team information including player details, captain, and value
Note:
This uses your authenticated team ID from the FPL credentials.
To get another team's details, use get_team and provide a team_id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gameweek | No |
Implementation Reference
- src/fpl_mcp/fpl/tools/team.py:273-302 (handler)MCP tool handler for 'get_my_team'. Retrieves the user's authenticated team ID and fetches detailed team data for the specified (or current) gameweek using helper functions.
@mcp.tool() async def get_my_team(gameweek: Optional[int] = None) -> Dict[str, Any]: """Get your own FPL team for a specific gameweek Args: gameweek: Gameweek number (defaults to current gameweek) Returns: Detailed team information including player details, captain, and value Note: This uses your authenticated team ID from the FPL credentials. To get another team's details, use get_team and provide a team_id. """ try: # Get the authenticated user's team ID auth_manager = get_auth_manager() team_id = auth_manager.team_id if not team_id: return { "error": "No default team ID found in credentials", "suggestion": "Check your authentication settings or use get_team with an explicit team_id" } logger.info(f"Getting authenticated user's team: {team_id}") return await get_team_for_gameweek(gameweek, team_id) except Exception as e: logger.error(f"Error in get_my_team: {e}") return {"error": str(e)} - src/fpl_mcp/__main__.py:142-146 (registration)Top-level registration of tool modules in the MCP server, including the team tools module containing 'get_my_team' via register_team_tools(mcp).
# Register team, manager, league, and player tools register_team_tools(mcp) register_manager_tools(mcp) register_league_tools(mcp) register_player_tools(mcp) - src/fpl_mcp/fpl/tools/team.py:12-199 (helper)Core helper function implementing the main logic for fetching, caching, enriching, and formatting detailed FPL team data including players, captain, bench, manager info, and gameweek history.
async def get_team_for_gameweek(gameweek: Optional[int] = None, team_id: int = 0) -> Dict[str, Any]: """ Get any FPL team for a specific gameweek with rich data Args: gameweek: The gameweek number (defaults to current) team_id: FPL team ID to look up (required) Returns: Detailed team information including player details """ # Get auth manager for API access auth_manager = get_auth_manager() # Check that we have a valid team ID if not team_id: return { "error": "No team ID specified", "suggestion": "Please provide a valid team_id parameter" } logger.info(f"Getting team data for team {team_id}, gameweek {gameweek}") # Use current gameweek if not specified if gameweek is None: current_gw_data = await api.get_current_gameweek() gameweek = current_gw_data.get("id", 1) # Extract just the ID # Ensure gameweek is an integer try: gameweek = int(gameweek) except (ValueError, TypeError): logger.error(f"Invalid gameweek value: {gameweek}") return {"error": f"Invalid gameweek value: {gameweek}"} # Get team data for the gameweek try: gw_picks_data = await auth_manager.get_team_for_gameweek(team_id, gameweek) except Exception as e: logger.error(f"Error fetching team data: {e}") return { "error": f"Failed to retrieve team data for gameweek {gameweek}: {str(e)}" } # Get player data to enrich team information # Use the players, teams, and position resources for better caching all_players = await api.get_players() all_teams = await api.get_teams() # Create lookup dictionaries players = {p["id"]: p for p in all_players} teams = {t["id"]: t for t in all_teams} # Process team data picks = gw_picks_data.get("picks", []) entry_history = gw_picks_data.get("entry_history", {}) # Format each player formatted_picks = [] captain_id = None vice_captain_id = None # Find captain and vice captain for pick in picks: if pick.get("is_captain"): captain_id = pick.get("element") if pick.get("is_vice_captain"): vice_captain_id = pick.get("element") # Format players with detailed info for pick in picks: player_id = pick.get("element") player_data = players.get(player_id, {}) if not player_data: logger.warning(f"Player {player_id} not found in bootstrap data") continue # Get team ID from player data player_team_id = player_data.get("team") # Look up team details using the team ID team_data = teams.get(player_team_id, {}) team_name = team_data.get("name", "Unknown") team_short = team_data.get("short_name", "UNK") # Extract position from player data position = player_data.get("element_type") # Convert position ID to position code position_map = {1: "GKP", 2: "DEF", 3: "MID", 4: "FWD"} position_code = position_map.get(position, "UNK") # Create enriched player data formatted_player = { "id": player_id, "position_order": pick.get("position"), "multiplier": pick.get("multiplier"), "is_captain": pick.get("is_captain", False), "is_vice_captain": pick.get("is_vice_captain", False), # Player details - using field names from players.py resource "web_name": player_data.get("web_name", "Unknown"), "full_name": f"{player_data.get('first_name', '')} {player_data.get('second_name', '')}".strip() or "Unknown", "price": player_data.get("now_cost", 0) / 10.0 if player_data.get("now_cost") else 0, "form": player_data.get("form", "0.0"), "points_per_game": player_data.get("points_per_game", "0.0"), "total_points": player_data.get("total_points", 0), "minutes": player_data.get("minutes", 0), "goals": player_data.get("goals_scored", 0), "assists": player_data.get("assists", 0), "clean_sheets": player_data.get("clean_sheets", 0), "bonus": player_data.get("bonus", 0), "status": player_data.get("status"), "news": player_data.get("news", ""), # Team details "team": team_name, "team_short": team_short, # Position details "position": position_code, } formatted_picks.append(formatted_player) # Sort by position order formatted_picks.sort(key=lambda p: p["position_order"]) # Split into active and bench active_players = [p for p in formatted_picks if p["multiplier"] > 0] bench_players = [p for p in formatted_picks if p["multiplier"] == 0] # Try to get team manager information try: # Use cache to avoid repeated calls cache_key = f"team_manager_info_{team_id}" cached_data = cache.cache.get(cache_key) if cached_data and cached_data[0] + 3600 > time.time(): # 1 hour cache manager_info = cached_data[1] else: # Get team entry data for manager info entry_data = await auth_manager.get_entry_data(team_id) manager_info = { "team_name": entry_data.get("name", "Unknown"), "manager_name": f"{entry_data.get('player_first_name', '')} {entry_data.get('player_last_name', '')}".strip(), "manager_region": entry_data.get("player_region_name", ""), "overall_rank": entry_data.get("summary_overall_rank", 0), "overall_points": entry_data.get("summary_overall_points", 0), } # Cache the result cache.cache[cache_key] = (time.time(), manager_info) except Exception as e: logger.warning(f"Could not get manager info for team {team_id}: {e}") manager_info = { "team_name": "Unknown", "manager_name": "Unknown", } # Build full result result = { "gameweek": gameweek, "team_id": team_id, "team_name": manager_info.get("team_name", "Unknown"), "manager_name": manager_info.get("manager_name", "Unknown"), "active": active_players, "bench": bench_players, "captain": next((p for p in formatted_picks if p["is_captain"]), None), "vice_captain": next((p for p in formatted_picks if p["is_vice_captain"]), None), } # Add gameweek history data if available if entry_history: result["points"] = entry_history.get("points", 0) result["total_points"] = entry_history.get("total_points", 0) result["rank"] = entry_history.get("rank", None) result["overall_rank"] = entry_history.get("overall_rank", None) or manager_info.get("overall_rank", 0) result["bank"] = entry_history.get("bank", 0) / 10.0 result["team_value"] = entry_history.get("value", 0) / 10.0 result["transfers"] = { "made": entry_history.get("event_transfers", 0), "cost": entry_history.get("event_transfers_cost", 0), } return result - Authenticated API helper that fetches raw team picks data for a gameweek from the FPL API endpoint, with caching.
async def get_team_for_gameweek(self, team_id: Optional[int] = None, gameweek: int = 1) -> Dict[str, Any]: """Get team picks for a specific gameweek""" team_id = team_id or self._team_id if not team_id: raise ValueError("Team ID must be provided") cache_key = f"team_gw_{team_id}_{gameweek}" cached_data = cache.cache.get(cache_key) if cached_data: # Use cached data if available (these don't change once set) return cached_data[1] url = f"{FPL_API_BASE_URL}/entry/{team_id}/event/{gameweek}/picks/" data = await self.make_authed_request(url) # Cache this data indefinitely as historical data doesn't change cache.cache[cache_key] = (datetime.now().timestamp(), data) return data