fpl-mcp-server 0.1.6__py3-none-any.whl → 0.2.0__py3-none-any.whl

src/tools/leagues.py

@@ -115,6 +115,25 @@ class GetManagerByTeamIdInput(BaseModel):
     )
 
 
+class AnalyzeRivalInput(BaseModel):
+    """Input model for analyzing a rival manager."""
+
+    model_config = ConfigDict(str_strip_whitespace=True, validate_assignment=True)
+
+    my_team_id: int = Field(..., description="Your team ID", ge=1)
+    rival_team_id: int = Field(..., description="Rival's team ID", ge=1)
+    gameweek: int | None = Field(
+        default=None,
+        description="Gameweek to analyze (defaults to current)",
+        ge=1,
+        le=38,
+    )
+    response_format: ResponseFormat = Field(
+        default=ResponseFormat.MARKDOWN,
+        description="Output format: 'markdown' or 'json'",
+    )
+
+
 async def _create_client():
     """Create an unauthenticated FPL client for public API access and ensure data is loaded."""
     client = FPLClient(store=store)
@@ -641,7 +660,9 @@ async def fpl_get_manager_by_team_id(params: GetManagerByTeamIdInput) -> str:
         try:
             entry_data = await client.get_manager_entry(params.team_id)
         except Exception:
-            return f"Manager with team ID {params.team_id} not found. Verify the team ID is correct."
+            return (
+                f"Manager with team ID {params.team_id} not found. Verify the team ID is correct."
+            )
 
         team_name = entry_data.get("name", "Unknown Team")
         player_name = f"{entry_data.get('player_first_name', '')} {entry_data.get('player_last_name', '')}".strip()
@@ -651,7 +672,9 @@ async def fpl_get_manager_by_team_id(params: GetManagerByTeamIdInput) -> str:
         if gameweek is None:
             current_gw = store.get_current_gameweek()
             if not current_gw:
-                return "Error: Could not determine current gameweek. Please specify a gameweek number."
+                return (
+                    "Error: Could not determine current gameweek. Please specify a gameweek number."
+                )
             gameweek = current_gw.id
 
         # Fetch gameweek picks from API
@@ -752,3 +775,167 @@ async def fpl_get_manager_by_team_id(params: GetManagerByTeamIdInput) -> str:
 
     except Exception as e:
         return handle_api_error(e)
