SportIQ Background
SportIQ Background
SportIQ Background
Newv0.4.0: F1 title-race sim, World Cup what-if, MCP resources →

Turn any AI into your personal sports analyst

World Cup 2026 replays & what-ifs, the F1 title race, pit strategy, Dream11 optimization & model-vs-market edges — inside your AI assistant.

Install free →Sponsor the project

Works with Claude · ChatGPT · Cursor · any MCP client

· 46 tools · 3 sports

sportiq-mcp
_
Works withClaudeChatGPTCursorany MCP client
PyPIMCP RegistryMIT Licensed46 tools

Raw data is table stakes.
The intelligence layer is the product.

⚽

Monte Carlo Bracket

Replays the World Cup 2026 with Poisson xG — 12 groups, top 2 + 8 best thirds into a 32-team knockout. Lock in the real results, flip one tie, and see who lifts the trophy instead.

🏎️

F1 Pit-Strategy Predictor

A tyre-degradation model on real OpenF1 telemetry recommends stop laps and compound sequence — with a confidence score.

Lap 15BOX BOXLap 35
🏏

Dream11 Optimizer

A PuLP constraint solver builds the optimal fantasy XI — captain & vice-captain — under every credit, role, and team cap.

XI GENERATED

New in v0.4.0

Two new tools, real 2026 results, and accuracy fixes across all three sports. Hosted users get it automatically.

⚽ Football

World Cup 2026 what-if

football_what_if replays the tournament from any stage and can flip one real knockout result: what if France had beaten Spain? Completed-tournament mode answers from the real results (Spain won the final 1–0 after extra time).

🏎️ F1

Title-race simulator

f1_simulate_championship runs a Monte Carlo over the remaining rounds with exact elimination maths. The pit-strategy model now compares the whole remaining race and only recommends legal tyre sequences.

🏏 Cricket

Official Dream11 T20 scoring

Fantasy points follow the official T20 table. IPL squads are generated from Cricsheet, team names and venue strings resolve automatically, and the batter-vs-bowler matchup is now consistent in both directions.

⚙️ Platform

Faster, steadier, 46 tools

7 MCP resources (draw, team codes, circuits, venues, scoring profile). A cache fix, 30-second tool deadlines, simulations off the event loop, a /healthz route and a smaller server image.

Full release notes →

Stuff that used to take hours and a dozen tabs
now takes one sentence.

>Replay the World Cup 2026 final 10,000 times — what if France had beaten Spain in the semi?
>Who can still win the 2026 F1 drivers' title? Simulate the rest of the season.
>Where is the market wrong? Show me the biggest model-vs-bookmaker probability edges tonight.
>What's the smartest pit-stop strategy if it rains at the next Grand Prix?
>Compare these two F1 drivers' race pace and tell me who's quicker.
>Build me the optimal Dream11 XI for any IPL fixture under the credit cap.

Betting outputs surface probabilities and value — not guarantees. Not financial advice; bet responsibly.

46 Tools. Zero Configuration.

A complete arsenal of data retrieval and intelligent modeling tools, exposed natively to your AI. Every one of them is free.

football_get_groups
Free
football_get_fixtures
Free
football_get_standings
Free
football_get_squad
Free
football_get_match_stats
Free
football_get_top_scorers
Free
football_get_odds
Free
football_xg_model
Free
football_match_predictor
Free
football_simulate_group
Free
football_simulate_bracket
Free
football_knockout_path
Free
football_what_if
Free
football_form_trends
Free
football_find_value_bets
Free
football_build_accumulator
Free
+ cross-sport accumulator & health diagnostics (46 tools total)

The data. The decisions.
All of it, free.

Everything's free

All 46 tools are free — data layer and full intelligence layer. The hosted server needs no key; some live feeds need provider keys when self-hosting.

  • ✓Live scores, fixtures, standings, squads & odds
  • ✦World Cup 2026 replay & what-if sims
  • ✦F1 title-race sim, pit strategy + tyre degradation
  • ✦Dream11 optimizer (constraint solver)
  • ✦Model-vs-market edges (positive-EV filtered) — model probability vs the bookmaker line
  • ✓xG models, match predictors & form trends

If SportIQ saves you time, you can sponsor it on GitHub to help cover hosting — purely voluntary, same fully-unlocked server either way.

From zero to analyst in 2 steps

1

Install

uvx sportiq-mcp

or add the hosted connector to your AI

2

Start asking

All 46 tools are free and live immediately.

The hosted server needs no key; some live feeds need provider keys when self-hosting.

Like it? You can optionally sponsor the project to help cover hosting — everything stays free either way.

Full setup guide →

Screenshots, per-client steps & the exact config to paste.

Quickstart Config

claude_desktop_config.json

Command Line

uvx sportiq-mcp

Claude Config (JSON)

{
  "mcpServers": {
    "sportiq": {
      "command": "uvx",
      "args": ["sportiq-mcp"],
      "env": {
        "CRICAPI_KEY": "",
        "APIFOOTBALL_KEY": "",
        "THEODDS_KEY": ""
      }
    }
  }
}

No keys? Leave the env values empty unless you have a key — it still runs on free seed + public-source data.

No install? Add the hosted server as a custom connector — every tool, including the full intelligence layer, is free: https://sportiq.utkarshgupta.org/mcp