fpl-mcp-server 0.1.3__py3-none-any.whl

src/prompts/league_analysis.py

@@ -0,0 +1,250 @@
+"""
+FPL MCP Prompts - League Analysis and Differentials.
+
+Prompts guide the LLM in analyzing league standings, comparing
+managers, and finding differential players.
+"""
+
+from ..tools import mcp
+
+
+@mcp.prompt()
+def compare_managers(league_id: int, gameweek: int, *manager_names: str) -> str:
+    """
+    Generate a prompt for comparing managers' teams in a league.
+
+    This prompt guides the LLM to analyze differences in team selection,
+    strategy, and performance between multiple managers.
+
+    Args:
+        league_id: ID of the league (from FPL URL)
+        gameweek: Gameweek number to analyze
+        *manager_names: Variable number of manager names (2-4 managers)
+    """
+    managers_str = ", ".join(manager_names) if manager_names else "{{manager1}}, {{manager2}}, ..."
+    num_managers = len(manager_names) if manager_names else "2-4"
+
+    return f"""Compare these managers' teams in league {league_id} for Gameweek {gameweek}: {managers_str}
+
+**Comparison Framework:**
+
+Analyze {num_managers} managers across multiple dimensions:
+
+1. **Performance Summary:**
+   For each manager:
+   - Gameweek points scored
+   - Overall rank
+   - Total points for season
+   - Transfers made and cost
+   - Points left on bench
+
+2. **Team Selection Analysis:**
+
+   **Captain Choices:**
+   - Who did each manager captain?
+   - Captain points scored
+   - Was it a differential or template choice?
+
+   **Formation & Structure:**
+   - Formation used (e.g., 3-4-3, 4-3-3)
+   - Premium player allocation
+   - Budget distribution
+
+3. **Player Overlap Analysis:**
+
+   **Common Players:**
+   - Players owned by all managers
+   - Template players (high ownership)
+   - How many players in common?
+
+   **Differential Picks:**
+   - Unique players per manager
+   - Which differentials performed well?
+   - Which differentials flopped?
+
+4. **Strategic Decisions:**
+
+   **Chip Usage:**
+   - Did anyone use a chip this gameweek?
+   - Impact of chip usage on points
+
+   **Transfer Strategy:**
+   - Number of transfers made
+   - Points hit taken (if any)
+   - Transfer effectiveness
+
+5. **Performance Drivers:**
+
+   **Why did one manager outperform?**
+   - Better captain choice?
+   - Successful differentials?
+   - Avoided blanks?
+   - Chip usage?
+
+   **Key Differences:**
+   - Tactical variations
+   - Risk vs safety approach
+   - Budget allocation differences
+
+6. **Bench Analysis:**
+   - Points left on bench per manager
+   - Bench strength comparison
+   - Auto-substitutions made
+
+7. **xGI-Based Differential Analysis:**
+
+   For each unique differential pick:
+   - **xGI Output**: Player's xGI/90 over last 5 GW
+   - **xGI Delta**: Actual G+A minus xG+xA
+     * Positive delta (+2+): Overperformed (lucky haul, may not repeat)
+     * Negative delta (-2+): Underperformed (unlucky, due for improvement)
+   - **Verdict**: Was the differential choice based on strong underlying stats or recency bias?
+
+**Data Access:**
+
+Step 1: Get league standings to find manager names and team IDs:
+- Tool: `fpl_get_league_standings`
+  - Parameters: league_id={league_id}
+  - Returns: List of managers with their team_id, entry_name, player_name, and points
+
+Step 2: Compare managers using one of these approaches:
+
+**Option A - Individual manager analysis:**
+- Tool: `fpl_get_manager_gameweek_team`
+  - Parameters:
+    - manager_name: "Manager Name" (from league standings)
+    - league_id: {league_id}
+    - gameweek: {gameweek}
+  - Returns: Detailed team sheet with starting XI, bench, captain, transfers, points
+
+**Option B - Side-by-side comparison:**
+- Tool: `fpl_compare_managers`
+  - Parameters:
+    - manager_names: ["Manager1", "Manager2", "Manager3"] (2-4 managers)
+    - league_id: {league_id}
+    - gameweek: {gameweek}
+  - Returns: Comparison with common players, differentials, captain choices
+
+**Additional data sources:**
+- Resource `fpl://bootstrap/players` - All player details, ownership %, positions, prices
+- Resource `fpl://current-gameweek` - Current gameweek status and deadline information
+- For differentials: `fpl://player/{{{{player_name}}}}/summary` - Get xG, xA, xGI data
+
+**Output Format:**
+1. Performance summary table
+2. Captain choices comparison
+3. Common players list
+4. Unique selections per manager
+5. Key performance drivers analysis (include xGI context for differentials)
+6. Strategic insights:
+   - What worked well? (underlying stats or luck?)
+   - What didn't work? (poor xGI or unlucky?)
+   - Lessons learned
+7. Recommendations for catching up (if behind)"""
+
+
+@mcp.prompt()
+def find_league_differentials(league_id: int, max_ownership: float = 30.0) -> str:
+    """
+    Generate a prompt for finding differential players in a league.
+
+    This prompt guides the LLM to identify low-owned players that could
+    provide a competitive advantage in a specific league.
+
+    Args:
+        league_id: ID of the league to analyze
+        max_ownership: Maximum ownership % to consider as differential (default: 30%)
+    """
+    return f"""Find differential players for competitive advantage in league {league_id}.
+
+**Differential Analysis Framework:**
+
+1. **Definition:**
+   Differentials are players owned by <{max_ownership}% of managers in your league
+   who have strong potential for points.
+
+2. **League Context Analysis:**
+   - Total managers in league
+   - Current league standings
+   - Template players (high ownership)
+   - Common captain choices
+
+3. **Differential Categories:**
+
+   **Premium Differentials (£9m+):**
+   - High-priced players with low league ownership
+   - Potential for big hauls
+   - Higher risk but higher reward
+
+   **Mid-Price Differentials (£6-9m):**
+   - Value picks with good fixtures
+   - Consistent performers
+   - Lower risk, steady returns
+
+   **Budget Differentials (<£6m):**
+   - Enablers with attacking potential
+   - Rotation risks but cheap
+   - Good for bench options
+
+4. **Evaluation Criteria (xGI-Based):**
+   For each differential candidate:
+
+   **Primary Metrics:**
+   - **xGI/90**: Expected goal involvements per 90 minutes (last 5 GW)
+     * >0.6 = Elite differential (rare but high upside)
+     * 0.4-0.6 = Strong differential (good balance of risk/reward)
+     * 0.2-0.4 = Budget differential (acceptable for cheap options)
+     * <0.2 = Avoid (poor underlying output)
+
+   - **xGI Delta**: Actual G+A minus xG+xA
+     * Negative delta (-2+): Unlucky, prime differential opportunity (buy low)
+     * Near zero: Performing to expectation
+     * Positive delta (+2+): Lucky, avoid (regression risk)
+
+   **Secondary Metrics:**
+   - Upcoming fixture difficulty (next 4-6 GW)
+   - Minutes played % (rotation risk if <70%)
+   - Injury status
+   - League ownership % vs global ownership %
+   - Price and value
+
+5. **Strategic Recommendations:**
+
+   **When to use differentials:**
+   - Chasing league leaders (need to take risks)
+   - Good fixture runs ahead
+   - Template players have tough fixtures
+
+   **When to avoid differentials:**
+   - Leading the league (play it safe)
+   - Differential has injury concerns
+   - Rotation risk too high
+
+6. **Risk Assessment:**
+   - High Risk: Low ownership, rotation risk, tough fixtures
+   - Medium Risk: Moderate ownership, some rotation, mixed fixtures
+   - Low Risk: Decent ownership, nailed on, good fixtures
+
+**Data Access:**
+- Use tool `fpl_get_league_standings` with league ID - League ownership patterns
+- Tool `fpl_get_top_performers` - Identify current form players to find differential opportunities
+- `fpl://bootstrap/players` - All players with ownership
+- `fpl://player/{{{{player_name}}}}/summary` - Detailed player analysis
+- `fpl://team/{{{{team_name}}}}/fixtures/{{{{num_gameweeks}}}}` - Fixture difficulty (default 5 GWs)
+
+**Output Format:**
+1. League template analysis (most owned players)
+2. Differential candidates by price bracket:
+   - Premium differentials
+   - Mid-price differentials
+   - Budget differentials
+3. For each differential:
+   - League ownership %
+   - Overall ownership %
+   - Form and fixtures
+   - Risk level
+   - Recommendation
+4. Strategic advice:
+   - Best differentials for your situation
+   - Timing for bringing them in
+   - Risk vs reward assessment"""