+
+
+@mcp.tool(
+    name="fpl_analyze_rival",
+    annotations={
+        "title": "Analyze FPL Rival",
+        "readOnlyHint": True,
+        "destructiveHint": False,
+        "idempotentHint": True,
+        "openWorldHint": True,
+    },
+)
+async def fpl_analyze_rival(params: AnalyzeRivalInput) -> str:
+    """
+    Compare your team against a specific rival manager.
+
+    Provides a comprehensive head-to-head analysis including:
+    - Points and Rank comparison
+    - Chip usage history
+    - Captaincy comparison
+    - Key Differentials (players they own that you don't)
+
+    Args:
+        params (AnalyzeRivalInput): Validated input parameters containing:
+            - my_team_id (int): Your team ID
+            - rival_team_id (int): Rival's team ID
+            - gameweek (int | None): Gameweek number (defaults to current)
+
+    Returns:
+        str: Detailed rival analysis and threat assessment
+
+    Examples:
+        - Compare me vs rival: my_team_id=123, rival_team_id=456
+        - Analyze past GW: my_team_id=123, rival_team_id=456, gameweek=10
+
+    Error Handling:
+        - Returns error if either team ID invalid
+        - Returns formatted error message if API fails
+    """
+    try:
+        client = await _create_client()
+
+        # Determine gameweek
+        gameweek = params.gameweek
+        if not gameweek:
+            current = store.get_current_gameweek()
+            if not current:
+                return "Error: Could not determine current gameweek."
+            gameweek = current.id
+
+        # Fetch data for both managers
+        try:
+            my_entry = await client.get_manager_entry(params.my_team_id)
+            rival_entry = await client.get_manager_entry(params.rival_team_id)
+        except Exception:
+            return "Error: Could not retrieve manager details. Check Team IDs."
+
+        my_picks_data = await client.get_manager_gameweek_picks(params.my_team_id, gameweek)
+        rival_picks_data = await client.get_manager_gameweek_picks(params.rival_team_id, gameweek)
+
+        my_name = f"{my_entry.get('player_first_name')} {my_entry.get('player_last_name')}"
+        rival_name = f"{rival_entry.get('player_first_name')} {rival_entry.get('player_last_name')}"
+
+        my_team_name = my_entry.get("name")
+        rival_team_name = rival_entry.get("name")
+
+        # Extract picks (Starting XI + Bench)
+        my_picks = my_picks_data.get("picks", [])
+        rival_picks = rival_picks_data.get("picks", [])
+
+        # Helper to get active players (Starting XI - first 11)
+        # Note: Position 1-11 are starters, 12-15 bench
+        my_starters = {p["element"] for p in my_picks if p["position"] <= 11}
+        rival_starters = {p["element"] for p in rival_picks if p["position"] <= 11}
+
+        # Differentials (My unique vs Rival unique)
+        my_unique = my_starters - rival_starters
+        rival_unique = rival_starters - my_starters
+        common = my_starters & rival_starters
+
+        # Captains
+        my_cap = next((p for p in my_picks if p["is_captain"]), None)
+        rival_cap = next((p for p in rival_picks if p["is_captain"]), None)
+
+        my_cap_name = store.get_player_name(my_cap["element"]) if my_cap else "None"
+        rival_cap_name = store.get_player_name(rival_cap["element"]) if rival_cap else "None"
+
+        # Stats
+        my_history = my_picks_data.get("entry_history", {})
+        rival_history = rival_picks_data.get("entry_history", {})
+
+        if params.response_format == ResponseFormat.JSON:
+            result = {
+                "gameweek": gameweek,
+                "managers": {
+                    "me": {
+                        "name": my_name,
+                        "team": my_team_name,
+                        "points": my_history.get("points"),
+                        "rank": my_history.get("overall_rank"),
+                    },
+                    "rival": {
+                        "name": rival_name,
+                        "team": rival_team_name,
+                        "points": rival_history.get("points"),
+                        "rank": rival_history.get("overall_rank"),
+                    },
+                },
+                "comparison": {
+                    "common_players_count": len(common),
+                    "differentials_count": len(rival_unique),
+                    "points_diff": my_history.get("points", 0) - rival_history.get("points", 0),
+                },
+                "captains": {"me": my_cap_name, "rival": rival_cap_name},
+                "rival_differentials": [store.get_player_name(pid) for pid in rival_unique],
+            }
+            return format_json_response(result)
+
+        # Markdown Output
+        output = [
+            f"## Rival Analysis: {my_name} vs {rival_name}",
+            f"**Gameweek {gameweek}**",
+            "",
+            "### 🏆 Performance & Rank",
+            f"| Metric | 👤 You ({my_team_name}) | 🆚 Rival ({rival_team_name}) | Diff |",
+            "| :--- | :--- | :--- | :--- |",
+            f"| **GW Points** | {my_history.get('points', 0)} | {rival_history.get('points', 0)} | {my_history.get('points', 0) - rival_history.get('points', 0):+d} |",
+            f"| **Total Pts** | {my_history.get('total_points', 0)} | {rival_history.get('total_points', 0)} | {my_history.get('total_points', 0) - rival_history.get('total_points', 0):+d} |",
+            f"| **Rank** | {my_history.get('overall_rank', 0):,} | {rival_history.get('overall_rank', 0):,} | --- |",
+            f"| **Captain** | {my_cap_name} | {rival_cap_name} | {'✅ Same' if my_cap['element'] == rival_cap['element'] else '⚠️ Diff'} |",
+            f"| **Chip** | {my_picks_data.get('active_chip') or 'None'} | {rival_picks_data.get('active_chip') or 'None'} | --- |",
+            "",
+            "### ⚠️ Threat Assessment (Differentials)",
+            "Players in their starting XI that you DO NOT have:",
+            "",
+        ]
+
+        if rival_unique:
+            for pid in rival_unique:
+                p_name = store.get_player_name(pid)
+                # Get live points if possible
+                p_data = next((p for p in store.bootstrap_data.elements if p.id == pid), None)
+                points = p_data.event_points if p_data else "?"
+                output.append(f"- **{p_name}** ({points} pts)")
+        else:
+            output.append("No starting XI differentials! You have a full template match.")
+
+        output.append("")
+        output.append("### 🛡️ Your Advantages")
+        output.append("Players you have that they don't:")
+
+        if my_unique:
+            for pid in my_unique:
+                p_name = store.get_player_name(pid)
+                p_data = next((p for p in store.bootstrap_data.elements if p.id == pid), None)
+                points = p_data.event_points if p_data else "?"
+                output.append(f"- **{p_name}** ({points} pts)")
+        else:
+            output.append("No unique players.")
+
+        return "\n".join(output)
+
+    except Exception as e:
+        return handle_api_error(e)