pitch-mcp
v0.3.10
Published
The official Pitch AI MCP server — Providing high-fidelity football intelligence, prediction markets, and tournament data.
Maintainers
Readme
⚽ Pitch AI — The Intelligence Layer for Global Football
Pitch AI 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, Pitch AI 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 | npm Package | Telegram Bot | X (Twitter)
🚀 Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"pitch": {
"command": "npx",
"args": ["-y", "pitch-mcp"]
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"pitch": {
"command": "npx",
"args": ["-y", "pitch-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
Pitch AI 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

2. Market Opportunity Analysis

3. Pitch AI x Polymarket - Prediction Market Intelligence Layer

4. $PITCH Token - Utility Model & Ecosystem Dynamics

5. Pitch 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/zero520-dot/pitch-mcp.
Built with ❤️ by the Pitch AI Team.