src/prompts/player_analysis.py

@@ -0,0 +1,141 @@
+"""
+FPL MCP Prompts - Player Comparison and Analysis.
+
+Prompts guide the LLM in comparing multiple players side-by-side
+for informed transfer decisions.
+"""
+
+from ..tools import mcp
+
+
+@mcp.prompt()
+def compare_players(*player_names: str) -> str:
+    """
+    Compare players using underlying metrics and probability-based projections.
+
+    This prompt prioritizes xG/xA/xGI over retrospective points, identifies positive/negative
+    regression candidates, and accounts for ownership context.
+
+    Args:
+        *player_names: 2-5 player names to compare
+    """
+    players_str = ", ".join(player_names) if player_names else "{{player1}}, {{player2}}, ..."
+
+    return f"""Compare these FPL players: {players_str}
+
+**CRITICAL: Prioritize underlying stats over retrospective points. Identify regression candidates.**
+
+---
+
+## 📊 **Comparison Matrix**
+
+For each player, extract and compare:
+
+### **1. Underlying Output Metrics (PRIMARY)**
+- **npxG (Non-Penalty Expected Goals)**: Total over last 5 GW + per 90 min
+- **xA (Expected Assists)**: Total over last 5 GW + per 90 min
+- **xGI (Expected Goal Involvements)**: npxG + xA over last 5 GW + per 90 min
+- **Big Chances Received**: Count over last 5 GW (proxy for service quality)
+- **Touches in Penalty Box**: Per 90 min (attackers only)
+- **Defensive Contribution**: Per 90 min (defenders/mids with defensive role)
+
+### **2. Regression Analysis (CRITICAL)**
+Calculate **xGI Delta** for each player:
+- `Actual G+A (last 5 GW)` MINUS `xG + xA (last 5 GW)`
+- **Positive Delta (+2 to +4)**: Player is OVERPERFORMING → Sell risk (negative regression incoming)
+- **Negative Delta (-2 to -4)**: Player is UNDERPERFORMING → BUY OPPORTUNITY (positive regression likely)
+- **Near Zero (-1 to +1)**: Performing to expectation → Stable asset
+
+### **3. Price Efficiency (Secondary)**
+- **Cost per xGI/90**: `Price ÷ (xGI per 90 minutes)`
+  *Lower = better value*
+- **Recent Price Changes**: +/-0.1m in last 7 days?
+  *Rising price = urgency to buy before lockout*
+- **Transfer Delta (last 3 GW)**: Net transfers in/out
+  *Rising ownership = potential price rise = urgency*
+
+### **4. Fixture Analysis (4-6 GW Horizon)**
+For next **6 gameweeks**:
+- **Average FDR**: Simple mean of fixture difficulty (1-5)
+- **Fixture Swing Detection**:
+  - If FDR drops by >1.0 after GW[X], note: "Target for GW[X] transfer"
+  - If DGW detected, FLAG with 🔥
+- **Home/Away Balance**: Defenders favor HOME fixtures (higher clean sheet odds)
+
+### **5. Ownership Context (Differential Math)**
+- **Global Ownership %**: From bootstrap data
+- **Effective Ownership (EO) Estimate**:
+  - If Top 100K avg = 25% but global = 15%, EO ≈ 25% (use Top 100K proxy)
+  - **Template Players**: EO >40% → Must own for *rank protection*
+  - **Differentials**: EO <15% → High risk, high reward if chasing rank
+
+### **6. Availability & Minutes Security**
+- **Status**: Available / Doubtful / Injured / Suspended
+- **Minutes Played (last 5 GW)**: Total + % of available minutes
+  *<75% of possible minutes = rotation risk*
+- **Benchings (last 5 GW)**: Count of games started on bench
+
+---
+
+## 🎯 **Output Format**
+
+### **1. Quick Comparison Table**
+Present side-by-side:
+
+| Metric | {players_str} |
+|--------|{"-" * (len(players_str) + 2)}|
+| **npxG (5 GW)** | ... |
+| **xA (5 GW)** | ... |
+| **xGI (5 GW)** | ... |
+| **xGI Delta** | ... (🔴 overperforming / 🟢 underperforming / ⚪ stable) |
+| **Cost/xGI per 90** | ... |
+| **Avg FDR (6 GW)** | ... |
+| **Ownership %** | ... |
+| **Minutes (5 GW)** | ... / 450 possible |
+
+### **2. Regression Insights**
+- **Positive Regression Targets** (underperforming xGI): [List players with negative delta]
+  → *"Buy low, sell high" candidates*
+- **Negative Regression Risks** (overperforming xGI): [List players with positive delta]
+  → *Consider selling before decline*
+
+### **3. Fixture Advantage**
+- **Best Fixtures (Next 6 GW)**: [Player with lowest avg FDR]
+- **Fixture Swing Alert**: [Any player with FDR drop >1.0]
+- **DGW Candidates**: [Flag any players in teams with DGW detected]
+
+### **4. Recommendation**
+
+**Best Overall Bet:**
+[Player name] — Justification using:
+- xGI/90 dominance
+- Positive regression potential (if negative xGI delta)
+- Fixture advantage
+- Price efficiency
+
+**Differential Pick (if chasing rank):**
+[Player with <15% ownership + strong xGI]
+
+**Avoid:**
+[Player with negative regression risk OR tough fixtures OR rotation risk]
+
+---
+
+## 🔧 **Tool Calls**
+
+For each player, use:
+1. **`fpl://player/{{{{player_name}}}}/summary`** → Get comprehensive stats, fixtures, history
+   *Provides: xG, xA, xGI, minutes, goals, assists, upcoming fixtures*
+2. **`fpl://bootstrap/players`** → Get ownership %, price, transfer trends
+   *Provides: selected_by_percent, now_cost, transfers_in/out_event*
+3. **`fpl_get_top_performers`** with `num_gameweeks=5` → Benchmark against top xGI players
+
+---
+
+## ⚠️ **Critical Rules**
+
+1. **NEVER recommend based on "form" or "PPG" alone** → Use xGI/90 + xGI delta
+2. **ALWAYS calculate xGI Delta** → Regression is the #1 alpha source
+3. **FLAG price rise urgency** → If transfers_in >50K last 3 days, note "Buy before rise"
+4. **Context ownership** → Template (>40%) vs. Differential (<15%)
+"""

