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

{fpl_mcp_server-0.1.7.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.7
+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
@@ -43,7 +43,7 @@ This MCP server provides comprehensive FPL analysis capabilities through:
 
 - **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.1.7.dist-info → fpl_mcp_server-0.2.0.dist-info}/RECORD

@@ -10,26 +10,27 @@ 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=Sj7YgIL46wGrmkJq39rpJilPK3blK6oPI-hE2-lBdxY,535
+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=H3COvcHt7uqPyWMm_2SEaN2lgTgwA20lKuotVOdMe3I,5209
+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=B5K_jtp4MDqI_Wd3_6blEkDn2Qki_mym2WmDSrhzccs,13155
+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.1.7.dist-info/METADATA,sha256=m53_QwzJv3nkfvfsUgzE_urTaFhsX8jq4egiXr5bR8w,4788
-fpl_mcp_server-0.1.7.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-fpl_mcp_server-0.1.7.dist-info/entry_points.txt,sha256=b3R5hBUMTLVnCGl07NfK7kyq9NCKtpn5Q8OsY79pMek,49
-fpl_mcp_server-0.1.7.dist-info/licenses/LICENSE,sha256=HCDOcdX83voRU2Eip214yj6P_tEyjVjCsCW_sixZFPw,1071
-fpl_mcp_server-0.1.7.dist-info/RECORD,,
+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/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/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_by_team_id(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/tools/fixtures.py

@@ -22,6 +22,9 @@ class GetFixturesForGameweekInput(BaseModel):
     gameweek: int = Field(
         ..., description="Gameweek number to get fixtures for (1-38)", ge=1, le=38
     )
+    detailed: bool = Field(
+        default=False, description="Include detailed match stats (all available metrics)"
+    )
     response_format: ResponseFormat = Field(
         default=ResponseFormat.MARKDOWN,
         description="Output format: 'markdown' for human-readable or 'json' for machine-readable",
@@ -78,6 +81,7 @@ async def fpl_get_fixtures_for_gameweek(params: GetFixturesForGameweekInput) ->
     Args:
         params (GetFixturesForGameweekInput): Validated input parameters containing:
             - gameweek (int): Gameweek number between 1-38
+            - detailed (bool): Include detailed stats (default: False)
             - response_format (ResponseFormat): 'markdown' or 'json' (default: markdown)
 
     Returns:
@@ -111,26 +115,77 @@ async def fpl_get_fixtures_for_gameweek(params: GetFixturesForGameweekInput) ->
             result = {
                 "gameweek": params.gameweek,
                 "fixture_count": len(gw_fixtures_sorted),
-                "fixtures": [
-                    {
-                        "home_team": fixture.get("team_h_name"),
-                        "home_team_short": fixture.get("team_h_short"),
-                        "away_team": fixture.get("team_a_name"),
-                        "away_team_short": fixture.get("team_a_short"),
-                        "kickoff_time": fixture.get("kickoff_time"),
-                        "finished": fixture.get("finished"),
-                        "home_score": fixture.get("team_h_score")
-                        if fixture.get("finished")
-                        else None,
-                        "away_score": fixture.get("team_a_score")
-                        if fixture.get("finished")
-                        else None,
-                        "home_difficulty": fixture.get("team_h_difficulty"),
-                        "away_difficulty": fixture.get("team_a_difficulty"),
-                    }
-                    for fixture in gw_fixtures_sorted
-                ],
+                "fixtures": [],
             }
+
+            for fixture in gw_fixtures_sorted:
+                fixture_data = {
+                    "home_team": fixture.get("team_h_name"),
+                    "home_team_short": fixture.get("team_h_short"),
+                    "away_team": fixture.get("team_a_name"),
+                    "away_team_short": fixture.get("team_a_short"),
+                    "kickoff_time": fixture.get("kickoff_time"),
+                    "finished": fixture.get("finished"),
+                    "home_score": fixture.get("team_h_score") if fixture.get("finished") else None,
+                    "away_score": fixture.get("team_a_score") if fixture.get("finished") else None,
+                    "home_difficulty": fixture.get("team_h_difficulty"),
+                    "away_difficulty": fixture.get("team_a_difficulty"),
+                }
+
+                if params.detailed and fixture.get("stats"):
+                    stats = {}
+                    for stat in fixture.get("stats", []):
+                        if hasattr(stat, "model_dump"):
+                            stat_dict = stat.model_dump()
+                        elif hasattr(stat, "__dict__"):
+                            stat_dict = stat.__dict__
+                        else:
+                            stat_dict = stat
+
+                        identifier = stat_dict.get("identifier")
+                        if not identifier:
+                            continue
+
+                        stats[identifier] = {"h": [], "a": []}
+
+                        # Process home stats
+                        for item in stat_dict.get("h", []):
+                            if hasattr(item, "value"):
+                                value = item.value
+                                element = item.element
+                            else:
+                                value = item.get("value")
+                                element = item.get("element")
+
+                            stats[identifier]["h"].append(
+                                {
+                                    "name": store.get_player_name(element),
+                                    "value": value,
+                                    "element": element,
+                                }
+                            )
+
+                        # Process away stats
+                        for item in stat_dict.get("a", []):
+                            if hasattr(item, "value"):
+                                value = item.value
+                                element = item.element
+                            else:
+                                value = item.get("value")
+                                element = item.get("element")
+
+                            stats[identifier]["a"].append(
+                                {
+                                    "name": store.get_player_name(element),
+                                    "value": value,
+                                    "element": element,
+                                }
+                            )
+
+                    fixture_data["stats"] = stats
+
+                result["fixtures"].append(fixture_data)
+
             return format_json_response(result)
         else:
             output = [
@@ -159,6 +214,91 @@ async def fpl_get_fixtures_for_gameweek(params: GetFixturesForGameweekInput) ->
                     f"Difficulty: H:{fixture.get('team_h_difficulty')} A:{fixture.get('team_a_difficulty')}"
                 )
 
+                if params.detailed and fixture.get("stats"):
+                    stats_output = []
+                    # Filter for interesting stats or show all? Showing all as requested.
+                    # Common stats order: goals_scored, assists, own_goals, penalties_saved, penalties_missed, yellow_cards, red_cards, bonus, saves, bps
+                    priority_stats = [
+                        "goals_scored",
+                        "assists",
+                        "bonus",
+                        "yellow_cards",
+                        "red_cards",
+                        "saves",
+                    ]
+                    other_stats = []
+                    for s in fixture.get("stats", []):
+                        ident = s.identifier if hasattr(s, "identifier") else s.get("identifier")
+
+                        if ident and ident not in priority_stats:
+                            other_stats.append(ident)
+                    all_stats = priority_stats + other_stats
+
+                    for stat_name in all_stats:
+                        # Find stat data
+                        stat_data = None
+                        for s in fixture.get("stats", []):
+                            s_ident = (
+                                s.identifier if hasattr(s, "identifier") else s.get("identifier")
+                            )
+                            if s_ident == stat_name:
+                                stat_data = s
+                                break
+                        if not stat_data:
+                            continue
+
+                        # Convert to dict access if needed
+                        if hasattr(stat_data, "h"):
+                            h_items = stat_data.h
+                            a_items = stat_data.a
+                        else:
+                            h_items = stat_data.get("h", [])
+                            a_items = stat_data.get("a", [])
+
+                        if not h_items and not a_items:
+                            continue
+
+                        # Format stat line: Stat: Name (val), Name (val) (H) | Name (val) (A)
+                        h_strs = []
+                        for item in h_items:
+                            val = item.value if hasattr(item, "value") else item.get("value")
+                            elem = item.element if hasattr(item, "element") else item.get("element")
+                            h_strs.append(f"{store.get_player_name(elem)} ({val})")
+
+                        a_strs = []
+                        for item in a_items:
+                            val = item.value if hasattr(item, "value") else item.get("value")
+                            elem = item.element if hasattr(item, "element") else item.get("element")
+                            a_strs.append(f"{store.get_player_name(elem)} ({val})")
+
+                        stat_display = stat_name.replace("_", " ").title()
+                        if stat_name == "goals_scored":
+                            stat_display = "⚽ Goals"
+                        elif stat_name == "assists":
+                            stat_display = "🅰️ Assists"
+                        elif stat_name == "bonus":
+                            stat_display = "💎 Bonus"
+                        elif stat_name == "yellow_cards":
+                            stat_display = "🟨 Yellows"
+                        elif stat_name == "red_cards":
+                            stat_display = "🟥 Reds"
+                        elif stat_name == "saves":
+                            stat_display = "🧤 Saves"
+
+                        if h_strs or a_strs:
+                            line = f"   - **{stat_display}**: "
+                            if h_strs:
+                                line += f"{', '.join(h_strs)} ({home_name})"
+                            if h_strs and a_strs:
+                                line += " | "
+                            if a_strs:
+                                line += f"{', '.join(a_strs)} ({away_name})"
+                            stats_output.append(line)
+
+                    if stats_output:
+                        output.extend(stats_output)
+                        output.append("")  # Empty line separator
+
             result = "\n".join(output)
             truncated, _ = check_and_truncate(result, CHARACTER_LIMIT)
             return truncated