wc26-mcp 0.3.0 → 0.3.1

package/README.md

@@ -2,10 +2,18 @@
 
 [![npm version](https://img.shields.io/npm/v/wc26-mcp.svg)](https://www.npmjs.com/package/wc26-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+[![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)
 
-MCP server for FIFA World Cup 2026 data — 104 matches, 48 teams, 16 venues, 12 groups. Team profiles, city guides, historical head-to-head records, timezone support, and a smart briefing tool that knows what's relevant right now. All data included, no API keys needed.
+<p align="center">
+  <img src="website/og-image.png" alt="WC26 MCP — World Cup 2026 data for AI" width="600">
+</p>
 
-**[Website](https://wc26.ai)** | **[npm](https://www.npmjs.com/package/wc26-mcp)**
+Ask your AI anything about the 2026 World Cup and get real answers. 18 tools covering matches, teams, venues, city guides, fan zones, head-to-head records, visa info, news, injuries, odds, standings, knockout bracket, and more. All data ships with the package. Zero API keys, zero external dependencies.
+
+Works with **Claude Desktop** · **Claude Code** · **Cursor** · **Windsurf** · **ChatGPT** · **Telegram** · any MCP client
+
+**[Website](https://wc26.ai)** | **[npm](https://www.npmjs.com/package/wc26-mcp)** | **[ChatGPT GPT](https://chatgpt.com/g/g-698d038f171481919ada44947304a196-world-cup-2026-companion)** | **[Telegram Bot](https://t.me/wc26ai_bot)** | **[MCP Registry](https://registry.modelcontextprotocol.io)**
 
 ## Quick Start
 
@@ -60,6 +68,20 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
 }
 ```
 
+### ChatGPT
+
+No setup needed — use the GPT directly:
+
+**[Open World Cup 2026 Companion](https://chatgpt.com/g/g-698d038f171481919ada44947304a196-world-cup-2026-companion)**
+
+### Telegram
+
+No setup needed — message the bot directly:
+
+**[Open @wc26ai_bot on Telegram](https://t.me/wc26ai_bot)**
+
+17 slash commands: `/brief`, `/team`, `/matches`, `/group`, `/city`, `/venue`, `/history`, `/visa`, `/fanzones`, `/schedule`, `/news`, `/injuries`, `/odds`, `/standings`, `/bracket`, and more.
+
 ### Other MCP Clients
 
 The server communicates over stdio using the [Model Context Protocol](https://modelcontextprotocol.io):
@@ -84,34 +106,56 @@ npx -y wc26-mcp
 | `get_schedule` | Tournament schedule organized by date with timezone conversion | `date_from`, `date_to`, `timezone` |
 | `get_visa_info` | Entry requirements (visa, ESTA, eTA) for any team's nationals entering host countries | `team`, `host_country` |
 | `get_fan_zones` | Official FIFA Fan Festival locations across all 16 host cities with capacity, hours, activities, and transit tips | `city`, `country`, `venue_id` |
+| `get_news` | Latest World Cup news headlines sourced by the Scout Agent daily | `topic`, `limit` |
+| `get_injuries` | Key player availability tracker — injury status, expected return dates, and impact assessment | `team`, `status` |
+| `get_odds` | Tournament favorites, golden boot predictions, group previews, and dark horse picks | `category`, `group` |
+| `compare_teams` | Side-by-side comparison of any two teams — rankings, odds, key players, group difficulty, injuries, and head-to-head | `team_a`, `team_b` |
+| `get_standings` | Group power rankings based on FIFA rankings, betting odds, and predictions | `group` |
+| `get_bracket` | Knockout bracket visualization — R32 through Final with venues, dates, and group entry points | `round` |
 
 ## Example Prompts
 
-- "Brief me on the World Cup"
-- "Tell me about Argentina's squad and playing style"
-- "When does the USA play their first match?"
-- "Show me all venues in Texas"
-- "What teams are in Group C with Brazil?"
-- "What's the schedule for the knockout rounds?"
-- "Which matches are at MetLife Stadium?"
-- "Show me tomorrow's matches in my timezone (America/New_York)"
-- "What venues are closest to MetLife Stadium?"
-- "Give me a city guide for Dallas"
-- "What's the World Cup history between Argentina and England?"
-- "Do Iranian fans need a visa to attend matches in the US?"
-- "Where are the fan zones in Dallas?"
-
-## Data Notes
-
-- All kick-off times are in **UTC** (pass `timezone` to convert)
-- Tournament runs **June 11 – July 19, 2026**
-- Some teams are listed as **TBD** (intercontinental playoff winners)
-- 3 host nations: USA (11 venues), Mexico (3 venues), Canada (2 venues)
-- Team profiles include coach, 3 key players, playing style, and World Cup history for all 48 teams
-- Each venue includes average June/July weather (highs, lows, climate description)
-- City guides cover all 16 host cities with transit, food, attractions, and local tips
-- Historical matchups cover 30 team pairings with World Cup tournament meeting data
-- Visa/entry requirements for all 42 confirmed team nationalities across all 3 host countries
+> "Brief me on the World Cup"
+
+> "Tell me about Argentina's squad and playing style"
+
+> "When does the USA play their first match?"
+
+> "Show me tomorrow's matches in my timezone (America/New_York)"
+
+> "What's the World Cup history between Argentina and England?"
+
+> "Give me a city guide for Dallas"
+
+> "Where are the fan zones in New York?"
+
+> "What's the latest World Cup news?"
+
+> "Do Iranian fans need a visa to attend matches in the US?"
+
+> "What venues are closest to MetLife Stadium?"
+
+## Data
+
+| | Count | Details |
+|---|---|---|
+| Matches | 104 | Group stage + knockout, all in UTC (timezone conversion supported) |
+| Teams | 48 | 42 confirmed, 6 TBD (playoffs March 26 & 31) |
+| Venues | 16 | USA (11), Mexico (3), Canada (2) with weather data |
+| Team profiles | 48 | Coach, key players, style, WC history |
+| City guides | 16 | Transit, food, attractions, local tips |
+| Historical matchups | 34 | Head-to-head WC records with narrative |
+| Fan zones | 18 | All host cities, capacity, hours, transport |
+| Visa entries | 42 | All confirmed nationalities across 3 host countries |
+| News | Daily | Scout Agent curates latest World Cup headlines |
+| Injuries | 6+ | Key player availability with status and expected return |
+| Odds | 16+ | Tournament winner, golden boot, group predictions, dark horses |
+
+Tournament: **June 11 - July 19, 2026**
+
+## Contributing
+
+This is an open source project under the MIT license. Issues and PRs welcome at [github.com/jordanlyall/wc26-mcp](https://github.com/jordanlyall/wc26-mcp).
 
 ## License
 

package/dist/data/city-guides.js

@@ -371,4 +371,3 @@ export const cityGuides = [
         ],
     },
 ];
-//# sourceMappingURL=city-guides.js.map

package/dist/data/fan-zones.js

@@ -644,4 +644,3 @@ export const fanZones = [
         status: "confirmed",
     },
 ];
-//# sourceMappingURL=fan-zones.js.map

package/dist/data/groups.js

@@ -60,4 +60,3 @@ export const groups = [
         venue_ids: ["att", "gillette", "metlife"],
     },
 ];
-//# sourceMappingURL=groups.js.map

package/dist/data/historical-matchups.js

@@ -168,6 +168,66 @@ export const historicalMatchups = [
             { year: 2010, host_country: "South Africa", round: "Group Stage", score: "1-1", result: "draw", venue_city: "Johannesburg" },
         ],
     },
+    // Group J: Algeria vs Austria
+    {
+        team_a: "alg",
+        team_b: "aut",
+        total_matches: 1,
+        team_a_wins: 1,
+        draws: 0,
+        team_b_wins: 0,
+        total_goals_team_a: 2,
+        total_goals_team_b: 0,
+        summary: "Algeria stunned Austria 2-0 in the 1982 group stage, part of an incredible Algerian debut that also saw them beat West Germany — before the infamous 'Disgrace of Gijón' eliminated them.",
+        meetings: [
+            { year: 1982, host_country: "Spain", round: "Group Stage", score: "2-0", result: "team_a", venue_city: "Oviedo" },
+        ],
+    },
+    // Group F: Japan vs Tunisia
+    {
+        team_a: "jpn",
+        team_b: "tun",
+        total_matches: 1,
+        team_a_wins: 1,
+        draws: 0,
+        team_b_wins: 0,
+        total_goals_team_a: 2,
+        total_goals_team_b: 0,
+        summary: "Japan beat Tunisia 2-0 in the 2002 group stage on home soil in Osaka, securing their first-ever World Cup knockout round berth.",
+        meetings: [
+            { year: 2002, host_country: "South Korea / Japan", round: "Group Stage", score: "2-0", result: "team_a", venue_city: "Osaka" },
+        ],
+    },
+    // Group H: Saudi Arabia vs Uruguay
+    {
+        team_a: "ksa",
+        team_b: "uru",
+        total_matches: 1,
+        team_a_wins: 0,
+        draws: 0,
+        team_b_wins: 1,
+        total_goals_team_a: 0,
+        total_goals_team_b: 1,
+        summary: "Uruguay edged Saudi Arabia 1-0 in the 2018 group stage, with Luis Suárez scoring the only goal to seal qualification from Group A.",
+        meetings: [
+            { year: 2018, host_country: "Russia", round: "Group Stage", score: "0-1", result: "team_b", venue_city: "Rostov-on-Don" },
+        ],
+    },
+    // Group C: Morocco vs Scotland
+    {
+        team_a: "mar",
+        team_b: "sco",
+        total_matches: 1,
+        team_a_wins: 1,
+        draws: 0,
+        team_b_wins: 0,
+        total_goals_team_a: 3,
+        total_goals_team_b: 0,
+        summary: "Morocco routed Scotland 3-0 in the 1998 group stage, condemning the Scots to a last-place finish and early elimination.",
+        meetings: [
+            { year: 1998, host_country: "France", round: "Group Stage", score: "3-0", result: "team_a", venue_city: "Saint-Étienne" },
+        ],
+    },
     // ── Tier 2: Major historical rivalries ───────────────────────────
     // Argentina vs Brazil
     {
@@ -494,4 +554,3 @@ export const historicalMatchups = [
         ],
     },
 ];
-//# sourceMappingURL=historical-matchups.js.map

package/dist/data/injuries.d.ts

@@ -0,0 +1,2 @@
+import type { InjuryReport } from "../types/index.js";
+export declare const injuries: InjuryReport[];

package/dist/data/injuries.js

@@ -0,0 +1,197 @@
+export const injuries = [
+    // ── Argentina ──
+    {
+        player: "Lionel Messi",
+        team_id: "arg",
+        position: "Forward",
+        injury: "Undisclosed injury announced by Inter Miami",
+        status: "doubtful",
+        expected_return: "TBD",
+        last_updated: "2026-02-11",
+        source: "Marca",
+    },
+    // ── Brazil ──
+    {
+        player: "Neymar",
+        team_id: "bra",
+        position: "Forward",
+        injury: "Long-term fitness concerns — future in Carlo Ancelotti's hands",
+        status: "doubtful",
+        expected_return: "Unknown",
+        last_updated: "2026-02-08",
+        source: "Marca",
+    },
+    // ── England ──
+    {
+        player: "Jude Bellingham",
+        team_id: "eng",
+        position: "Midfielder",
+        injury: "Injury concern — Real Madrid and England monitoring",
+        status: "recovering",
+        expected_return: "Before tournament",
+        last_updated: "2026-02-01",
+        source: "BBC Sport",
+    },
+    {
+        player: "Luke Shaw",
+        team_id: "eng",
+        position: "Defender",
+        injury: "Recurring hamstring issues — fitness management ongoing",
+        status: "recovering",
+        expected_return: "Before tournament",
+        last_updated: "2026-02-06",
+        source: "The Guardian",
+    },
+    // ── France ──
+    {
+        player: "N'Golo Kante",
+        team_id: "fra",
+        position: "Midfielder",
+        injury: "Hamstring injury sustained in Saudi Pro League — racing to be fit",
+        status: "doubtful",
+        expected_return: "May 2026",
+        last_updated: "2026-02-09",
+        source: "L'Equipe",
+    },
+    {
+        player: "Lucas Hernandez",
+        team_id: "fra",
+        position: "Defender",
+        injury: "ACL tear — second major knee injury in career",
+        status: "out",
+        expected_return: "Unlikely for tournament",
+        last_updated: "2026-01-28",
+        source: "L'Equipe",
+    },
+    // ── Spain ──
+    {
+        player: "Gavi",
+        team_id: "esp",
+        position: "Midfielder",
+        injury: "ACL recovery — long road back from November 2023 injury",
+        status: "recovering",
+        expected_return: "Before tournament",
+        last_updated: "2026-02-03",
+        source: "Marca",
+    },
+    // ── Germany ──
+    {
+        player: "Leroy Sane",
+        team_id: "ger",
+        position: "Forward",
+        injury: "Groin surgery recovery — Bayern managing his return",
+        status: "recovering",
+        expected_return: "April 2026",
+        last_updated: "2026-02-07",
+        source: "Kicker",
+    },
+    // ── Belgium ──
+    {
+        player: "Thibaut Courtois",
+        team_id: "bel",
+        position: "Goalkeeper",
+        injury: "ACL recovery — returned to action but managing workload",
+        status: "recovering",
+        expected_return: "Fit for tournament",
+        last_updated: "2026-02-05",
+        source: "ESPN",
+    },
+    {
+        player: "Romelu Lukaku",
+        team_id: "bel",
+        position: "Forward",
+        injury: "Recurring thigh muscle issues — managing fitness carefully",
+        status: "recovering",
+        expected_return: "Before tournament",
+        last_updated: "2026-02-04",
+        source: "BBC Sport",
+    },
+    // ── Portugal ──
+    {
+        player: "Diogo Jota",
+        team_id: "por",
+        position: "Forward",
+        injury: "Knee ligament damage — extended rehabilitation",
+        status: "doubtful",
+        expected_return: "May 2026",
+        last_updated: "2026-02-10",
+        source: "ESPN",
+    },
+    // ── Netherlands ──
+    {
+        player: "Frenkie de Jong",
+        team_id: "ned",
+        position: "Midfielder",
+        injury: "Ankle injury — persistent issue from Euro 2024",
+        status: "recovering",
+        expected_return: "Before tournament",
+        last_updated: "2026-02-02",
+        source: "De Telegraaf",
+    },
+    // ── Norway ──
+    {
+        player: "Erling Haaland",
+        team_id: "nor",
+        position: "Forward",
+        injury: "No current injury — form and confidence being monitored",
+        status: "fit",
+        expected_return: "N/A",
+        last_updated: "2026-02-10",
+        source: "The Guardian",
+    },
+    // ── USA ──
+    {
+        player: "Gio Reyna",
+        team_id: "usa",
+        position: "Midfielder",
+        injury: "Hamstring strain — out of Borussia Dortmund training",
+        status: "recovering",
+        expected_return: "March 2026",
+        last_updated: "2026-02-08",
+        source: "ESPN",
+    },
+    // ── South Korea ──
+    {
+        player: "Son Heung-min",
+        team_id: "kor",
+        position: "Forward",
+        injury: "Calf muscle fatigue — Tottenham managing minutes",
+        status: "fit",
+        expected_return: "N/A",
+        last_updated: "2026-02-11",
+        source: "BBC Sport",
+    },
+    // ── Croatia ──
+    {
+        player: "Luka Modric",
+        team_id: "cro",
+        position: "Midfielder",
+        injury: "Age-related fitness management — Real Madrid reducing minutes",
+        status: "fit",
+        expected_return: "N/A",
+        last_updated: "2026-02-09",
+        source: "Marca",
+    },
+    // ── Senegal ──
+    {
+        player: "Sadio Mane",
+        team_id: "sen",
+        position: "Forward",
+        injury: "Knee soreness — Al-Nassr managing workload ahead of World Cup",
+        status: "recovering",
+        expected_return: "Before tournament",
+        last_updated: "2026-02-06",
+        source: "ESPN",
+    },
+    // ── Colombia ──
+    {
+        player: "Luis Diaz",
+        team_id: "col",
+        position: "Forward",
+        injury: "Knee ligament sprain — Liverpool monitoring recovery timeline",
+        status: "recovering",
+        expected_return: "April 2026",
+        last_updated: "2026-02-05",
+        source: "ESPN",
+    },
+];