src/prompts/squad_analysis.py

@@ -0,0 +1,136 @@
+"""
+FPL MCP Prompts - Squad Performance Analysis.
+
+Prompts guide the LLM in analyzing squad performance over recent gameweeks
+using underlying metrics and regression analysis.
+"""
+
+from ..tools import mcp
+
+
+@mcp.prompt()
+def analyze_squad_performance(team_id: int, num_gameweeks: int = 5) -> str:
+    """
+    Analyze squad performance using xGI-based metrics and regression analysis.
+
+    This prompt guides the LLM to identify underperforming/overperforming players
+    using underlying stats (xG, xA, xGI) rather than retrospective points.
+
+    Args:
+        team_id: FPL team ID of the manager to analyze
+        num_gameweeks: Number of recent gameweeks to analyze (default: 5)
+    """
+    return f"""Analyze FPL squad performance for team ID {team_id} over the last {num_gameweeks} gameweeks.
+
+**OBJECTIVE: Identify transfer targets using xGI-based regression analysis, not retrospective points.**
+
+---
+
+## 📊 **Performance Analysis Framework**
+
+For each player in the squad, analyze:
+
+### **1. Underlying Output Metrics (PRIMARY)**
+- **xGI/90 (Expected Goal Involvements per 90 min)**: Total xG + xA over last {num_gameweeks} GW, normalized per 90
+- **Minutes Played**: Total minutes + % of available minutes
+  *<60% = rotation risk*
+- **Games Played vs DNP**: Count starts, sub appearances, did not plays
+
+### **2. Regression Analysis (CRITICAL)**
+Calculate **xGI Delta** for each player:
+- `Actual G+A (last {num_gameweeks} GW)` MINUS `xG + xA (last {num_gameweeks} GW)`
+
+**Interpretation:**
+- **Positive Delta (+2 to +4)**: OVERPERFORMING → Likely to regress (sell candidate)
+- **Negative Delta (-2 to -4)**: UNDERPERFORMING → Due for improvement (keep/monitor)
+- **Near Zero (-1 to +1)**: Performing to expectation (stable)
+
+### **3. Player Categorization (xGI-Based)**
+
+Instead of arbitrary PPG thresholds, use xGI/90:
+
+- ⭐ **Elite Assets** (xGI/90 >0.6): Premium output, essential to keep
+  *Even if underperforming actual points (negative delta), underlying stats suggest improvement coming*
+
+- ✅ **Strong Contributors** (xGI/90 0.35-0.6): Reliable options, monitor for regression
+  *If positive delta >+2, consider selling before decline*
+
+- ⚠️ **Moderate Assets** (xGI/90 0.15-0.35): Acceptable for budget slots
+  *If negative delta <-2, potential buy-low candidates*
+
+- 🚨 **Underperformers** (xGI/90 <0.15): Transfer candidates
+  *Low underlying output + poor fixtures = priority sell*
+
+**Defenders/Goalkeepers:**
+- Use defensive contribution + clean sheet odds instead of xGI
+- xGC (Expected Goals Conceded) if available
+
+---
+
+## 🔍 **Transfer Priority Analysis**
+
+### **For Each Underperformer (xGI/90 <0.15 OR injured):**
+
+1. **Regression Context:**
+   - If negative xGI delta: "Unlucky, but underlying stats still poor → Sell"
+   - If positive xGI delta: "Overperforming low xGI → Definitely sell before regression"
+
+2. **Availability Check:**
+   - Injured/Suspended → 🚨 **URGENT** (transfer immediately)
+   - DNP last 2 games → ⚠️ **HIGH** (rotation risk)
+   - Minutes <60% last {num_gameweeks} GW → 🟡 **MEDIUM**
+
+3. **Fixture Difficulty (Next 4 GW):**
+   - Avg FDR >3.5 → Poor fixtures exacerbate low xGI
+   - Avg FDR <2.5 → Fixtures can't help poor underlying stats
+
+4. **Ownership Context:**
+   - If template player (>30% ownership): May need to hold for rank protection
+   - If differential (<10% ownership): Easy sell, minimal rank impact
+
+5. **Transfer Recommendation:**
+   - Provide urgency level: 🚨 URGENT / ⚠️ HIGH / 🟡 MEDIUM / 🟢 LOW
+   - Suggest xGI-based replacement targets from `fpl_get_top_performers`
+
+---
+
+## 📈 **Squad Health Summary**
+
+1. **Player Counts by Category:**
+   - Elite Assets (xGI/90 >0.6): [X] players
+   - Strong Contributors (xGI/90 0.35-0.6): [X] players
+   - Moderate Assets (xGI/90 0.15-0.35): [X] players
+   - Underperformers (xGI/90 <0.15): [X] players
+
+2. **Regression Risk Summary:**
+   - Players with xGI Delta >+2 (overperforming): [List names] → Potential sell targets
+   - Players with xGI Delta <-2 (underperforming): [List names] → Monitor for improvement
+
+3. **Priority Transfer Target:**
+   - **Player Name** (xGI/90: [X.XX], xGI Delta: [+/-X.X], Fixtures: [avg FDR])
+   - **Reason:** [injury / low xGI / rotation / regression risk]
+   - **Urgency:** [URGENT/HIGH/MEDIUM/LOW]
+
+4. **Overall Squad Health:**
+   - Healthy (8+ strong contributors) / Moderate (5-7) / Poor (<5)
+
+---
+
+## 🔧 **Tool Calls**
+
+Use these tools and resources:
+1. `fpl_get_manager_squad(team_id={team_id})` → Current squad composition
+2. `fpl_get_top_performers(num_gameweeks={num_gameweeks})` → Benchmark against top xGI players
+3. For each player:
+   - `fpl://player/{{{{player_name}}}}/summary` → xG, xA, xGI, minutes, fixtures
+4. `fpl://bootstrap/players` → Ownership %, price, transfer trends
+
+---
+
+## ⚠️ **Critical Rules**
+
+1. **NEVER categorize by PPG alone** → Use xGI/90 for attackers, defensive contribution for defenders
+2. **ALWAYS calculate xGI Delta** → Regression context is critical for sell decisions
+3. **Account for ownership** → Template players need more justification to sell
+4. **Prioritize injured/unavailable** → These are auto-sell regardless of xGI
+"""

