wc26-mcp 0.2.0 → 0.3.1

package/dist/index.js

@@ -7,10 +7,17 @@ import { teams } from "./data/teams.js";
 import { groups } from "./data/groups.js";
 import { venues } from "./data/venues.js";
 import { teamProfiles } from "./data/team-profiles.js";
+import { cityGuides } from "./data/city-guides.js";
+import { historicalMatchups } from "./data/historical-matchups.js";
+import { visaInfo } from "./data/visa-info.js";
+import { fanZones } from "./data/fan-zones.js";
+import { news } from "./data/news.js";
+import { injuries } from "./data/injuries.js";
+import { tournamentOdds } from "./data/odds.js";
 // ── Server setup ────────────────────────────────────────────────────
 const server = new McpServer({
     name: "wc26-mcp",
-    version: "0.2.0",
+    version: "0.3.1",
 });
 // ── Helpers ─────────────────────────────────────────────────────────
 function json(data) {
@@ -39,18 +46,27 @@ function haversineDistance(lat1, lng1, lat2, lng2) {
     return { miles: Math.round(km * 0.621371), km: Math.round(km) };
 }
 function convertTime(date, timeUtc, timezone) {
-    const dt = new Date(`${date}T${timeUtc}:00Z`);
-    const formatter = new Intl.DateTimeFormat("en-CA", {
-        timeZone: timezone,
-        year: "numeric", month: "2-digit", day: "2-digit",
-        hour: "2-digit", minute: "2-digit",
-        hour12: false,
-    });
-    const parts = Object.fromEntries(formatter.formatToParts(dt).map((p) => [p.type, p.value]));
-    return {
-        date: `${parts.year}-${parts.month}-${parts.day}`,
-        time: `${parts.hour}:${parts.minute}`,
-    };
+    try {
+        const dt = new Date(`${date}T${timeUtc}:00Z`);
+        const formatter = new Intl.DateTimeFormat("en-CA", {
+            timeZone: timezone,
+            year: "numeric", month: "2-digit", day: "2-digit",
+            hour: "2-digit", minute: "2-digit",
+            hour12: false,
+        });
+        const parts = Object.fromEntries(formatter.formatToParts(dt).map((p) => [p.type, p.value]));
+        return {
+            date: `${parts.year}-${parts.month}-${parts.day}`,
+            time: `${parts.hour}:${parts.minute}`,
+        };
+    }
+    catch {
+        return { date, time: timeUtc, error: `Invalid timezone "${timezone}". Use IANA format like "America/New_York" or "Europe/London".` };
+    }
+}
+function resolveTeam(input) {
+    const tid = input.toLowerCase();
+    return teams.find(t => t.id === tid || t.code.toLowerCase() === tid || t.name.toLowerCase() === tid);
 }
 function enrichMatch(m, timezone) {
     const venue = venues.find((v) => v.id === m.venue_id);
@@ -120,19 +136,23 @@ const matchStatuses = [
     "cancelled",
 ];
 server.registerTool("get_matches", {
+    annotations: { readOnlyHint: true },
     title: "Get Matches",
     description: "Query FIFA World Cup 2026 matches. Filter by date, date range, team, group, venue, round, or status. Returns enriched match data with team names, venue details, and local venue time. Optionally pass a timezone to convert match times to any IANA timezone.",
     inputSchema: z.object({
         date: z
             .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD format")
             .optional()
             .describe("Exact date in YYYY-MM-DD format"),
         date_from: z
             .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD format")
             .optional()
             .describe("Start of date range (YYYY-MM-DD), inclusive"),
         date_to: z
             .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD format")
             .optional()
             .describe("End of date range (YYYY-MM-DD), inclusive"),
         team: z
@@ -172,15 +192,34 @@ server.registerTool("get_matches", {
         result = result.filter((m) => m.date <= args.date_to);
     }
     if (args.team) {
-        const tid = args.team.toLowerCase();
-        const team = teams.find((t) => t.id === tid || t.code.toLowerCase() === tid);
-        const teamId = team?.id ?? tid;
-        result = result.filter((m) => m.home_team_id === teamId || m.away_team_id === teamId);
+        const team = resolveTeam(args.team);
+        if (!team) {
+            return json({
+                error: `Team '${args.team}' not found.`,
+                suggestion: "Use the get_teams tool to see all available teams and their IDs.",
+            });
+        }
+        result = result.filter((m) => m.home_team_id === team.id || m.away_team_id === team.id);
     }
     if (args.group) {
-        result = result.filter((m) => m.group?.toUpperCase() === args.group.toUpperCase());
+        const groupLetter = args.group.toUpperCase();
+        const validGroups = [...new Set(matches.map((m) => m.group).filter(Boolean))];
+        if (!validGroups.includes(groupLetter)) {
+            return json({
+                error: `Group '${args.group}' not found.`,
+                suggestion: `Valid groups: ${validGroups.sort().join(", ")}. Use the get_groups tool for full group details.`,
+            });
+        }
+        result = result.filter((m) => m.group?.toUpperCase() === groupLetter);
     }
     if (args.venue) {
+        const venueExists = venues.some((v) => v.id === args.venue);
+        if (!venueExists) {
+            return json({
+                error: `Venue '${args.venue}' not found.`,
+                suggestion: "Use the get_venues tool to see all available venues and their IDs.",
+            });
+        }
         result = result.filter((m) => m.venue_id === args.venue);
     }
     if (args.round) {
@@ -204,6 +243,7 @@ const confederations = [
     "OFC",
 ];
 server.registerTool("get_teams", {
+    annotations: { readOnlyHint: true },
     title: "Get Teams",
     description: "Query FIFA World Cup 2026 teams. Filter by group, confederation, or host status. Returns team details including FIFA ranking and flag emoji.",
     inputSchema: z.object({
@@ -238,6 +278,7 @@ server.registerTool("get_teams", {
 });
 // ── Tool: get_groups ────────────────────────────────────────────────
 server.registerTool("get_groups", {
+    annotations: { readOnlyHint: true },
     title: "Get Groups",
     description: "Get FIFA World Cup 2026 group details. Returns teams, venues, and match schedule for each group. Optionally filter to a specific group.",
     inputSchema: z.object({
@@ -258,6 +299,7 @@ server.registerTool("get_groups", {
 });
 // ── Tool: get_venues ────────────────────────────────────────────────
 server.registerTool("get_venues", {
+    annotations: { readOnlyHint: true },
     title: "Get Venues",
     description: "Query FIFA World Cup 2026 venues across the USA, Mexico, and Canada. Filter by country, city, or region. Returns full venue details including capacity, coordinates, and notable events.",
     inputSchema: z.object({
@@ -280,7 +322,7 @@ server.registerTool("get_venues", {
         result = result.filter((v) => v.country === args.country);
     }
     if (args.city) {
-        result = result.filter((v) => v.city.toLowerCase() === args.city.toLowerCase());
+        result = result.filter((v) => v.city.toLowerCase().includes(args.city.toLowerCase()));
     }
     if (args.region) {
         result = result.filter((v) => v.region === args.region);
@@ -292,15 +334,18 @@ server.registerTool("get_venues", {
 });
 // ── Tool: get_schedule ──────────────────────────────────────────────
 server.registerTool("get_schedule", {
+    annotations: { readOnlyHint: true },
     title: "Get Schedule",
     description: "Get the full FIFA World Cup 2026 tournament schedule organized by date. Optionally filter to a specific date range. Each day includes all matches with team names, venues, kick-off times (UTC), and local venue time. Optionally pass a timezone to convert all match times.",
     inputSchema: z.object({
         date_from: z
             .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD format")
             .optional()
             .describe("Start date (YYYY-MM-DD), defaults to tournament start (2026-06-11)"),
         date_to: z
             .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD format")
             .optional()
             .describe("End date (YYYY-MM-DD), defaults to tournament end (2026-07-19)"),
         timezone: z
@@ -340,6 +385,7 @@ server.registerTool("get_schedule", {
 });
 // ── Tool: get_team_profile ───────────────────────────────────────────
 server.registerTool("get_team_profile", {
+    annotations: { readOnlyHint: true },
     title: "Get Team Profile",
     description: "Get a detailed profile for any FIFA World Cup 2026 team. Returns coach, playing style, key players with clubs, World Cup history, and qualifying summary. Use team ID or FIFA code (e.g. 'usa', 'BRA', 'arg').",
     inputSchema: z.object({
@@ -348,8 +394,7 @@ server.registerTool("get_team_profile", {
             .describe("Team ID or FIFA code (e.g. 'usa', 'BRA', 'arg'). Case-insensitive."),
     }),
 }, async (args) => {
-    const tid = args.team.toLowerCase();
-    const team = teams.find((t) => t.id === tid || t.code.toLowerCase() === tid);
+    const team = resolveTeam(args.team);
     if (!team) {
         return json({
             error: `Team '${args.team}' not found.`,
@@ -374,14 +419,56 @@ server.registerTool("get_team_profile", {
                 world_cup_history: null,
                 qualifying_summary: "No qualifying data available.",
             }),
+        injury_report: injuries
+            .filter((i) => i.team_id === team.id)
+            .map((i) => ({
+            player: i.player,
+            position: i.position,
+            injury: i.injury,
+            status: i.status,
+            expected_return: i.expected_return,
+            last_updated: i.last_updated,
+        })),
+        tournament_odds: (() => {
+            const winnerOdds = tournamentOdds.tournament_winner.find((o) => o.team_id === team.id);
+            const groupPred = tournamentOdds.group_predictions.find((g) => g.group === team.group);
+            const darkHorse = tournamentOdds.dark_horses.find((d) => d.team_id === team.id);
+            return {
+                ...(winnerOdds ? { winner_odds: winnerOdds.odds, implied_probability: winnerOdds.implied_probability } : {}),
+                ...(groupPred ? {
+                    group_prediction: {
+                        favorites: groupPred.favorites.map((f) => teamName(f)),
+                        dark_horse: teamName(groupPred.dark_horse),
+                        narrative: groupPred.narrative,
+                    },
+                } : {}),
+                ...(darkHorse ? { dark_horse_pick: darkHorse.reason } : {}),
+            };
+        })(),
+        recent_news: news
+            .filter((n) => {
+            if (n.related_teams.includes(team.id))
+                return true;
+            // Fallback: text match on team name in title/summary
+            const text = `${n.title} ${n.summary}`.toLowerCase();
+            return text.includes(team.name.toLowerCase()) ||
+                (team.code !== "TBD" && text.includes(team.code.toLowerCase()));
+        })
+            .slice(0, 5)
+            .map((n) => ({ title: n.title, date: n.date, source: n.source, summary: n.summary, url: n.url })),
         related_tools: [
             "Use get_matches with team filter to see this team's match schedule",
             "Use get_groups to see this team's group rivals and venue assignments",
+            "Use get_visa_info to check entry requirements for this team's fans traveling to host countries",
+            "Use get_injuries for full injury details across all teams",
+            "Use get_odds for complete tournament predictions",
+            "Use get_news to see all World Cup headlines",
         ],
     });
 });
 // ── Tool: get_nearby_venues ──────────────────────────────────────────
 server.registerTool("get_nearby_venues", {
+    annotations: { readOnlyHint: true },
     title: "Get Nearby Venues",
     description: "Find venues near a given World Cup venue, sorted by distance. Useful for planning multi-match trips. Returns distance in miles and kilometers between all venue pairs.",
     inputSchema: z.object({
@@ -430,6 +517,199 @@ server.registerTool("get_nearby_venues", {
         ],
     });
 });
+// ── Tool: get_city_guide ────────────────────────────────────────────
+server.registerTool("get_city_guide", {
+    annotations: { readOnlyHint: true },
+    title: "Get City Guide",
+    description: "Get a travel guide for any FIFA World Cup 2026 host city. Returns highlights, getting there, food & drink recommendations, things to do, and local tips. Accepts venue ID (e.g. 'metlife'), city name (e.g. 'Miami'), or metro area name (e.g. 'New York'). Case-insensitive.",
+    inputSchema: z.object({
+        city: z
+            .string()
+            .describe("Venue ID (e.g. 'metlife'), city name (e.g. 'Miami Gardens'), or metro area (e.g. 'New York'). Case-insensitive."),
+    }),
+}, async (args) => {
+    const query = args.city.toLowerCase();
+    // Find matching venue + guide by venue ID, city name, or metro area
+    let venue;
+    let guide;
+    // Try venue ID first
+    venue = venues.find((v) => v.id === query);
+    if (venue) {
+        guide = cityGuides.find((g) => g.venue_id === venue.id);
+    }
+    // Try city name
+    if (!venue) {
+        venue = venues.find((v) => v.city.toLowerCase().includes(query));
+        if (venue) {
+            guide = cityGuides.find((g) => g.venue_id === venue.id);
+        }
+    }
+    // Try metro area
+    if (!guide) {
+        guide = cityGuides.find((g) => g.metro_area.toLowerCase() === query);
+        if (guide) {
+            venue = venues.find((v) => v.id === guide.venue_id);
+        }
+    }
+    // Try partial match on metro area (e.g. "new york" matches "New York City")
+    if (!guide) {
+        guide = cityGuides.find((g) => g.metro_area.toLowerCase().includes(query));
+        if (guide) {
+            venue = venues.find((v) => v.id === guide.venue_id);
+        }
+    }
+    // Try partial match on city name
+    if (!guide && !venue) {
+        venue = venues.find((v) => v.city.toLowerCase().includes(query));
+        if (venue) {
+            guide = cityGuides.find((g) => g.venue_id === venue.id);
+        }
+    }
+    if (!venue || !guide) {
+        return json({
+            error: `City '${args.city}' not found.`,
+            suggestion: "Use the get_venues tool to see all available host cities and venue IDs.",
+        });
+    }
+    return json({
+        venue: {
+            id: venue.id,
+            name: venue.name,
+            city: venue.city,
+            state_province: venue.state_province,
+            country: venue.country,
+            capacity: venue.capacity,
+            timezone: venue.timezone,
+            weather: venue.weather,
+        },
+        metro_area: guide.metro_area,
+        highlights: guide.highlights,
+        getting_there: guide.getting_there,
+        food_and_drink: guide.food_and_drink,
+        things_to_do: guide.things_to_do,
+        local_tips: guide.local_tips,
+        related_tools: [
+            "Use get_matches with venue filter to see matches at this venue",
+            "Use get_nearby_venues to find other stadiums near this city",
+            "Use get_visa_info to check entry requirements for fans traveling to this country",
+            "Use get_fan_zones to find fan festival locations in this city",
+        ],
+    });
+});
+// ── Tool: get_historical_matchups ────────────────────────────────────
+server.registerTool("get_historical_matchups", {
+    annotations: { readOnlyHint: true },
+    title: "Get Historical Matchups",
+    description: "Head-to-head World Cup history between any two teams. Returns all tournament meetings, aggregate stats, and a narrative summary. Accepts team ID or FIFA code (e.g. 'bra', 'ARG', 'england'). Also checks for a scheduled 2026 match between the pair.",
+    inputSchema: z.object({
+        team_a: z
+            .string()
+            .describe("First team — ID or FIFA code (e.g. 'bra', 'ARG', 'england'). Case-insensitive."),
+        team_b: z
+            .string()
+            .describe("Second team — ID or FIFA code (e.g. 'eng', 'FRA', 'germany'). Case-insensitive."),
+    }),
+}, async (args) => {
+    const teamA = resolveTeam(args.team_a);
+    const teamB = resolveTeam(args.team_b);
+    if (!teamA) {
+        return json({
+            error: `Team '${args.team_a}' not found.`,
+            suggestion: "Use the get_teams tool to see all available teams and their IDs.",
+        });
+    }
+    if (!teamB) {
+        return json({
+            error: `Team '${args.team_b}' not found.`,
+            suggestion: "Use the get_teams tool to see all available teams and their IDs.",
+        });
+    }
+    if (teamA.id === teamB.id) {
+        return json({
+            error: "Both inputs resolve to the same team. Please provide two different teams.",
+        });
+    }
+    // TBD team check
+    if (teamA.code === "TBD") {
+        return json({
+            note: `${teamA.name} has not been determined yet. Historical matchup data will be available once the playoff is decided.`,
+            team_b: { id: teamB.id, name: teamB.name, flag_emoji: teamB.flag_emoji },
+            related_tools: [
+                "Use what_to_know_now to check the latest tournament status including pending playoffs",
+                "Use get_team_profile to learn more about the confirmed team",
+            ],
+        });
+    }
+    if (teamB.code === "TBD") {
+        return json({
+            note: `${teamB.name} has not been determined yet. Historical matchup data will be available once the playoff is decided.`,
+            team_a: { id: teamA.id, name: teamA.name, flag_emoji: teamA.flag_emoji },
+            related_tools: [
+                "Use what_to_know_now to check the latest tournament status including pending playoffs",
+                "Use get_team_profile to learn more about the confirmed team",
+            ],
+        });
+    }
+    // Sort alphabetically for canonical lookup
+    const [first, second] = [teamA, teamB].sort((a, b) => a.id.localeCompare(b.id));
+    const record = historicalMatchups.find((h) => h.team_a === first.id && h.team_b === second.id);
+    // Check for a 2026 match between these teams
+    const upcoming2026 = matches.find((m) => (m.home_team_id === teamA.id && m.away_team_id === teamB.id) ||
+        (m.home_team_id === teamB.id && m.away_team_id === teamA.id));
+    const matchContext = upcoming2026
+        ? {
+            upcoming_2026_match: {
+                date: upcoming2026.date,
+                time_utc: upcoming2026.time_utc,
+                round: upcoming2026.round,
+                venue: venueName(upcoming2026.venue_id),
+                group: upcoming2026.group ?? undefined,
+            },
+        }
+        : {};
+    // No history found
+    if (!record) {
+        const profileA = teamProfiles.find((p) => p.team_id === first.id);
+        const profileB = teamProfiles.find((p) => p.team_id === second.id);
+        const firstTimerNote = (id, profile) => {
+            if (profile && profile.world_cup_history.appearances <= 1) {
+                const t = teams.find((t) => t.id === id);
+                return `${t?.name ?? id} is making their World Cup debut in 2026.`;
+            }
+            return null;
+        };
+        return json({
+            team_a: { id: first.id, name: first.name, flag_emoji: first.flag_emoji },
+            team_b: { id: second.id, name: second.name, flag_emoji: second.flag_emoji },
+            total_matches: 0,
+            summary: `${first.name} and ${second.name} have never met at a FIFA World Cup.`,
+            first_timer_notes: [firstTimerNote(first.id, profileA), firstTimerNote(second.id, profileB)].filter(Boolean),
+            ...matchContext,
+            related_tools: [
+                "Use get_team_profile to learn about each team's World Cup history",
+                "Use get_matches with team filter to see their 2026 schedules",
+            ],
+        });
+    }
+    // Return full matchup data
+    return json({
+        team_a: { id: first.id, name: first.name, flag_emoji: first.flag_emoji },
+        team_b: { id: second.id, name: second.name, flag_emoji: second.flag_emoji },
+        total_matches: record.total_matches,
+        team_a_wins: record.team_a_wins,
+        draws: record.draws,
+        team_b_wins: record.team_b_wins,
+        total_goals_team_a: record.total_goals_team_a,
+        total_goals_team_b: record.total_goals_team_b,
+        summary: record.summary,
+        meetings: record.meetings,
+        ...matchContext,
+        related_tools: [
+            "Use get_team_profile to learn more about either team",
+            "Use get_matches with team filter to see their 2026 schedules",
+        ],
+    });
+});
 // ── Tool: what_to_know_now ──────────────────────────────────────────
 const TOURNAMENT_DATES = {
     playoff_end: "2026-03-31",
@@ -460,11 +740,13 @@ const PHASE_LABELS = {
     tournament_over: "Tournament Complete",
 };
 server.registerTool("what_to_know_now", {
+    annotations: { readOnlyHint: true },
     title: "What to Know Now",
     description: "Zero-query temporal briefing for the FIFA World Cup 2026. No parameters needed — just brief me. Automatically detects the current tournament phase and returns the most relevant information for today. Optionally pass a date to simulate a different day, or a timezone for local times.",
     inputSchema: z.object({
         date: z
             .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD format")
             .optional()
             .describe("Override date in YYYY-MM-DD format (for testing different phases). Defaults to today."),
         timezone: z
@@ -509,6 +791,37 @@ server.registerTool("what_to_know_now", {
             title: "Venue Summary",
             content: `${venues.length} venues across 3 countries: ${venues.filter((v) => v.country === "USA").length} in USA, ${venues.filter((v) => v.country === "Mexico").length} in Mexico, ${venues.filter((v) => v.country === "Canada").length} in Canada.`,
         });
+        sections.push({
+            title: "Fan Zones",
+            content: `${fanZones.length} official FIFA Fan Festival and fan zone locations across all host cities. Free entry at most sites with live screenings, concerts, food, and interactive experiences.`,
+        });
+        // Key injuries
+        const activeInjuries = injuries.filter((i) => i.status !== "fit");
+        if (activeInjuries.length > 0) {
+            sections.push({
+                title: "Key Injuries to Watch",
+                content: activeInjuries.map((i) => ({
+                    player: i.player,
+                    team: teamName(i.team_id),
+                    status: i.status,
+                    injury: i.injury,
+                    expected_return: i.expected_return,
+                })),
+            });
+        }
+        // Tournament favorites
+        sections.push({
+            title: "Tournament Favorites",
+            content: tournamentOdds.tournament_winner.slice(0, 8).map((o) => ({
+                team: teamName(o.team_id),
+                odds: o.odds,
+                implied_probability: o.implied_probability,
+            })),
+            dark_horses: tournamentOdds.dark_horses.map((d) => ({
+                team: teamName(d.team_id),
+                reason: d.reason,
+            })),
+        });
     }
     else if (phase === "post_playoff") {
         headline = `${daysUntilKickoff} days until the FIFA World Cup 2026 kicks off. All 48 teams are confirmed.`;
@@ -549,6 +862,37 @@ server.registerTool("what_to_know_now", {
                 content: marquee,
             });
         }
+        sections.push({
+            title: "Fan Zones",
+            content: `${fanZones.length} official FIFA Fan Festival and fan zone locations across all host cities. Free entry at most sites with live screenings, concerts, food, and interactive experiences.`,
+        });
+        // Key injuries
+        const activeInjuriesPost = injuries.filter((i) => i.status !== "fit");
+        if (activeInjuriesPost.length > 0) {
+            sections.push({
+                title: "Key Injuries to Watch",
+                content: activeInjuriesPost.map((i) => ({
+                    player: i.player,
+                    team: teamName(i.team_id),
+                    status: i.status,
+                    injury: i.injury,
+                    expected_return: i.expected_return,
+                })),
+            });
+        }
+        // Tournament favorites
+        sections.push({
+            title: "Tournament Favorites",
+            content: tournamentOdds.tournament_winner.slice(0, 8).map((o) => ({
+                team: teamName(o.team_id),
+                odds: o.odds,
+                implied_probability: o.implied_probability,
+            })),
+            dark_horses: tournamentOdds.dark_horses.map((d) => ({
+                team: teamName(d.team_id),
+                reason: d.reason,
+            })),
+        });
     }
     else if (phase === "group_stage") {
         const todayMatches = matches.filter((m) => m.date === today);
@@ -642,15 +986,30 @@ server.registerTool("what_to_know_now", {
             });
         }
     }
+    // Latest news (up to 5 most recent)
+    const recentNews = news
+        .filter((n) => n.date >= new Date(new Date(today).getTime() - 7 * 86400000).toISOString().slice(0, 10))
+        .slice(0, 5);
+    if (recentNews.length > 0) {
+        sections.push({
+            title: "Latest News",
+            articles: recentNews.map((n) => ({
+                title: n.title,
+                date: n.date,
+                source: n.source,
+                summary: n.summary,
+            })),
+        });
+    }
     const available_tools = [];
     if (phase === "pre_playoff" || phase === "post_playoff") {
-        available_tools.push("Use get_team_profile to research any team in depth", "Use get_groups to explore group compositions and match schedules", "Use get_venues to explore stadiums and host cities", "Use get_schedule to see the full tournament calendar");
+        available_tools.push("Use get_team_profile to research any team in depth", "Use get_groups to explore group compositions and match schedules", "Use get_venues to explore stadiums and host cities", "Use get_schedule to see the full tournament calendar", "Use get_visa_info to check entry requirements for any team's fans", "Use get_fan_zones to find fan festival locations in any host city", "Use get_news for more World Cup headlines", "Use get_injuries to check key player availability", "Use get_odds for tournament predictions and group previews");
     }
     else if (phase === "group_stage") {
-        available_tools.push("Use get_team_profile to research teams playing today", "Use get_matches to filter matches by team, group, or date", "Use get_groups to see full group standings and remaining fixtures");
+        available_tools.push("Use get_team_profile to research teams playing today", "Use get_matches to filter matches by team, group, or date", "Use get_groups to see full group standings and remaining fixtures", "Use get_fan_zones to find fan festival locations near today's matches", "Use get_news for more World Cup headlines", "Use get_injuries to check key player availability", "Use get_odds for tournament predictions and group previews");
     }
     else if (phase === "knockout") {
-        available_tools.push("Use get_team_profile to research teams still in the tournament", "Use get_matches with round filter to see knockout bracket", "Use get_schedule to see remaining match dates");
+        available_tools.push("Use get_team_profile to research teams still in the tournament", "Use get_matches with round filter to see knockout bracket", "Use get_schedule to see remaining match dates", "Use get_fan_zones to find fan festival locations near today's matches", "Use get_news for more World Cup headlines", "Use get_injuries to check key player availability");
     }
     else {
         available_tools.push("Use get_matches to review any match from the tournament", "Use get_team_profile to look up team details");
@@ -665,6 +1024,629 @@ server.registerTool("what_to_know_now", {
         available_tools,
     });
 });
+// ── Tool: get_visa_info ──────────────────────────────────────────────
+server.registerTool("get_visa_info", {
+    annotations: { readOnlyHint: true },
+    title: "Get Visa Info",
+    description: "Entry requirements for FIFA World Cup 2026 travelers. Returns visa/ESTA/eTA requirements for any team's nationals entering the three host countries (USA, Mexico, Canada). Accepts team ID, FIFA code, or country name. Optionally filter to a specific host country.",
+    inputSchema: z.object({
+        team: z
+            .string()
+            .describe("Team ID, FIFA code, or country name (e.g. 'bra', 'ARG', 'england'). Case-insensitive."),
+        host_country: z
+            .enum(["USA", "Mexico", "Canada"])
+            .optional()
+            .describe("Filter to a specific host country. Omit for all three."),
+    }),
+}, async (args) => {
+    const team = resolveTeam(args.team);
+    if (!team) {
+        return json({
+            error: `Team '${args.team}' not found.`,
+            suggestion: "Use the get_teams tool to see all available teams and their IDs.",
+        });
+    }
+    const info = visaInfo.find((v) => v.team_id === team.id);
+    if (!info) {
+        return json({
+            error: `No visa data available for ${team.name}.`,
+            team: { id: team.id, name: team.name, flag_emoji: team.flag_emoji },
+        });
+    }
+    const requirements = args.host_country
+        ? info.entry_requirements.filter((r) => r.country === args.host_country)
+        : info.entry_requirements;
+    return json({
+        team: {
+            id: team.id,
+            name: team.name,
+            flag_emoji: team.flag_emoji,
+            group: team.group,
+        },
+        nationality: info.nationality,
+        passport_country: info.passport_country,
+        entry_requirements: requirements,
+        related_tools: [
+            "Use get_city_guide for travel tips in each host city",
+            "Use get_matches with team filter to see where this team plays",
+            "Use get_venues to check which countries host their matches",
+        ],
+    });
+});
+// ── Tool: get_fan_zones ─────────────────────────────────────────────
+server.registerTool("get_fan_zones", {
+    annotations: { readOnlyHint: true },
+    title: "Get Fan Zones",
+    description: "Official FIFA Fan Festival and fan zone locations for World Cup 2026 host cities. Returns venue details, capacity, hours, activities, transportation tips, and amenities. Filter by city, country, or match venue.",
+    inputSchema: z.object({
+        city: z
+            .string()
+            .optional()
+            .describe("Filter by city name (e.g. 'Dallas', 'Mexico City', 'Toronto'). Case-insensitive."),
+        country: z
+            .enum(["USA", "Mexico", "Canada"])
+            .optional()
+            .describe("Filter by host country."),
+        venue_id: z
+            .string()
+            .optional()
+            .describe("Filter by match venue ID (e.g. 'metlife', 'azteca'). Returns fan zones associated with that stadium's city."),
+    }),
+}, async (args) => {
+    let results = fanZones;
+    if (args.venue_id) {
+        results = results.filter((fz) => fz.venue_id === args.venue_id);
+    }
+    if (args.country) {
+        results = results.filter((fz) => fz.country === args.country);
+    }
+    if (args.city) {
+        const city = args.city.toLowerCase();
+        const cityMatches = results.filter((fz) => fz.city.toLowerCase().includes(city));
+        if (cityMatches.length > 0) {
+            // Also include sibling zones sharing the same venue_id (e.g. NYNJ metro has 3 zones)
+            const venueIds = new Set(cityMatches.map((fz) => fz.venue_id));
+            results = results.filter((fz) => venueIds.has(fz.venue_id));
+        }
+        else {
+            // Try matching via venue name/city for alternate names
+            const matchingVenue = venues.find((v) => v.city.toLowerCase().includes(city) || v.name.toLowerCase().includes(city));
+            results = matchingVenue
+                ? results.filter((fz) => fz.venue_id === matchingVenue.id)
+                : [];
+        }
+    }
+    if (results.length === 0) {
+        return json({
+            error: "No fan zones found matching your criteria.",
+            suggestion: "Try get_fan_zones without filters to see all 18 fan zones, or use get_venues to find valid venue IDs.",
+            available_countries: ["USA", "Mexico", "Canada"],
+        });
+    }
+    return json({
+        count: results.length,
+        fan_zones: results.map((fz) => ({
+            id: fz.id,
+            name: fz.name,
+            city: fz.city,
+            country: fz.country,
+            location: fz.location,
+            address: fz.address,
+            coordinates: fz.coordinates,
+            capacity: fz.capacity,
+            free_entry: fz.free_entry,
+            hours: fz.hours,
+            activities: fz.activities,
+            highlights: fz.highlights,
+            transportation: fz.transportation,
+            amenities: fz.amenities,
+            family_friendly: fz.family_friendly,
+            status: fz.status,
+            match_venue: venueName(fz.venue_id),
+        })),
+        related_tools: [
+            "Use get_city_guide for full travel info on any host city",
+            "Use get_venues to see stadium details",
+            "Use get_visa_info for entry requirements",
+        ],
+    });
+});
+// ── Tool: get_news ──────────────────────────────────────────────────
+const newsCategories = [
+    "roster", "venue", "schedule", "injury", "analysis",
+    "transfer", "qualifying", "fan-content", "logistics", "general",
+];
+server.registerTool("get_news", {
+    annotations: { readOnlyHint: true },
+    title: "Get News",
+    description: "Latest FIFA World Cup 2026 news from ESPN, BBC Sport, and Reddit. Auto-updated daily by the WC26 Scout Agent. Filter by team, category, or both. Returns AI-generated summaries and source links.",
+    inputSchema: z.object({
+        team: z
+            .string()
+            .optional()
+            .describe("Team ID or FIFA code (e.g. 'usa', 'BRA'). Filters news mentioning this team."),
+        category: z
+            .enum(newsCategories)
+            .optional()
+            .describe("News category to filter by."),
+        limit: z
+            .number()
+            .optional()
+            .describe("Max articles to return (default 10, max 50)."),
+    }),
+}, async (args) => {
+    if (news.length === 0) {
+        return json({
+            count: 0,
+            articles: [],
+            note: "No news articles available yet. The Scout Agent runs daily to fetch new articles.",
+            related_tools: [
+                "Use what_to_know_now for a tournament briefing",
+                "Use get_teams to browse participating teams",
+            ],
+        });
+    }
+    let filtered = news;
+    if (args.team) {
+        const team = resolveTeam(args.team);
+        if (!team) {
+            return json({
+                error: `Team '${args.team}' not found.`,
+                suggestion: "Use the get_teams tool to see all available teams and their IDs.",
+            });
+        }
+        filtered = filtered.filter((n) => n.related_teams.includes(team.id));
+    }
+    if (args.category) {
+        filtered = filtered.filter((n) => n.categories.includes(args.category));
+    }
+    const limit = Math.min(Math.max(args.limit ?? 10, 1), 50);
+    const result = filtered.slice(0, limit);
+    return json({
+        count: result.length,
+        total_available: filtered.length,
+        articles: result.map((n) => ({
+            id: n.id,
+            title: n.title,
+            date: n.date,
+            source: n.source,
+            url: n.url,
+            summary: n.summary,
+            categories: n.categories,
+            related_teams: n.related_teams,
+        })),
+        related_tools: [
+            "Use get_team_profile to learn more about a mentioned team",
+            "Use get_matches to check a team's schedule",
+            "Use what_to_know_now for a full tournament briefing",
+        ],
+    });
+});
+// ── Tool: get_injuries ────────────────────────────────────────────────
+const injuryStatuses = ["out", "doubtful", "recovering", "fit"];
+server.registerTool("get_injuries", {
+    annotations: { readOnlyHint: true },
+    title: "Get Injury Report",
+    description: "Key player injury tracker for the FIFA World Cup 2026. Track availability of star players across all 48 teams. Filter by team or injury status (out, doubtful, recovering, fit).",
+    inputSchema: z.object({
+        team: z
+            .string()
+            .optional()
+            .describe("Team ID or FIFA code (e.g. 'usa', 'BRA'). Filters to injuries for this team."),
+        status: z
+            .enum(injuryStatuses)
+            .optional()
+            .describe("Filter by injury status: out, doubtful, recovering, or fit."),
+    }),
+}, async (args) => {
+    let filtered = injuries;
+    if (args.team) {
+        const team = resolveTeam(args.team);
+        if (!team) {
+            return json({
+                error: `Team '${args.team}' not found.`,
+                suggestion: "Use the get_teams tool to see all available teams and their IDs.",
+            });
+        }
+        filtered = filtered.filter((i) => i.team_id === team.id);
+    }
+    if (args.status) {
+        filtered = filtered.filter((i) => i.status === args.status);
+    }
+    return json({
+        count: filtered.length,
+        injuries: filtered.map((i) => {
+            const team = teams.find((t) => t.id === i.team_id);
+            return {
+                player: i.player,
+                team: team ? `${team.flag_emoji} ${team.name}` : i.team_id,
+                team_id: i.team_id,
+                position: i.position,
+                injury: i.injury,
+                status: i.status,
+                expected_return: i.expected_return,
+                last_updated: i.last_updated,
+                source: i.source,
+            };
+        }),
+        related_tools: [
+            "Use get_team_profile to see a team's full squad and key players",
+            "Use get_news for the latest injury headlines",
+            "Use get_odds to see how injuries affect tournament predictions",
+        ],
+    });
+});
+// ── Tool: get_odds ───────────────────────────────────────────────────
+server.registerTool("get_odds", {
+    annotations: { readOnlyHint: true },
+    title: "Get Tournament Odds",
+    description: "FIFA World Cup 2026 betting odds and predictions. Tournament winner odds, Golden Boot favorites, group-by-group predictions, and dark horse picks. Illustrative odds aggregated from major bookmakers.",
+    inputSchema: z.object({
+        category: z
+            .enum(["winner", "golden_boot", "groups", "dark_horses", "all"])
+            .optional()
+            .describe("Which odds category to return. Defaults to 'all'."),
+        group: z
+            .string()
+            .optional()
+            .describe("Specific group (A-L) for group predictions."),
+    }),
+}, async (args) => {
+    const category = args.category ?? "all";
+    const enrichTeam = (tid) => {
+        const t = teams.find((t) => t.id === tid);
+        return t ? `${t.flag_emoji} ${t.name}` : tid;
+    };
+    const result = {
+        last_updated: tournamentOdds.last_updated,
+        source: tournamentOdds.source,
+    };
+    if (category === "winner" || category === "all") {
+        result.tournament_winner = tournamentOdds.tournament_winner.map((o) => ({
+            team: enrichTeam(o.team_id),
+            team_id: o.team_id,
+            odds: o.odds,
+            implied_probability: o.implied_probability,
+        }));
+    }
+    if (category === "golden_boot" || category === "all") {
+        result.golden_boot = tournamentOdds.golden_boot.map((o) => ({
+            player: o.player,
+            team: enrichTeam(o.team_id),
+            odds: o.odds,
+        }));
+    }
+    if (category === "groups" || category === "all") {
+        let groupPreds = tournamentOdds.group_predictions;
+        if (args.group) {
+            groupPreds = groupPreds.filter((g) => g.group.toUpperCase() === args.group.toUpperCase());
+        }
+        result.group_predictions = groupPreds.map((g) => ({
+            group: `Group ${g.group}`,
+            favorites: g.favorites.map(enrichTeam),
+            dark_horse: enrichTeam(g.dark_horse),
+            narrative: g.narrative,
+        }));
+    }
+    if (category === "dark_horses" || category === "all") {
+        result.dark_horses = tournamentOdds.dark_horses.map((d) => ({
+            team: enrichTeam(d.team_id),
+            team_id: d.team_id,
+            reason: d.reason,
+        }));
+    }
+    result.related_tools = [
+        "Use get_team_profile to research any team in depth",
+        "Use get_injuries to check key player availability",
+        "Use get_historical_matchups to see head-to-head records",
+    ];
+    return json(result);
+});
+// ── Tool: compare_teams ─────────────────────────────────────────────
+server.registerTool("compare_teams", {
+    annotations: { readOnlyHint: true },
+    title: "Compare Teams",
+    description: "Side-by-side comparison of any two FIFA World Cup 2026 teams. Rankings, odds, key players, group difficulty, injury concerns, and head-to-head history — all in one view. Accepts team ID, FIFA code, or country name.",
+    inputSchema: z.object({
+        team_a: z
+            .string()
+            .describe("First team — ID, FIFA code, or name (e.g. 'bra', 'ARG', 'england'). Case-insensitive."),
+        team_b: z
+            .string()
+            .describe("Second team — ID, FIFA code, or name (e.g. 'eng', 'FRA', 'germany'). Case-insensitive."),
+    }),
+}, async (args) => {
+    const teamA = resolveTeam(args.team_a);
+    const teamB = resolveTeam(args.team_b);
+    if (!teamA)
+        return json({ error: `Team '${args.team_a}' not found.`, suggestion: "Use get_teams to see all available teams." });
+    if (!teamB)
+        return json({ error: `Team '${args.team_b}' not found.`, suggestion: "Use get_teams to see all available teams." });
+    if (teamA.id === teamB.id)
+        return json({ error: "Both inputs resolve to the same team." });
+    function buildProfile(team) {
+        const profile = teamProfiles.find((p) => p.team_id === team.id);
+        const teamInjuries = injuries.filter((i) => i.team_id === team.id);
+        const winnerOdds = tournamentOdds.tournament_winner.find((o) => o.team_id === team.id);
+        const darkHorse = tournamentOdds.dark_horses.find((d) => d.team_id === team.id);
+        const groupPred = tournamentOdds.group_predictions.find((g) => g.group === team.group);
+        const groupTeams = teams.filter((t) => t.group === team.group && t.code !== "TBD");
+        const avgGroupRanking = groupTeams.length > 0
+            ? Math.round(groupTeams.reduce((s, t) => s + (t.fifa_ranking ?? 100), 0) / groupTeams.length)
+            : null;
+        return {
+            team: `${team.flag_emoji} ${team.name}`,
+            team_id: team.id,
+            group: team.group,
+            confederation: team.confederation,
+            fifa_ranking: team.fifa_ranking ?? null,
+            is_host: team.is_host,
+            coach: profile?.coach ?? "Unknown",
+            playing_style: profile?.playing_style ?? null,
+            key_players: profile?.key_players.slice(0, 5).map((p) => `${p.name} (${p.position}, ${p.club})`) ?? [],
+            world_cup_history: profile?.world_cup_history ?? null,
+            winner_odds: winnerOdds ? { odds: winnerOdds.odds, implied_probability: winnerOdds.implied_probability } : null,
+            dark_horse_pick: darkHorse?.reason ?? null,
+            group_difficulty: {
+                avg_ranking: avgGroupRanking,
+                group_prediction: groupPred ? {
+                    favorites: groupPred.favorites.map((f) => teamName(f)),
+                    dark_horse: teamName(groupPred.dark_horse),
+                } : null,
+            },
+            injuries: teamInjuries.map((i) => ({
+                player: i.player,
+                status: i.status,
+                injury: i.injury,
+                expected_return: i.expected_return,
+            })),
+        };
+    }
+    // Head-to-head
+    const [first, second] = [teamA, teamB].sort((a, b) => a.id.localeCompare(b.id));
+    const h2h = historicalMatchups.find((h) => h.team_a === first.id && h.team_b === second.id);
+    const upcoming = matches.find((m) => (m.home_team_id === teamA.id && m.away_team_id === teamB.id) ||
+        (m.home_team_id === teamB.id && m.away_team_id === teamA.id));
+    return json({
+        comparison: {
+            [teamA.id]: buildProfile(teamA),
+            [teamB.id]: buildProfile(teamB),
+        },
+        head_to_head: h2h ? {
+            total_matches: h2h.total_matches,
+            [`${first.name}_wins`]: h2h.team_a_wins,
+            draws: h2h.draws,
+            [`${second.name}_wins`]: h2h.team_b_wins,
+            summary: h2h.summary,
+        } : { total_matches: 0, summary: `${first.name} and ${second.name} have never met at a World Cup.` },
+        upcoming_2026_match: upcoming ? {
+            date: upcoming.date,
+            time_utc: upcoming.time_utc,
+            venue: venueName(upcoming.venue_id),
+            round: upcoming.round,
+        } : null,
+        related_tools: [
+            "Use get_team_profile for a deeper dive on either team",
+            "Use get_historical_matchups for full match-by-match history",
+            "Use get_injuries for complete injury details",
+            "Use get_odds for full tournament predictions",
+        ],
+    });
+});
+// ── Tool: get_standings ─────────────────────────────────────────────
+server.registerTool("get_standings", {
+    annotations: { readOnlyHint: true },
+    title: "Get Group Standings",
+    description: "Group power rankings for the FIFA World Cup 2026. Before the tournament starts, returns pre-tournament strength ratings for each group based on FIFA rankings, betting odds, and predictions. Filter by group (A-L) or get all 12 groups at once.",
+    inputSchema: z.object({
+        group: z
+            .string()
+            .optional()
+            .describe("Specific group letter (A-L). If omitted, returns all 12 groups."),
+    }),
+}, async (args) => {
+    let targetGroups = groups;
+    if (args.group) {
+        const gid = args.group.toUpperCase();
+        targetGroups = groups.filter((g) => g.id === gid);
+        if (targetGroups.length === 0) {
+            return json({
+                error: `Group '${args.group}' not found. Valid groups are A through L.`,
+            });
+        }
+    }
+    const result = targetGroups.map((g) => {
+        const groupTeams = g.teams
+            .map((tid) => teams.find((t) => t.id === tid))
+            .filter(Boolean);
+        const ranked = groupTeams.map((t) => {
+            const winnerOdds = tournamentOdds.tournament_winner.find((o) => o.team_id === t.id);
+            const darkHorse = tournamentOdds.dark_horses.find((d) => d.team_id === t.id);
+            const profile = teamProfiles.find((p) => p.team_id === t.id);
+            const teamInjuries = injuries.filter((i) => i.team_id === t.id && i.status !== "fit");
+            // Power score: lower is better. Ranking contributes directly; odds boost reduces it.
+            const ranking = t.fifa_ranking ?? 100;
+            const oddsBoost = winnerOdds
+                ? Math.max(0, 50 - parseFloat(winnerOdds.implied_probability))
+                : 50;
+            const powerScore = ranking + oddsBoost;
+            return {
+                team: `${t.flag_emoji} ${t.name}`,
+                team_id: t.id,
+                fifa_ranking: t.fifa_ranking ?? null,
+                confederation: t.confederation,
+                is_host: t.is_host,
+                winner_odds: winnerOdds ? { odds: winnerOdds.odds, implied_probability: winnerOdds.implied_probability } : null,
+                dark_horse_pick: darkHorse?.reason ?? null,
+                world_cup_pedigree: profile?.world_cup_history
+                    ? `${profile.world_cup_history.appearances} appearances, ${profile.world_cup_history.titles} titles, best: ${profile.world_cup_history.best_result}`
+                    : null,
+                key_injuries: teamInjuries.length > 0
+                    ? teamInjuries.map((i) => `${i.player} (${i.status})`)
+                    : null,
+                _power_score: powerScore,
+            };
+        }).sort((a, b) => a._power_score - b._power_score);
+        const groupPred = tournamentOdds.group_predictions.find((gp) => gp.group === g.id);
+        const confirmedTeams = ranked.filter((t) => !t.team_id.startsWith("tbd"));
+        const avgRanking = confirmedTeams.length > 0
+            ? Math.round(confirmedTeams.reduce((s, t) => s + (t.fifa_ranking ?? 100), 0) / confirmedTeams.length)
+            : null;
+        // Collect head-to-head matchups within the group
+        const groupH2H = [];
+        for (let i = 0; i < groupTeams.length; i++) {
+            for (let j = i + 1; j < groupTeams.length; j++) {
+                const [a, b] = [groupTeams[i].id, groupTeams[j].id].sort();
+                const h2h = historicalMatchups.find((h) => h.team_a === a && h.team_b === b);
+                if (h2h) {
+                    groupH2H.push({
+                        matchup: `${teamName(a)} vs ${teamName(b)}`,
+                        summary: h2h.summary,
+                    });
+                }
+            }
+        }
+        return {
+            group: `Group ${g.id}`,
+            difficulty_rating: avgRanking,
+            prediction: groupPred ? {
+                favorites: groupPred.favorites.map((f) => teamName(f)),
+                dark_horse: teamName(groupPred.dark_horse),
+                narrative: groupPred.narrative,
+            } : null,
+            teams: ranked.map(({ _power_score, ...rest }) => rest),
+            head_to_head_history: groupH2H.length > 0 ? groupH2H : null,
+        };
+    });
+    return json({
+        count: result.length,
+        note: "Teams ranked by pre-tournament power rating (FIFA ranking + betting odds). Lower difficulty_rating = harder group.",
+        groups: result,
+        related_tools: [
+            "Use get_team_profile for a deep dive on any team",
+            "Use get_odds for full tournament predictions",
+            "Use get_historical_matchups for complete head-to-head records",
+            "Use get_bracket to see the knockout path from each group",
+        ],
+    });
+});
+// ── Tool: get_bracket ──────────────────────────────────────────────
+server.registerTool("get_bracket", {
+    annotations: { readOnlyHint: true },
+    title: "Get Knockout Bracket",
+    description: "Visualize the FIFA World Cup 2026 knockout bracket. Shows the full path from Round of 32 through the Final, including which group positions feed into each match, venues, and dates. Optionally filter by a specific round.",
+    inputSchema: z.object({
+        round: z
+            .enum(["Round of 32", "Round of 16", "Quarter-final", "Semi-final", "Third-place play-off", "Final", "all"])
+            .optional()
+            .describe("Specific knockout round to show. Defaults to 'all'."),
+    }),
+}, async (args) => {
+    const knockoutRounds = [
+        "Round of 32", "Round of 16", "Quarter-final", "Semi-final",
+        "Third-place play-off", "Final",
+    ];
+    const targetRound = args.round ?? "all";
+    const knockoutMatches = matches.filter((m) => knockoutRounds.includes(m.round));
+    function describePlaceholder(p) {
+        if (!p)
+            return "TBD";
+        // Winner/Loser of match
+        if (p.startsWith("W"))
+            return `Winner of Match ${p.slice(1)}`;
+        if (p.startsWith("L"))
+            return `Loser of Match ${p.slice(1)}`;
+        // Group position like "1A", "2B"
+        if (/^[12][A-L]$/.test(p)) {
+            const pos = p[0] === "1" ? "Winner" : "Runner-up";
+            return `${pos} of Group ${p[1]}`;
+        }
+        // Best third-place like "3C/D/E"
+        if (p.startsWith("3")) {
+            const groups = p.slice(1);
+            return `Best 3rd from Groups ${groups}`;
+        }
+        return p;
+    }
+    const enrichedKnockout = knockoutMatches.map((m) => {
+        const venue = venues.find((v) => v.id === m.venue_id);
+        return {
+            match_number: m.match_number,
+            match_id: m.id,
+            round: m.round,
+            date: m.date,
+            time_utc: m.time_utc,
+            venue: venue ? `${venue.name}, ${venue.city}` : m.venue_id,
+            home: m.home_team_id ? teamName(m.home_team_id) : describePlaceholder(m.home_placeholder),
+            away: m.away_team_id ? teamName(m.away_team_id) : describePlaceholder(m.away_placeholder),
+            feeds_into: (() => {
+                const nextAsHome = knockoutMatches.find((n) => n.home_placeholder === `W${m.match_number}`);
+                const nextAsAway = knockoutMatches.find((n) => n.away_placeholder === `W${m.match_number}`);
+                const next = nextAsHome || nextAsAway;
+                return next ? `Winner → Match ${next.match_number} (${next.round})` : null;
+            })(),
+        };
+    });
+    // Group by round
+    const byRound = {};
+    for (const m of enrichedKnockout) {
+        if (!byRound[m.round])
+            byRound[m.round] = [];
+        byRound[m.round].push(m);
+    }
+    // Filter if specific round requested
+    let result;
+    if (targetRound !== "all") {
+        const roundKey = targetRound === "Final" ? "Final" : targetRound;
+        const roundMatches = byRound[roundKey];
+        if (!roundMatches) {
+            return json({ error: `No matches found for '${targetRound}'.` });
+        }
+        result = {
+            round: roundKey,
+            matches: roundMatches,
+        };
+    }
+    else {
+        // Build bracket paths: show which group feeds where
+        const bracketPaths = groups.map((g) => {
+            const winnerId = `1${g.id}`;
+            const runnerUpId = `2${g.id}`;
+            const winnerMatch = knockoutMatches.find((m) => m.home_placeholder === winnerId || m.away_placeholder === winnerId);
+            const runnerUpMatch = knockoutMatches.find((m) => m.home_placeholder === runnerUpId || m.away_placeholder === runnerUpId);
+            return {
+                group: `Group ${g.id}`,
+                teams: g.teams.map((tid) => teamName(tid)),
+                winner_enters: winnerMatch
+                    ? `Match ${winnerMatch.match_number} (${winnerMatch.round})`
+                    : "TBD",
+                runner_up_enters: runnerUpMatch
+                    ? `Match ${runnerUpMatch.match_number} (${runnerUpMatch.round})`
+                    : "TBD",
+            };
+        });
+        result = {
+            bracket_overview: bracketPaths,
+            rounds: Object.fromEntries(knockoutRounds.map((r) => [r, byRound[r] ?? []])),
+        };
+    }
+    return json({
+        ...result,
+        key_dates: {
+            round_of_32: "June 29 - July 3",
+            round_of_16: "July 4 - 7",
+            quarter_finals: "July 9 - 11",
+            semi_finals: "July 14 - 15",
+            third_place: "July 18",
+            final: "July 19 (MetLife Stadium, East Rutherford, NJ)",
+        },
+        related_tools: [
+            "Use get_standings to see group power rankings",
+            "Use get_matches to see the full schedule with filters",
+            "Use get_venues for stadium details",
+        ],
+    });
+});
 // ── Start server ────────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();
@@ -674,4 +1656,3 @@ main().catch((err) => {
     console.error("Fatal error:", err);
     process.exit(1);
 });
-//# sourceMappingURL=index.js.map