io.github.jordanlyall/wc26
FIFA World Cup 2026 data: matches, teams, venues, city guides, fan zones, and more.
Open source Open in the app JSON README (API)
About
FIFA World Cup 2026 data: matches, teams, venues, city guides, fan zones, and more.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- jordanlyall
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.3.0
- Stars
- 34
- Forks
- 9
- Open pull requests
- 4
- Last push
- 2026-09-07T14:06:00Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:00:17
- Updated
- 2026-08-29 04:00:17
- Origin id
io.github.jordanlyall/wc26
README
# wc26-mcp
[](https://www.npmjs.com/package/wc26-mcp)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://modelcontextprotocol.io)
<p align="center">
<img src="website/og-image.png" alt="WC26 MCP — World Cup 2026 data for AI" width="600">
</p>
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
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"wc26": {
"command": "npx",
"args": ["-y", "wc26-mcp"]
}
}
}
```
### Claude Code
```bash
claude mcp add wc26 -- npx -y wc26-mcp
```
### Cursor
Add to `.cursor/mcp.json`:
```json
{
"mcpServers": {
"wc26": {
"command": "npx",
"args": ["-y", "wc26-mcp"]
}
}
}
```
### Windsurf
Add to `~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"wc26": {
"command": "npx",
"args": ["-y", "wc26-mcp"]
}
}
}
```
### 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):
```bash
npx -y wc26-mcp
```
## Tools
| Tool | Description | Filters |
|------|-------------|---------|
| `what_to_know_now` | Zero-query temporal briefing — detects tournament phase and returns the most relevant info for today | `date`, `timezone` |
| `get_team_profile` | Coach, key players, playing style, World Cup history, and qualifying summary for any team | `team` |
| `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` |
| `get_teams` | All 48 qualified nations with FIFA rankings and confederations | `group`, `confederation`, `is_host` |
| `get_groups` | Group details with teams, venues, and match schedules | `group` |
| `get_venues` | 16 stadiums across USA, Mexico, and Canada with weather data | `country`, `city`, `region` |
| `get_city_guide` | Travel guide for any host city — highlights, transit, food, things to do, local tips | `city` |
| `get_historical_matchups` | Head-to-head World Cup history between any two teams with aggregate stats and narrative | `team_a`, `team_b` |
| `get_nearby_venues` | Find venues near a given venue, sorted by distance in miles/km | `venue`, `limit` |
| `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 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
MIT