Content
# ⚽ Ultras — The Intelligence Layer for Global Football
[](https://www.npmjs.com/package/ultras-mcp)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://modelcontextprotocol.io)
<p align="center">
<img src="website/ultras-mcp.png" alt="Ultras MCP — World Cup 2026 data for AI" width="600">
</p>
**Ultras** is a professional-grade Model Context Protocol (MCP) server engineered to provide deep, real-time intelligence for the **2026 World Cup**. It equips AI agents with a comprehensive dataset—spanning live prediction markets, squad analytics, and venue logistics—to deliver elite-level sports reasoning.
By bridging the gap between static knowledge and live tournament dynamics, Ultras enables AI clients to perform complex analysis on match probabilities, historical precedents, and on-the-ground travel logistics across North America.
Works seamlessly with **Claude Desktop** · **Claude Code** · **Cursor** · **Windsurf** · **ChatGPT** · **Telegram** · any MCP client
**[Official Website](https://ultrasmcp.tech)** | **[npm Package](https://www.npmjs.com/package/ultras-mcp)** | **[Telegram Bot](https://t.me/ultras_mcp_bot)** | **[X (Twitter)](https://x.com/UltrasMcp)**
---
## 🚀 Quick Start
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"ultras": {
"command": "npx",
"args": ["-y", "ultras-mcp"]
}
}
}
```
### Cursor
Add to `.cursor/mcp.json`:
```json
{
"mcpServers": {
"ultras": {
"command": "npx",
"args": ["-y", "ultras-mcp"]
}
}
}
```
---
## 🛠️ Intelligence Capabilities (20 Advanced Tools)
| # | Capability | Intelligence Provided |
|---|------------|-----------------------|
| 1 | `what_to_know_now` | **Dynamic Briefing Engine** — Intelligently surfaces critical tournament updates and phase-specific insights. |
| 2 | `get_team_profile` | **Squad Intelligence** — Comprehensive profiles including tactical styles, key personnel, and historical performance. |
| 3 | `get_matches` | **Enriched Fixture Data** — Advanced match querying with localized timezones and stadium-specific metadata. |
| 4 | `get_teams` | **National Team Registry** — Detailed statistics for all 48 nations including FIFA rankings and confederation data. |
| 5 | `get_groups` | **Group Analytics** — Complete breakdown of group compositions, schedules, and venue assignments. |
| 6 | `get_venues` | **Stadium Logistics** — Deep data on all 16 host stadiums, including climate profiles and city infrastructure. |
| 7 | `get_city_guide` | **Host City Intelligence** — Expert-curated guides for transit, hospitality, and local culture across North America. |
| 8 | `get_historical_matchups` | **Legacy Analytics** — Deep-dive head-to-head records with aggregate tournament statistics. |
| 9 | `get_nearby_venues` | **Proximity Routing** — Geospatial analysis to identify stadiums within reachable distances for efficient travel. |
| 10 | `get_schedule` | **Chronological Roadmap** — Full tournament timeline with precise timezone synchronization. |
| 11 | `get_visa_info` | **Global Access Guide** — Entry requirements and documentation protocols for all participating nationalities. |
| 12 | `get_fan_zones` | **Fan Engagement Hubs** — Real-time data on official FIFA Fan Festivals, capacity, and amenities. |
| 13 | `get_news` | **Live Intel Feed** — Daily curated headlines and breaking news from across the tournament ecosystem. |
| 14 | `get_injuries` | **Availability Tracker** — Critical updates on player fitness, recovery timelines, and tactical impact. |
| 15 | `get_odds` | **Prediction Insights** — Tournament favorites and outcome probabilities based on professional modeling. |
| 16 | `compare_teams` | **Head-to-Head Comparative** — Side-by-side tactical and statistical benchmarking of any two nations. |
| 17 | `get_standings` | **Power Rankings** — Dynamic standings derived from current form, odds, and predictive algorithms. |
| 18 | `get_bracket` | **Knockout Visualization** — End-to-end visualization of the tournament path from Round of 32 to the Final. |
| 19 | `get_polymarket_odds` | **Market Sentiment** — Live prediction market data for overall tournament and group-stage outcomes. |
| 20 | `get_match_odds` | **Precision Probabilities** — High-fidelity 3-way match odds (Home/Draw/Away) sourced from Polymarket. |
---
## 🎯 Polymarket Intelligence Integration
Ultras features a specialized integration with Polymarket to provide crowd-sourced, real-time probability data:
### Tournament-Level Markets (`get_polymarket_odds`)
Monitor overall sentiment for the 2026 champion, individual group winners, and top individual performers (Golden Boot).
### Per-Match Probabilities (`get_match_odds`)
Our flagship integration delivers live, 3-outcome probabilities for every fixture. This tool bridges the gap between traditional statistics and real-world market sentiment.
**Intelligent Fallback:** In the absence of active markets, the system automatically utilizes a FIFA-ranking statistical model to provide high-fidelity implied probabilities.
---
## 🏗️ Visual Architecture
### 1. System Architecture & Data Flow
### 2. Market Opportunity Analysis
### 3. Ultras x Polymarket - Prediction Market Intelligence Layer
### 4. $ULTRAS Token - Utility Model & Ecosystem Dynamics
### 5. Ultra MCP Intelligence Coverage & Tools Benchmarking
---
## 📂 Data Coverage
| Category | Count | Details |
|---|---|---|
| **Matches** | 104 | Full group stage + knockout schedule (UTC/Local conversion) |
| **Teams** | 48 | Complete profiles for all qualified nations |
| **Match Odds** | Live | 3-outcome per-match odds from Polymarket (Home Win / Draw / Away Win) |
| **Tournament Markets** | Live | Tournament winner, golden boot, and group markets from Polymarket |
| **Venues** | 16 | USA (11), Mexico (3), Canada (2) with capacity & coordinates |
| **City Guides** | 16 | Transit, food, and attractions for every host city |
| **Historical Data** | Deep | Head-to-head WC records and narrative summaries |
| **Travel & Logistics** | 18+ | Fan zones, visa requirements, and transit tips |
---
## 📝 Example Prompts
> "Brief me on the World Cup situation today."
> "What are the live odds for Argentina vs France? Home Win / Draw / Away Win."
> "Get Polymarket odds for match number 14."
> "What are the tournament winner odds on Polymarket? Filter for Brazil."
> "Tell me about Germany's squad and their playing style."
> "Show me the schedule for Group A in America/New_York timezone."
> "What is the historical head-to-head between Brazil and Italy in World Cups?"
> "Which teams are most likely to win Group H according to current odds?"
---
## 🤝 Contributing
This is an open-source project under the MIT license. Issues and PRs are welcome at [github.com/MrA-png/ultras-mcp](https://github.com/MrA-png/ultras-mcp).
---
---
Built with ❤️ by the Ultras Team.