src/prompts/team_analysis.py

@@ -0,0 +1,121 @@
+"""
+FPL MCP Prompts - Team Fixture Analysis.
+
+Prompts guide the LLM in analyzing team fixtures and identifying
+optimal times to invest in or avoid team assets using fixture swing methodology.
+"""
+
+from ..tools import mcp
+
+
+@mcp.prompt()
+def analyze_team_fixtures(team_name: str, num_gameweeks: int = 6) -> str:
+    """
+    Detect FDR trend shifts to time transfers optimally.
+
+    Accounts for:
+    - Fixture difficulty horizon (4-6 GW)
+    - DGW/BGW detection
+    - Home/away xG splits
+    - "Green arrow" timing (when to invest)
+
+    Args:
+        team_name: Team to analyze
+        num_gameweeks: Fixture horizon (default: 6 for trend detection)
+    """
+    return f"""Analyze {team_name}'s fixtures for OPTIMAL TRANSFER TIMING using FIXTURE SWING methodology.
+
+**OBJECTIVE: Identify "green arrow" periods (FDR improves) to time {team_name} asset acquisition.**
+
+---
+
+## 📅 **Fixture Difficulty Assessment (Next {num_gameweeks} GW)**
+
+For each upcoming fixture:
+
+### **1. Opponent Strength Proxy**
+Instead of static FDR (1-5), use:
+- **Opponent xGC (Expected Goals Conceded) per game** → Higher xGC = weaker defense = favorable for attackers
+- **Opponent xGA (Expected Goals Against) per game** → Lower xGA = weaker attack = favorable for defenders
+
+*Note: If xGC/xGA data unavailable, fall back to FDR but note as "proxy only"*
+
+### **2. Home/Away Context**
+For each fixture, note:
+- **{team_name} Home/Away**
+- **Historical Home/Away xG**: {team_name}'s average xG at home vs. away
+  *(Some teams like Newcastle are ELITE at home, average away)*
+
+### **3. Double/Blank Gameweek Detection**
+- **DGW**: If {team_name} plays TWICE in any GW → 🔥 **FLAG FOR CHIP STRATEGY**
+- **BGW**: If {team_name} BLANKS (no fixture) → ⚠️ **AVOID or FREE HIT**
+
+---
+
+## 📈 **Fixture Swing Analysis (CRITICAL)**
+
+Calculate **rolling 3-GW average FDR**:
+
+| GW | Opponent | FDR | Rolling 3-GW Avg FDR |
+|----|----------|-----|----------------------|
+| 23 | Liverpool (H) | 4 | 3.7 |
+| 24 | Bournemouth (A) | 2 | 3.3 |
+| 25 | Luton (H) | 1 | 2.3 👈 **SWING DETECTED** |
+| 26 | Fulham (A) | 2 | 1.7 |
+
+**SWING LOGIC:**
+- **Green Arrow** 🟢: Rolling avg drops by >1.0 → **OPTIMAL BUY WINDOW**
+  → *"Transfer in {team_name} assets before GW[X] to maximize good fixtures"*
+- **Red Arrow** 🔴: Rolling avg increases by >1.0 → **SELL WINDOW**
+  → *"Avoid {team_name} assets during GW[X]-[Y]"*
+
+---
+
+## 🎯 **Strategic Recommendations**
+
+### **For Attacking Assets (FWD/MID)**
+1. **Best Acquisition Window**: GW[X] (before fixture swing to easy run)
+   *Rationale: FDR drops from [avg] to [avg] starting GW[X+1]*
+2. **Captaincy Windows**: GW[Y], GW[Z] (lowest FDR + home fixtures)
+3. **Avoid Period**: GW[A]-[B] (FDR >3.5 avg)
+
+### **For Defensive Assets (DEF/GKP)**
+1. **Clean Sheet Windows**: GW[X], GW[Y] (opponent xGA <1.0 + home fixture)
+   *Note: Home fixtures ~15% more likely for clean sheets*
+2. **Bench These Weeks**: GW[Z] (facing Man City/Liverpool/Arsenal away)
+
+### **DGW/BGW Impact**
+- **If DGW Detected in GW[X]**:
+  → Priority for Bench Boost / Triple Captain
+  → Bring in {team_name} assets on GW[X-1] wildcard
+- **If BGW Detected in GW[Y]**:
+  → Free Hit opportunity OR transfer out before GW[Y]
+
+---
+
+## 📊 **Overall Fixture Run Classification**
+
+- **GREEN (Favorable)**: Avg FDR <2.5 over {num_gameweeks} GW
+  → *"Strong buy window for {team_name} assets"*
+- **AMBER (Moderate)**: Avg FDR 2.5-3.5
+  → *"Selective buy — premium assets only"*
+- **RED (Difficult)**: Avg FDR >3.5
+  → *"Avoid {team_name} assets OR sell before this period"*
+
+**Current Classification**: [GREEN/AMBER/RED] (Avg FDR: [X.X])
+
+---
+
+## 🔧 **Tool Calls**
+
+Use: `fpl://team/{team_name}/fixtures?num_gameweeks={num_gameweeks}`
+Enrich with: `fpl://bootstrap/teams` for opponent strength proxy (if xGC not available, use team strength rank)
+
+---
+
+## ⚠️ **Critical Rules**
+
+1. **ALWAYS detect fixture swings** → Rolling 3-GW FDR changes >1.0
+2. **FLAG all DGW/BGW** → These override normal fixture logic
+3. **Account for home/away splits** → Especially for defensive assets
+"""