wc26-mcp 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,11 @@
1
1
  # wc26-mcp
2
2
 
3
- MCP server for FIFA World Cup 2026 data — 104 matches, 48 teams, 16 venues, 12 groups. All data included, no API keys needed.
3
+ [![npm version](https://img.shields.io/npm/v/wc26-mcp.svg)](https://www.npmjs.com/package/wc26-mcp)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+
6
+ MCP server for FIFA World Cup 2026 data — 104 matches, 48 teams, 16 venues, 12 groups. Team profiles, timezone support, and a smart briefing tool that knows what's relevant right now. All data included, no API keys needed.
7
+
8
+ **[Website](https://wc26-mcp.vercel.app)** | **[npm](https://www.npmjs.com/package/wc26-mcp)**
4
9
 
5
10
  ## Quick Start
6
11
 
@@ -25,41 +30,77 @@ Add to your `claude_desktop_config.json`:
25
30
  claude mcp add wc26 -- npx -y wc26-mcp
26
31
  ```
27
32
 
28
- ### Cursor / Other MCP Clients
33
+ ### Cursor
34
+
35
+ Add to `.cursor/mcp.json`:
36
+
37
+ ```json
38
+ {
39
+ "mcpServers": {
40
+ "wc26": {
41
+ "command": "npx",
42
+ "args": ["-y", "wc26-mcp"]
43
+ }
44
+ }
45
+ }
46
+ ```
47
+
48
+ ### Windsurf
29
49
 
30
- Run the server directly:
50
+ Add to `~/.codeium/windsurf/mcp_config.json`:
51
+
52
+ ```json
53
+ {
54
+ "mcpServers": {
55
+ "wc26": {
56
+ "command": "npx",
57
+ "args": ["-y", "wc26-mcp"]
58
+ }
59
+ }
60
+ }
61
+ ```
62
+
63
+ ### Other MCP Clients
64
+
65
+ The server communicates over stdio using the [Model Context Protocol](https://modelcontextprotocol.io):
31
66
 
32
67
  ```bash
33
68
  npx -y wc26-mcp
34
69
  ```
35
70
 
36
- The server communicates over stdio using the [Model Context Protocol](https://modelcontextprotocol.io).
37
-
38
71
  ## Tools
39
72
 
40
73
  | Tool | Description | Filters |
41
74
  |------|-------------|---------|
42
- | `get_matches` | Query matches with enriched team names, flags, and venue details | `date`, `date_from`, `date_to`, `team`, `group`, `venue`, `round`, `status` |
75
+ | `what_to_know_now` | Zero-query temporal briefing detects tournament phase and returns the most relevant info for today | `date`, `timezone` |
76
+ | `get_team_profile` | Coach, key players, playing style, World Cup history, and qualifying summary for any team | `team` |
77
+ | `get_matches` | Query matches with enriched team names, flags, venue details, and timezone conversion | `date`, `date_from`, `date_to`, `team`, `group`, `venue`, `round`, `status`, `timezone` |
43
78
  | `get_teams` | All 48 qualified nations with FIFA rankings and confederations | `group`, `confederation`, `is_host` |
44
79
  | `get_groups` | Group details with teams, venues, and match schedules | `group` |
45
- | `get_venues` | 16 stadiums across USA, Mexico, and Canada | `country`, `city`, `region` |
46
- | `get_schedule` | Tournament schedule organized by date | `date_from`, `date_to` |
80
+ | `get_venues` | 16 stadiums across USA, Mexico, and Canada with weather data | `country`, `city`, `region` |
81
+ | `get_nearby_venues` | Find venues near a given venue, sorted by distance in miles/km | `venue`, `limit` |
82
+ | `get_schedule` | Tournament schedule organized by date with timezone conversion | `date_from`, `date_to`, `timezone` |
47
83
 
48
84
  ## Example Prompts
49
85
 
86
+ - "Brief me on the World Cup"
87
+ - "Tell me about Argentina's squad and playing style"
50
88
  - "When does the USA play their first match?"
51
89
  - "Show me all venues in Texas"
52
90
  - "What teams are in Group C with Brazil?"
53
91
  - "What's the schedule for the knockout rounds?"
54
92
  - "Which matches are at MetLife Stadium?"
55
- - "List all CONCACAF teams in the tournament"
93
+ - "Show me tomorrow's matches in my timezone (America/New_York)"
94
+ - "What venues are closest to MetLife Stadium?"
56
95
 
57
96
  ## Data Notes
58
97
 
59
- - All kick-off times are in **UTC**
98
+ - All kick-off times are in **UTC** (pass `timezone` to convert)
60
99
  - Tournament runs **June 11 – July 19, 2026**
61
100
  - Some teams are listed as **TBD** (intercontinental playoff winners)
62
101
  - 3 host nations: USA (11 venues), Mexico (3 venues), Canada (2 venues)
102
+ - Team profiles include coach, 3 key players, playing style, and World Cup history for all 48 teams
103
+ - Each venue includes average June/July weather (highs, lows, climate description)
63
104
 
64
105
  ## License
65
106
 
@@ -0,0 +1,2 @@
1
+ import type { TeamProfile } from "../types/index.js";
2
+ export declare const teamProfiles: TeamProfile[];