# ⚽ Ultras — Football Intel for Die-hards [![npm version](https://img.shields.io/npm/v/ultras-mcp.svg)](https://www.npmjs.com/package/ultras-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)

Ultras MCP — World Cup 2026 data for AI

**Ultras MCP** is the deep intelligence layer for the **FIFA World Cup 2026**. It provides **20 specialized tools** that connect real-time data, prediction markets, and advanced football intelligence directly to AI clients like Claude, Cursor, and ChatGPT. Ask your AI anything about the 2026 World Cup and get high-fidelity answers. Coverage includes matches, teams, venues, city guides, fan zones, head-to-head records, visa info, news, injuries, odds, standings, knockout bracket, live prediction markets, and **per-match 3-outcome odds** (Home Win / Draw / Away Win) directly from Polymarket. Works with **Claude Desktop** · **Claude Code** · **Cursor** · **Windsurf** · **ChatGPT** · **Telegram** · any MCP client **[Website](https://ultras.ai)** | **[npm](https://www.npmjs.com/package/ultras-mcp)** | **[ChatGPT GPT](https://chatgpt.com/g/g-698d038f171481919ada44947304a196-world-cup-2026-companion)** | **[Telegram Bot](https://t.me/ultrasai_bot)** | **[MCP Registry](https://registry.modelcontextprotocol.io)** --- ## 🚀 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"] } } } ``` --- ## 🛠️ Tools (20 Specialized Tools) | # | Tool | Description | |---|------|-------------| | 1 | `what_to_know_now` | Zero-query temporal briefing — detects tournament phase and returns the most relevant info for today. | | 2 | `get_team_profile` | Coach, key players, playing style, World Cup history, and qualifying summary for any team. | | 3 | `get_matches` | Query matches with enriched team names, flags, venue details, and timezone conversion. | | 4 | `get_teams` | All 48 qualified nations with FIFA rankings and confederations. | | 5 | `get_groups` | Group details with teams, venues, and match schedules. | | 6 | `get_venues` | 16 stadiums across USA, Mexico, and Canada with weather data and city info. | | 7 | `get_city_guide` | Travel guide for any host city — highlights, transit, food, things to do, and local tips. | | 8 | `get_historical_matchups` | Head-to-head World Cup history between any two teams with aggregate stats. | | 9 | `get_nearby_venues` | Find venues near a given venue, sorted by distance in miles/km. | | 10 | `get_schedule` | Tournament schedule organized by date with full timezone conversion support. | | 11 | `get_visa_info` | Entry requirements (visa, ESTA, eTA) for any team's nationals entering host countries. | | 12 | `get_fan_zones` | Official FIFA Fan Festival locations with capacity, hours, activities, and transit tips. | | 13 | `get_news` | Latest World Cup news headlines sourced by the Scout Agent daily. | | 14 | `get_injuries` | Key player availability tracker — injury status, expected return, and impact assessment. | | 15 | `get_odds` | Tournament favorites, golden boot predictions, and dark horse picks. | | 16 | `compare_teams` | Side-by-side comparison of any two teams — rankings, odds, style, and H2H. | | 17 | `get_standings` | Group power rankings based on FIFA rankings, betting odds, and predictions. | | 18 | `get_bracket` | Knockout bracket visualization — R32 through Final with venues and dates. | | 19 | `get_polymarket_odds` | Live Polymarket prediction markets for tournament winner, golden boot & group markets. | | 20 | `get_match_odds` | **NEW:** Per-match 3-outcome odds (Home Win / Draw / Away Win) from Polymarket. Falls back to FIFA ranking model when markets haven't opened yet. | --- ## 🎯 Polymarket Integration Ultras MCP has **two dedicated Polymarket tools** that cover different use cases: ### `get_polymarket_odds` — Tournament-level markets Fetches general World Cup 2026 prediction markets: tournament winner, golden boot, group winners. ``` "What are the Polymarket odds for Brazil winning the 2026 World Cup?" "Show me the golden boot prediction markets." ``` ### `get_match_odds` — Per-match 3-outcome (Home Win / Draw / Away Win) The flagship Polymarket integration. Fetches live crowd-sourced probabilities for a specific match, exactly as shown on [polymarket.com/sports/fifa-world-cup/games](https://polymarket.com/sports/fifa-world-cup/games). ``` "What are the live Polymarket odds for USA vs Mexico?" "Get match odds for match number 7." "What's the probability of a draw between England and France?" ``` **Smart fallback:** When Polymarket markets haven't launched yet (pre-tournament), the tool automatically computes implied probabilities using a FIFA ranking model and labels them accordingly. --- ## 📂 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). --- ## 📜 Credits This project is a high-fidelity fork and rebranding of the original [wc26-mcp](https://github.com/jordanlyall/wc26-mcp) by [Jordan Lyall](https://github.com/jordanlyall). It has been enhanced with live prediction markets (including per-match 3-outcome odds) and aligned with the [Ultras Project](https://github.com/MrA-png/ultras-project) ecosystem. Built with ❤️ by [MrA-png](https://github.com/MrA-png)