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

{fpl_mcp_server-0.1.6.dist-info → fpl_mcp_server-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fpl-mcp-server
-Version: 0.1.6
+Version: 0.2.0
 Summary: Fantasy Premier League MCP Server
 Project-URL: Homepage, https://github.com/nguyenanhducs/fpl-mcp
 Project-URL: Repository, https://github.com/nguyenanhducs/fpl-mcp
@@ -41,9 +41,9 @@ A comprehensive **Model Context Protocol (MCP)** server for Fantasy Premier Leag
 
 This MCP server provides comprehensive FPL analysis capabilities through:
 
-- **22 Interactive Tools** - Search players, analyze fixtures, compare managers, track transfers, and more
+- **17 Interactive Tools** - Search players, analyze fixtures, compare managers, track transfers, and more
 - **4 Data Resources** - access to players, teams, and gameweeks bootstrap data
-- **8 Strategy Prompts** - Structured templates for squad analysis, transfer planning, chip strategy, and captain selection
+- **9 Strategy Prompts** - Structured templates for gameweek analysis, squad analysis, transfer planning, chip strategy, and captain selection
 - **Smart Caching** - 4-hour cache for bootstrap data to minimize API calls while keeping data fresh
 - **Fuzzy Matching** - Find players even with spelling variations or nicknames
 - **Live Transfer Trends** - Track the most transferred in/out players for current gameweek

fpl_mcp_server-0.2.0.dist-info/RECORD

@@ -0,0 +1,36 @@
+src/cache.py,sha256=SeJAmddaY9507Ac5YRnbBBXGOQw_OwpIefB-kn11lDI,4604
+src/client.py,sha256=_Tv7TlXD5d3pvXb7AmMCgy3gbZqjOO9EedMORveRU4s,10493
+src/config.py,sha256=hfjW-W0gdH0PxmC6gEg-o9SqraajJ6gNy1SIlIOG-F4,845
+src/constants.py,sha256=8XkQH1rslnf6VWbJkVY6MmpgRhhS3wjFJhIoZWr91kg,839
+src/exceptions.py,sha256=Q8waMbF8Sr1s6lOoAB8-doX0v6EvqZopwQHGxNQ7m-w,2972
+src/formatting.py,sha256=aLiJWM2hJw68gyGJ1Nc1nPAyfoSIqwyjPE8svr-7ufo,10236
+src/main.py,sha256=C6wX96rm0-b1jSvU2BrTv47hw2FGktkwcqJ5nEM8t5U,977
+src/models.py,sha256=P5rIO-UjVQpLUlDQsDV5hw2Tn3s5Xcj6ye8xJkRizGc,10880
+src/rate_limiter.py,sha256=GLk3ZRFFvEZxkZAQd-pZ7UxQdrAAUVch3pxe_aMU-J8,3450
+src/state.py,sha256=seyygRhlz-K1GtG80os34tnNJ6UkAFA2rVFgupZG2tY,17531
+src/utils.py,sha256=WhcWQIXpc1vIjU8hyrGDJyKJSlcbVoG938k_3UMDlCM,7340
+src/validators.py,sha256=aU36TUNYWb26fvZH27Xnryrp8gve9DM2phvy7vEnAi8,6891
+src/prompts/__init__.py,sha256=AVJbJtW1A5mxntubqXLj9103WWigBITa7CxCoqAxX_w,572
+src/prompts/captain_recommendation.py,sha256=1FI69uS9wNkOZZNnenFBW_JXg9HKU4bEUmixTn-6GJ0,5706
+src/prompts/chips.py,sha256=zzv5bqr8HuUAkvXenonrTXVhwNYGMwH9OPSC-c-1Dtg,5524
+src/prompts/gameweek_analysis.py,sha256=70ieDAhSCPuUK0yrEkEPdpTG9TpjHfnMpszdVDoMDBI,3417
+src/prompts/league_analysis.py,sha256=bQN-tVC5FmrZEKTIfwM0eLaNc8mia42Qr34o4kaSJ1g,8297
+src/prompts/player_analysis.py,sha256=7BgF_h0us_vxPC5JrqKPsMs-395xrUvfpW0VJ4Bgon8,5234
+src/prompts/squad_analysis.py,sha256=JIDaGIWasDmbhrMpFwFy6MuKxZJFReo9Io8Kw_Ck98I,4266
+src/prompts/team_analysis.py,sha256=7ypoaTUvrQQeKsysrhdwbzMzjtI2KldB1ztfSGCZArE,4222
+src/prompts/team_selection.py,sha256=tDOiyQYTp-hyKlKVAdjGxZsr1xPfMgApWREjbMtNpXM,3847
+src/prompts/transfers.py,sha256=Gsfey4XmjyYYJcRFfoDl0oNZnAOGsRCt_Ro0ePv43o8,5543
+src/resources/__init__.py,sha256=i7nlLVSLtiIrLtOnyoMiK3KTFGEnct4LXApB4b6URFM,303
+src/resources/bootstrap.py,sha256=ViZsGYtr5YqiTtvM_YTkbCr6R6Z9vUBiVSGGI9wwI3s,6970
+src/tools/__init__.py,sha256=JjoMoMHrhFRMarpgtOS9AoS9604c0p-yFc0PXoITe-E,510
+src/tools/fixtures.py,sha256=KTIeoETbhq1dBv76moVDviHgjdOnoUD0tm3Zek_xO9M,19725
+src/tools/gameweeks.py,sha256=7skxUC6HoCj9hFC0YbjsMceVIhvvjFOoSdApe9JDfP0,8126
+src/tools/leagues.py,sha256=uRUs2gC4Czj-S8qucomI5x4HQ-I7GxRZI4b3E6KObCM,38024
+src/tools/players.py,sha256=_H2LP9s_yE9mD7zgcgVK__cwc4wdcHo9iUe3R6Llyn0,29691
+src/tools/teams.py,sha256=DknehKi6HIu2TSlKBqg91VWNONxLP4NIy99cH5TrWqo,7924
+src/tools/transfers.py,sha256=zpg0ueCRC6MhKiafhU4-gI0SzEzFYGvlZ2EnXqGoJkU,29466
+fpl_mcp_server-0.2.0.dist-info/METADATA,sha256=dVb06qo0fSl5Op3sCAryWeTQUE69-kTUdDvURarciwY,4807
+fpl_mcp_server-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+fpl_mcp_server-0.2.0.dist-info/entry_points.txt,sha256=b3R5hBUMTLVnCGl07NfK7kyq9NCKtpn5Q8OsY79pMek,49
+fpl_mcp_server-0.2.0.dist-info/licenses/LICENSE,sha256=HCDOcdX83voRU2Eip214yj6P_tEyjVjCsCW_sixZFPw,1071
+fpl_mcp_server-0.2.0.dist-info/RECORD,,

src/prompts/__init__.py

@@ -8,6 +8,7 @@ from ..tools import mcp
 from . import (
     captain_recommendation,  # noqa: F401
     chips,  # noqa: F401
+    gameweek_analysis,  # noqa: F401
     league_analysis,  # noqa: F401
     player_analysis,  # noqa: F401
     squad_analysis,  # noqa: F401

src/prompts/captain_recommendation.py

@@ -9,7 +9,9 @@ from ..tools import mcp
 
 
 @mcp.prompt()
-def recommend_captain(team_id: int, gameweek: int | None = None, response_format: str = "markdown") -> str:
+def recommend_captain(
+    team_id: int, gameweek: int | None = None, response_format: str = "markdown"
+) -> str:
     """
     Recommend optimal captain choices using xGI-based metrics and fixture analysis.
 
@@ -33,19 +35,16 @@ Act as an FPL Expert Analyst with 10+ years of experience. We do not play it saf
 
 ## 🚦 **Workflow & Efficiency**
 
-**DO NOT** analyze all 15 players in depth. That is inefficient.
-1.  **Get Squad**: Fetch manager's team.
-2.  **Shortlist**: Identify **3-5 Candidates** based on:
-    *   **Price**: > £7.0m (Premiums usually haul)
-    *   **Form**: > 4.0 PPG
-    *   **Context**: Key talismen (e.g., Salah, Haaland, Palmer, Saka) even if form is dip.
-3.  **Deep Dive**: Only fetch detailed stats (`fpl_compare_players`) for these 3-5 candidates.
+1.  **Tool**: `fpl_get_captain_recommendations(team_id={team_id}, gameweek={gameweek})`
+    *This tool automatically runs the Pro-Level Scoring Model defined below.*
+2.  **Review**: Analyze the return values (Score, Rationale, Metrics).
+3.  **Explain**: Use the framework below to justify the tool's recommendations.
 
 ---
 
 ## 📊 **Pro-Level Scoring Model (Max 100)**
 
-Calculate the **Captain Suitability Score** using this weighted matrix:
+The tool calculates the **Captain Suitability Score** using this weighted matrix. Use this context to explain the results:
 
 ### **1. Projected Points (Weight: 40%)**
 *The core engine. Can they score specific points this week?*
@@ -112,7 +111,7 @@ Calculate the **Captain Suitability Score** using this weighted matrix:
    • **Nailedness**: [Secure/Risk] - [Minutes played last 3 GWs]
    • **Explosiveness**: [Penalty Duties? / Haul Potential?]
 
-   **Why**: [2-3 sentence reasoning. Mention specific matchup weaknesses or player form.]
+   **Why**: [2-3 sentence reasoning using the Scoring Model. E.g. "Points for Elite Stats (40pts) + Weak Defense (30pts)..."]
    **Risk**: [Any rotation risk or injury flag? If none, say "None"]
 
    **Confidence**: [Justification, e.g., "Clear data leader, 15pt gap to #2"]
@@ -141,12 +140,10 @@ Calculate the **Captain Suitability Score** using this weighted matrix:
 
 ## 🔧 **Execution Plan**
 
-1.  **Tool**: `fpl_get_manager_by_team_id(team_id={team_id}, gameweek={gameweek})` -> Get squad.
-2.  **Tool**: `fpl_get_gameweek_fixtures` -> Scan for easy matchups.
-3.  **Process**: Filter squad for Shortlist (Premiums + Form + Easy Fixture).
-4.  **Tool**: `fpl_compare_players(player_names=[List of Shortlist Names])` -> Get xGI, Stats, Etc.
-5.  **Compute**: Apply Scoring Model.
-6.  **Output**: Generate Recommendation.
+1.  **Tool**: `fpl_get_captain_recommendations(team_id={team_id}, gameweek={gameweek})`
+    *Note: This tool handles the raw data fetching and scoring model calculation.*
+2.  **Process**: Review the tool's `recommendations` list.
+3.  **Output**: Format the top 3 recommendations as requested above.
 
 **Begin Analysis Now.**
 """

src/prompts/gameweek_analysis.py

@@ -0,0 +1,72 @@
+"""
+FPL MCP Prompts - Gameweek Analysis.
+
+Prompts to analyze detailed match reports and provide transfer advice for a gameweek.
+"""
+
+from ..state import store
+from ..tools import mcp
+from ..tools.fixtures import (
+    FindFixtureOpportunitiesInput,
+    GetFixturesForGameweekInput,
+    fpl_find_fixture_opportunities,
+    fpl_get_fixtures_for_gameweek,
+)
+
+
+@mcp.prompt()
+async def gameweek_analysis(gameweek: int | None = None) -> str:
+    """
+    Analyze detailed match reports for a specific gameweek.
+
+    Provides a comprehensive analysis of all matches in a gameweek, highlighting
+    key performers, tactical insights, and FPL implications based on detailed statistics.
+    Also suggests transfer targets based on upcoming fixtures and form.
+
+    Args:
+        gameweek: Gameweek number to analyze (defaults to current gameweek if None)
+    """
+    if gameweek is None:
+        gw_data = store.get_current_gameweek()
+        if not gw_data:
+            return "Error: Could not determine current gameweek."
+        gameweek = gw_data.id
+
+    # Fetch detailed fixtures
+    fixtures_input = GetFixturesForGameweekInput(gameweek=gameweek, detailed=True)
+    match_reports = await fpl_get_fixtures_for_gameweek(fixtures_input)
+
+    # Fetch simple fixture difficulty context for next 5 gameweeks
+    fixture_ops_input = FindFixtureOpportunitiesInput(num_gameweeks=5, max_teams=5)
+    fixture_opportunities = await fpl_find_fixture_opportunities(fixture_ops_input)
+
+    return f"""Analyze the following detailed match reports for Gameweek {gameweek}.
+
+**Match Reports:**
+{match_reports}
+
+**Upcoming Fixture Context (Next 5 GWs):**
+{fixture_opportunities}
+
+**Analysis Objectives:**
+1.  **Key Performers:** Identify the standout players based on goals, assists, and bonus points. Who is in top form?
+2.  **Tactical Insights:** Are there any noticeable trends? (e.g., high-scoring games, defensive masterclasses, specific teams dominating).
+3.  **FPL Implications:**
+    -   **Buy:** Comparison of assets who performed well.
+        -   **CRITICAL**: Cross-reference with Upcoming Fixture Context.
+        -   Generally prioritize players with good upcoming fixtures.
+        -   **EXCEPTION**: High-form elite players (fixture-proof) can be recommended even with tougher fixtures if their underlying stats are exceptional.
+        -   Flag 'Trap' assets: players in bad teams who scored once but have terrible fixtures/stats.
+    -   **Sell:** Notable failures or players who were benched/subbed early. Consider if it's a dip in form or a long-term issue.
+    -   **Watchlist:** interesting differentials or returning players.
+    -   **Analysis Depth**: When highlighting players, mention if their performance seems sustainable. Infer xG/xA quality from report descriptions if detailed stats suggest high involvement (e.g. many shots/key passes).
+4.  **Upcoming Outlook:** Based on this performance, who looks essential for the next gameweek?
+
+## 🔧 Tool Calls Strategy
+
+1.  **Deep Dive**: Use `fpl_get_player_details(player_name=...)` to check full history and upcoming fixtures for any player who catches your eye.
+2.  **Compare Options**: Use `fpl_compare_players(player_names=[...])` to decide between potential transfer targets.
+3.  **Check Manager**: If analyzing a specific rival, use `fpl_get_manager_by_team_id`.
+
+Provide a concise but deep analysis useful for an FPL manager making transfer decisions.
+"""

src/prompts/league_analysis.py

@@ -110,21 +110,28 @@ Step 1: Get league standings to find manager names and team IDs:
 Step 2: Compare managers using one of these approaches:
 
 **Option A - Individual manager analysis:**
-- Tool: `fpl_get_manager_gameweek_team`
+- Tool: `fpl_get_manager_by_team_id`
   - Parameters:
-    - manager_name: "Manager Name" (from league standings)
-    - league_id: {league_id}
+    - team_id: [Team ID] (found in standings)
     - gameweek: {gameweek}
   - Returns: Detailed team sheet with starting XI, bench, captain, transfers, points
 
-**Option B - Side-by-side comparison:**
+**Option B - Side-by-side comparison (General):**
 - Tool: `fpl_compare_managers`
   - Parameters:
-    - manager_names: ["Manager1", "Manager2", "Manager3"] (2-4 managers)
+    - manager_names: ["Manager1", "Manager2"]
     - league_id: {league_id}
     - gameweek: {gameweek}
   - Returns: Comparison with common players, differentials, captain choices
 
+**Option C - Deep Rival Analysis (Head-to-Head):**
+- Tool: `fpl_analyze_rival`
+  - Parameters:
+    - my_team_id: [Your Team ID]
+    - rival_team_id: [Rival Team ID]
+    - gameweek: {gameweek}
+  - Returns: Comprehensive stats, differentials, and threat assessment
+
 **Additional data sources:**
 - Resource `fpl://bootstrap/players` - All player details, ownership %, positions, prices
 - Resource `fpl://current-gameweek` - Current gameweek status and deadline information

src/prompts/player_analysis.py

@@ -123,12 +123,11 @@ Present side-by-side:
 
 ## 🔧 **Tool Calls**
 
-For each player, use:
-1. **`fpl://player/{{{{player_name}}}}/summary`** → Get comprehensive stats, fixtures, history
+1. **`fpl_compare_players(player_names=[p1, p2, ...])`** → Get comprehensive stats, fixtures, history side-by-side
    *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
+3. **`fpl_get_top_performers(num_gameweeks=5)`** → Benchmark against top xGI players
 
 ---
 

src/prompts/squad_analysis.py

@@ -22,115 +22,85 @@ def analyze_squad_performance(team_id: int, num_gameweeks: int = 5) -> str:
     """
     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.**
+**OBJECTIVE: Create a PRO-LEVEL transfer strategy using Underlying Stats (xGI), Fixture Swings, and Chip Strategy.**
 
 ---
 
-## 📊 **Performance Analysis Framework**
+## 🏗️ **Step 1: Strategic Context (The "Manager's Eye")**
 
-For each player in the squad, analyze:
+Before analyzing players, assess the macro state of the squad:
+1.  **Financial Health:**
+    - Check `bank` balance. Can we afford luxury upgrades?
+    - Check `value` trends.
+2.  **Chip Status:**
+    - Which chips are available? (Wildcard, Free Hit, Bench Boost, Triple Captain)
+    - **Strategy:** If Wildcard is available and squad has >4 "issues", suggest Wildcard.
+3.  **Fixture Scan (Next 5 GW):**
+    - Identify teams with **Major Fixture Swings** (turning Good → Bad or Bad → Good).
+    - *Target:* Players from teams entering a "green run".
+    - *Avoid:* Players from teams entering a "red run".
 
-### **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*
+## 📊 **Step 2: Player Performance Analysis (xGI Model)**
 
-- ⚠️ **Moderate Assets** (xGI/90 0.15-0.35): Acceptable for budget slots
-  *If negative delta <-2, potential buy-low candidates*
+Analyze each player using the **xGI Regression Model** (Output vs Expected):
 
-- 🚨 **Underperformers** (xGI/90 <0.15): Transfer candidates
-  *Low underlying output + poor fixtures = priority sell*
+### **The Regression Framework:**
+- **xGI Delta** = `Actual G+A` - `Expected GI (xG + xA)`
+- **Interpretation:**
+    - **Huge Overperformance (+3.0+)**: *Elite Finisher* (e.g., Salah/Son) OR *Luck*? -> **HOLD** unless fixtures turn terrible.
+    - **Significant Underperformance (-2.0 to -3.0)**: *Unlucky*. If xGI is high (>0.5/90), **KEEP** or even **CAPTAIN**.
+    - **Poor Underlying (xGI < 0.2/90)**: *Ghosting*. Regardless of points, this is a **SELL** priority.
 
-**Defenders/Goalkeepers:**
-- Use defensive contribution + clean sheet odds instead of xGI
-- xGC (Expected Goals Conceded) if available
+### **Categorization:**
+- 🛡️ **Defensive Rocks**: Clean sheet potential + BP system appeal.
+- 🚜 **Workhorses**: Consistent xGI (0.4-0.6), nailed minutes.
+- 💣 **Explosive Differentials**: High xGI but low ownership (<10%).
+- 📉 **Dead Wood**: Low xGI + Bad Fixtures + Rotation Risk.
 
 ---
 
-## 🔍 **Transfer Priority Analysis**
+## 🔄 **Step 3: Transfer Planning (The "Next 3 Moves")**
 
-### **For Each Underperformer (xGI/90 <0.15 OR injured):**
+Instead of just "Buy X", provide a 3-Gameweek Plan:
 
-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"
+**Scenario A: The Surgery** (3+ Issues)
+- **GW{num_gameweeks + 1}:** Sell [Player A] -> Buy [Target A] (Reason: Fixture Swing)
+- **GW{num_gameweeks + 2}:** Roll Transfer / Sell [Player B]
+- **Long-term:** target [Premium Asset] in GW{num_gameweeks + 3}
 
-2. **Availability Check:**
-   - Injured/Suspended → 🚨 **URGENT** (transfer immediately)
-   - DNP last 2 games → ⚠️ **HIGH** (rotation risk)
-   - Minutes <60% last {num_gameweeks} GW → 🟡 **MEDIUM**
+**Scenario B: The Luxury Move** (Squd is fine)
+- Upgrade specific position or build bank for future premium.
 
-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`
+**Prioritization Rules:**
+1.  **Injuries/Suspensions**: Immediate priority.
+2.  **Fixture Cliffs**: Selling players hitting a run of red fixtures.
+3.  **xGI Underperformers**: Selling players with low xGI (not just low points).
 
 ---
 
-## 📈 **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
+## 💡 **Recommendations & Targets**
 
-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)
+For each position (GKP, DEF, MID, FWD), recommend **Replacement Targets** based on:
+1.  **Fixture Swing**: Teams with Easiest Next 4 Games.
+2.  **Underlying Data**: Top xGI performers in those teams.
+3.  **Price Structure**: Must fit within budget (Bank + Sale Price).
 
 ---
 
-## 🔧 **Tool Calls**
+## 🔧 **Tool Calls Strategy**
 
-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
+1.  **Get Context**: `fpl_get_manager_by_team_id` (Squad, Bank, Rank) AND `fpl_get_manager_chips`.
+2.  **Scan Landscape**: `fpl_find_fixture_opportunities` (Identify teams to target).
+3.  **Analyze Squad**: `fpl_get_player_details` for current squad loop.
+4.  **Find Replacements**: `fpl_get_top_performers` (Cross-reference with Fixture Opportunities).
+5.  **Captaincy**: `fpl_get_captain_recommendations` for immediate GW.
 
 ---
 
-## ⚠️ **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
+## ⚠️ **Veteran Advice**
+- **Don't chase last week's points.** Look at who is *about* to score.
+- **Roll transfers** if the squad is healthy. 2 FTs is a superpower.
+- **Value < Points.** Don't hold a falling player just to save 0.1m if they aren't scoring.
 """

src/prompts/team_analysis.py

@@ -108,7 +108,8 @@ Calculate **rolling 3-GW average FDR**:
 
 ## 🔧 **Tool Calls**
 
-Use: `fpl://team/{team_name}/fixtures?num_gameweeks={num_gameweeks}`
+Use: `fpl_analyze_team_fixtures(team_name="{team_name}", num_gameweeks={num_gameweeks})`
+For broader analysis (finding ANY team with good fixtures), use `fpl_find_fixture_opportunities`.
 Enrich with: `fpl://bootstrap/teams` for opponent strength proxy (if xGC not available, use team strength rank)
 
 ---

src/prompts/transfers.py

@@ -150,11 +150,12 @@ Using `fpl_get_top_performers(num_gameweeks=5)`:
 
 ## 🔧 **Tool Calls**
 
-1. `fpl_get_manager_squad(team_id={team_id})` → Current squad with transfer context
+1. `fpl_get_manager_by_team_id(team_id={team_id})` → Current squad with transfer context
 2. `fpl_get_top_performers(num_gameweeks=5)` → Find high xGI players for replacements
-3. For each transfer candidate:
+3. Use `fpl_analyze_transfer(player_out=..., player_in=...)` to validate your top priority move.
+4. For other candidates:
    - `fpl://player/{{{{name}}}}/summary` → xG, xA, fixtures, status
-4. `fpl://bootstrap/players` → Price, ownership, transfer trends
+5. `fpl://bootstrap/players` → Price, ownership, transfer trends
 
 ---