⚽ Ultras — Football Intel for Die-hards

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 | npm | ChatGPT GPT | Telegram Bot | MCP Registry

🚀 Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ultras": {
      "command": "npx",
      "args": ["-y", "ultras-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.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.

"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.

📜 Credits

This project is a high-fidelity fork and rebranding of the original wc26-mcp by Jordan Lyall. It has been enhanced with live prediction markets (including per-match 3-outcome odds) and aligned with the Ultras Project ecosystem.

Built with ❤️ by MrA-png