What it does
MCP tools for FIFA World Cup 2026 football, Formula 1, and IPL cricket — sims, strategy, fantasy.
- Connects Computer or cloud
- Account or key No key needed
- Category Games, sports, food & learning
Why it ranks here
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 12/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 8/8 | The cloud endpoint answered at the last check |
| Usage score | 32/100 |
Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Install
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Sportiq MCP. Follow https://mcp.popnx.com/i/ninjabeam20-sportiq-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 5/5 checks · What you ask goes through the maker’s server (sportiq.utkarshgupta.org) · ✓ Commands checked Nov 18, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 2 min
No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
Open Claude’s Connectors page
CustomizeConnectors
Click “Add” → “Custom” → “Web” and fill in these 2 fields
Copy each value into the field with the same name in Claude, then click Continue
Name · NameSportiq MCPRemote MCP server URL · Addresshttps://sportiq.utkarshgupta.org/mcpClick Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add
Turn it on in a chat
+ConnectorsSportiq MCP
Try it
Use Sportiq MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Sportiq MCP or shows a Sportiq MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with ChatGPT, depending on your plan
Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only
Open ChatGPT’s add-MCP page on the web
Plugins+Add custom MCP server
Fill in the name and address
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
Name · NameSportiq MCPConnection · Addresshttps://sportiq.utkarshgupta.org/mcpPick Sportiq MCP in a chat
Start a new chat and pick Sportiq MCP from your plugins before typing
Try it
Use Sportiq MCP and tell me what you can do for me, then show me one thing✓ If ChatGPT says it is using Sportiq MCP or shows a Sportiq MCP tool in the answer, you are connected
Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Claude Code · about 2 min
No key, nothing to install
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add --transport http --scope user sportiq https://sportiq.utkarshgupta.org/mcpType /mcp in Claude Code
You should see Sportiq MCP listed as connected
Try it
Use Sportiq MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Sportiq MCP or shows a Sportiq MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 2 min
No key, nothing to install
Open the AI chat in Cursor in Agent mode
Try it
Use Sportiq MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Sportiq MCP or shows a Sportiq MCP tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 2 min
No key, nothing to install
Open the AI chat in VS Code in Agent mode
Try it
Use Sportiq MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Sportiq MCP or shows a Sportiq MCP tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://sportiq.utkarshgupta.org/mcpJSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Over the web
Claude Code
claude mcp add --transport http --scope user sportiq https://sportiq.utkarshgupta.org/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"sportiq": {
"url": "https://sportiq.utkarshgupta.org/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"sportiq": {
"type": "http",
"url": "https://sportiq.utkarshgupta.org/mcp"
}
}
}Installed on your computer
Claude Code
claude mcp add --scope user sportiq -- uvx sportiq-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"sportiq": {
"command": "uvx",
"args": [
"sportiq-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"sportiq": {
"command": "uvx",
"args": [
"sportiq-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"sportiq": {
"type": "stdio",
"command": "uvx",
"args": [
"sportiq-mcp"
]
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Related guides
What it can do
Tool names and descriptions exactly as the server reported them on Nov 19, 2026. The maker wrote them, not us; we show them as plain text.
sportiq_healthReport cache backend, per-adapter healthcheck, and quota status. Returns: HealthReport-shaped dict with `cache_backend`, `cache_ok`, `adapters` (per-source ok/detail), and `quotas`.
football_get_groupsReturn the FIFA World Cup 2026 group draw and advancement format. Returns: data.groups: {group_letter: [4 team codes]} for all 12 groups. data.format: 48-team / 12-group / top-2 + 8-best-thirds rule. data.teams: team-code -> {name, fifa_code} metadata. meta.source: adapter that s
football_get_fixturesReturn World Cup 2026 fixtures (live providers, else the group schedule). Args: limit: Max fixtures to return, 1..200 (default 50). offset: Number of fixtures to skip for paging (default 0). Returns: data.fixtures: page of {home, away, date/group, status, home_goals, away_goals}.
football_get_standingsReturn current World Cup 2026 group standings. Args: limit: Max standing rows to return, 1..200 (default 50). offset: Number of rows to skip for paging (default 0). Returns: data.standings: page of {rank, team, group, points, played, goals_diff}. data.pagination: {total, count, o
football_get_squadReturn a national team's World Cup squad. Args: team: Team code or name (e.g. "ARG"). Live rosters need an API-Football key; without one the static seed serves an empty-but-valid squad (no rosters are bundled). Returns: data.squad: list of {name, number, position, age} (empty fro
football_get_match_statsReturn a team's aggregate World Cup tournament statistics. Network-only enrichment: requires a configured API-Football (or football-data.org) key. There is no offline static fallback, so without a key the call returns a clean ALL_SOURCES_FAILED envelope. Args: team: API-Football
football_get_top_scorersReturn the World Cup 2026 top scorers. Returns: data.scorers: list of {name, team, goals, assists}. meta.source: adapter that served the data.
football_get_oddsReturn market head-to-head odds for any World Cup 2026 events the odds feed still lists. Sourced from The Odds API (requires THEODDS_KEY). Without a key the call returns a clean ALL_SOURCES_FAILED envelope rather than crashing. The tournament ended with the 2026-07-19 final, so t
football_xg_modelEstimate a match's expected goals and win/draw/loss probabilities. Args: home_team: First team, FIFA code or name (e.g. "ARG" or "Argentina"). away_team: Second team, FIFA code or name (e.g. "BRA" or "Brazil"). neutral: True for a neutral venue (no home advantage). World Cup defa
football_match_predictorPredict a single match: most likely scoreline + outcome probabilities. Args: home_team: First team, FIFA code or name (e.g. "ESP" or "Spain"). away_team: Second team, FIFA code or name. neutral: True for a neutral venue (World Cup default). Returns: data: {most_likely_score, home
football_simulate_groupMonte Carlo one group within the full 12-group qualification context. Args: group: Group letter A-L (also accepts "Group A"). iterations: Number of simulations (clamped to 100..20000). Returns: data.teams: Per-team position probabilities, p_auto_advance, p_best_third_advance, tru
football_simulate_bracketMonte Carlo the full World Cup 2026 — per-team round + title probabilities. Simulates all 12 groups, advances the top 2 + 8 best third-placed teams to a 32-team knockout, and plays it to a champion, ``iterations`` times. Args: iterations: Number of tournament simulations (clamped
football_knockout_pathRound-by-round survival probabilities for one team in the full sim. Args: team: FIFA code or name (e.g. "FRA" or "France"). iterations: Number of tournament simulations (clamped to 100..20000). seed: Optional RNG seed. Returns: data: {team, reach_r32, reach_r16, reach_qf, reach_s
football_what_ifReplay World Cup 2026 from a chosen stage, optionally flipping one real knockout result. Keeps every real result played before ``replay_from`` and Monte-Carlos the rest of the tournament from there. ``flip_winner_of`` makes one decided knockout tie in the kept results go the othe
football_find_value_betsSurface the largest gaps between the model's win probability and the market. De-vigs each market's 1X2 decimal odds (removes the margin so implied probabilities sum to 1) and compares them to this server's own match-outcome probabilities — the same Elo/Poisson path ``football_mat
football_form_trendsReturn rolling form, goal record, and xG trend for a football team. Args: team: FIFA code (e.g. ARG) or name (e.g. "Argentina", "South Korea"). Returns: data: {form_string, wins, draws, losses, goals_scored, goals_conceded, xg_for, xg_against, recent_trend, matches_analysed}. met
football_build_accumulatorModel the joint probability of several match outcomes from the top model-vs-market gaps. Calls ``football_find_value_bets`` internally to fetch live odds, then selects the strongest legs and combines them under the joint-probability model. Args: legs: Number of legs (2-8). Defaul
f1_get_sessionsReturn F1 sessions for a given year, optionally filtered by country or session name. Args: year: Championship year (e.g. 2026). country: Optional country name to filter (e.g. "Netherlands"). session_name: Optional session name to keep, case-insensitive (e.g. "Race", "Qualifying",
f1_get_driversReturn driver list for a specific F1 session. Args: session_key: OpenF1 session identifier. Returns: data.drivers: list of driver objects with driver_number, full_name, team. meta.source: adapter that served the data.
f1_get_lap_timesReturn lap times for a driver in a specific F1 session. Args: session_key: OpenF1 session identifier. driver_number: Driver's race number (driver numbers change by season; use f1_get_drivers). limit: Max laps to return, 1..200 (default 100 — covers most full races). offset: Numbe
f1_get_standingsReturn F1 driver and constructor championship standings for a year. Use this for "who is leading / who will win the F1 championship this year". For title probabilities use f1_simulate_championship. This is not a cricket or football tool. Args: year: Championship year (e.g. 2026).
f1_get_race_resultsReturn the final classification for one F1 race, keyed by year and round. Args: year: Championship year (e.g. 2025). round: Round number within the season (1-based; e.g. 1 for the opener). Returns: data.results: Ergast/Jolpica RaceTable payload — finishing order, times, grid posi
f1_get_weatherReturn weather data for a specific F1 session. Args: session_key: OpenF1 session identifier. Returns: data.weather: list of weather snapshots with temperature, rainfall, wind. meta.source: adapter that served the data.
f1_tyre_degradationFit a tyre degradation model for a driver + compound in a session. Args: session_key: OpenF1 session identifier. driver_number: Driver's race number. compound: Tyre compound (SOFT, MEDIUM, HARD, INTER, WET; "INTERMEDIATE" = INTER). Returns: data: {intercept, slope, residual_std,
f1_undercut_windowEstimate whether an undercut is viable for the attacker against the target. Args: session_key: OpenF1 session identifier. attacker_number: Attacking driver's race number. target_number: Target driver's race number. current_lap: Current lap number in the race. Returns: data: {laps
f1_head_to_head_paceCompare lap-time pace distribution between two drivers in a session. Args: session_key: OpenF1 session identifier. driver_a: First driver's race number. driver_b: Second driver's race number. Returns: data: {driver_a_avg_s, driver_b_avg_s, delta_s, faster_driver}. The "avg" value
f1_weather_strategy_impactAnalyse weather data and recommend compound or pit-window adjustments. Args: session_key: OpenF1 session identifier. Returns: data: {has_rain, avg_track_temp_c, compound_recommendation, recommendation}. meta.estimated: true.
f1_predict_pit_strategyPredict the optimal pit-stop strategy for a driver in an F1 race session. Args: session_key: OpenF1 session identifier for a recorded race. driver_number: Driver's race number (driver numbers change by season; use f1_get_drivers). current_lap: Current lap to project from (default
f1_simulate_championshipEstimate each driver's F1 drivers' title probability for the rest of a season. Monte Carlo over the remaining races and sprints (Plackett-Luce finishing orders weighted by each driver's season points rate), plus exact elimination maths: a driver who cannot catch the leader's curr
f1_qualifying_analysisAnalyse a qualifying session: best lap per driver, gap to pole, projected grid. Args: session_key: OpenF1 session identifier for a Qualifying session. Returns: data.grid: [{position, driver_number, full_name, team_name, best_lap_gap_s}]. data.pole_time_s: pole lap duration in sec
f1_race_pace_compareCompare race-pace and tyre degradation between two F1 drivers in a session. Args: session_key: OpenF1 session identifier. driver_a: First driver's race number. driver_b: Second driver's race number. Returns: data: {by_compound, overall_faster, compounds_compared}. meta.estimated:
cricket_get_live_matchesReturn all currently live cricket matches across all series. Returns: data.matches: list of live match objects (team names, score, status). meta.source: which adapter served the response. meta.is_stale: true if data is from stale cache.
cricket_get_scorecardReturn the full scorecard for a specific match. Args: match_id: The match identifier (e.g. from cricket_get_live_matches). Returns: data: full scorecard with innings, partnerships, bowling figures. meta.source: adapter that served the data.
cricket_get_points_tableReturn the points table / standings for a cricket series. Args: series_id: The series identifier (e.g. IPL 2026 series ID from CricAPI). Returns: data: points table rows with team, P, W, L, NRR, Points. meta.source: adapter that served the data.
cricket_get_scheduleReturn the upcoming match schedule, optionally filtered by series. Args: series_id: Optional. Filter to a specific series. If omitted, returns all upcoming fixtures across all active series. limit: Max matches to return, 1..200 (default 50). offset: Number of matches to skip for
cricket_get_squadReturn the squad roster for a cricket team, optionally for a specific series. Args: team: Team code or name (e.g. "MI", "CSK", "IND", "AUS"). series_id: Optional. Series ID to pull the tournament-specific squad. If omitted, falls back to static seed data. Returns: data.players: l
cricket_get_live_oddsReturn live market head-to-head odds for upcoming/live IPL matches. IPL only (~March-May). An empty ``events`` list outside that window is a successful empty market, not an outage. Not international/Test/other T20 leagues. For World Cup 2026 football odds use ``football_get_odds`
cricket_build_dream11_teamRecommend an optimal fantasy XI + captain + vice-captain for one fixture. Args: match_id: CricAPI match identifier; resolves team_a/team_b/venue automatically. team_a: First team code/name (e.g. ``MI``). Required if match_id is absent. team_b: Second team code/name (e.g. ``CSK``)
cricket_captain_recommendationReturn the top-3 captain candidates ranked by projected points. IPL venues only (pitch seed is IPL grounds). Test/international matches and unknown venues fail rather than inventing a ranking. Same-role players often tie: projections use default form 55 and default opposition 0.5
cricket_differential_picksSuggest low-ownership picks with positive projected upside. Ownership is *estimated* — proxied by credit weight (lower-credit players tend to have lower ownership), not real ownership data. Flagged ``estimated: true`` in the response. Args: match_id: CricAPI match identifier; res
cricket_player_form_indexReport a 0-100 form score for a player using the player_stats chain. Args: player_id: Upstream player identifier (CricAPI/Cricbuzz id). Returns: data.form_score: 0..100 indicator. data.trend: "rising" / "stable" / "falling". data.samples: how many recent innings were available. m
cricket_get_pitch_reportSummarise pitch characteristics for a venue. Args: venue: Venue key (e.g. ``wankhede``), official name, or city. Returns: data: {batting_friendly 0..1, expected_first_inn, recommendation, venue, pitch_type}. meta.source: which adapter served the venue record.
cricket_find_value_betsCompare model probabilities against market-implied IPL odds. Requires THEODDS_KEY. NOTE: cricket has no calibrated team-strength model wired yet (unlike the football Elo/Poisson path), so this tool currently returns an EMPTY ``value_bets`` list — scoring an edge against a neutral
cricket_head_to_headCompare two cricket teams head-to-head using squad form and player stats. Args: team_a: First team code or name (e.g. "MI", "India"). team_b: Second team code or name (e.g. "CSK", "Australia"). Returns: data: {team_a, team_b, team_a_edge_count, team_b_edge_count, key_players_a, k
cricket_player_matchupAnalyse the head-to-head matchup between two cricket players based on role and career stats. Args: player_a: CricAPI player ID for the first player (names are not resolved). player_b: CricAPI player ID for the second player (names are not resolved). Returns: data: {matchup_type,
cross_sport_build_accumulatorModel the joint probability of multiple outcomes across football and cricket. Args: legs: Total legs across both sports (2-8). Default 3. min_edge: Minimum edge per leg. Default 0.05. Returns: data: same shape as football_build_accumulator, with sport field per leg. meta.estimate
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account Ninjabeam20, which owns the repo
- ✓ Pass
Still maintained
Code last changed 27 days ago
- ✓ Pass
Has a licence
Uses MIT
- ✓ Pass
Endpoint responds
Responded in 878 ms (HTTP 200)
- – Not applicable
Sign-in with OAuth
No sign-in needed
- ✓ Pass
No hidden instructions in tool descriptions
Read 46 tool descriptions and found no hidden instructions to the AI
The cloud address answered 4 of the last 5 checks · latest 878 ms · checked Nov 19, 2026
Published vulnerabilities (OSV.dev)
No entries on OSV.dev for sportiq-mcp@0.4.0
Checks only this package version, not every dependency · checked Nov 15, 2026
Makers: ask for a re-check or report wrong info
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/ninjabeam20-sportiq-mcp)Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Games, sports, food & learningi
- More stars than 96% of the other 1623 servers in this category
- Published to the registry more recently than 49% of the other 1623 servers in this category
- Basic checks equal to or better than 99% of the other 1623 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Sportiq MCP safe?
It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
The registry does not list a required key, though some servers ask you to sign in on first use.
Does it run on my computer or in the cloud?
Either way works: install it on your computer or connect to the cloud version.
Is it still maintained?
The GitHub repo last changed 27 days ago, and the latest version (0.4.0) reached the registry 27 days ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).
What can I use instead?
In the same category: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
Similar alternatives
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
| This one Sportiq MCP | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | GoodWatch | |
|---|---|---|---|---|---|---|
| Runs where | Cloud or install on your computer | Runs in the cloud, nothing to install | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | Yes | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 5/5 | 4/4 | 3/3 | 4/4 | 3/4 | 4/4 |
| License | MIT | AGPL-3.0 | MIT | MIT | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
sportiq-mcp
MCP server that turns any AI assistant into a sports analyst across FIFA World Cup 2026 football, Formula 1, and IPL cricket — 46 AI-callable tools.
*SportIQ running live in Claude — Monte Carlo World Cup bracket, F1 pit strategy, and Dream11 optimisation, each a visible MCP tool call. (1-min demo)*
Every tool is free to use — the three flagships and everything in the INTEL columns below have no SportIQ paywall or account requirement. Live/provider-backed data still depends on the keys and quota available to the host or local operator. If SportIQ is useful to you, sponsor the project to support ongoing development.
What's new in v0.4.0
- Two new tools (46 total):
f1_simulate_championship: a title-race Monte Carlo with exact elimination maths.football_what_if: replays World Cup 2026 from any stage, optionally flipping one real knockout result.- Completed-tournament mode: World Cup tools now answer from the real 2026 results (Spain won the final 1–0 after extra time) instead of re-simulating.
- 7 MCP resources: static reference data (the WC draw, team codes, F1 circuits, IPL venues and teams, the Dream11 scoring profile) plus the instructions.
- Accuracy fixes:
- Official Dream11 T20 scoring and IPL squads generated from Cricsheet.
- An F1 pit model that sums the whole remaining race, legal compound sequences and the regulation race distance.
- Positive-EV value bets only.
- Extra-time and penalty results kept, team-name and venue resolution, and many more.
- Reliability:
- A fix for a cache bug that wiped the cache about once a minute.
- No more per-request teardown errors.
- A
/healthzliveness route. - A 30 s per-tool deadline (
TOOL_DEADLINE_SECONDS) and a 15 s budget per data chain. - API keys no longer appear in logs.
- Upgrade:
uvx sportiq-mcp@latestpicks up 0.4.0. The hosted connector URL stays the same.
What it does
Raw-data tools are table stakes; the intelligence layer is the product. Three flagships:
- `football_simulate_bracket` — Monte Carlo with Poisson xG over the 48-team WC 2026 format → per-team round + title probabilities.
- `f1_predict_pit_strategy` — tyre-degradation model on OpenF1 telemetry → optimal stop laps + compound sequence.
- `cricket_build_dream11_team` — PuLP constraint solver → a valid fantasy XI under credit/role/team caps.
Tools (46 total)
| Sport | RAW data | INTEL |
|---|---|---|
| Football (WC 2026) | groups, fixtures, standings, squad, match stats, top scorers, odds | xg_model, match_predictor, simulate_group, simulate_bracket, knockout_path, form_trends, find_value_bets, build_accumulator, what_if |
| F1 | sessions, drivers, lap_times, standings, race_results, weather | tyre_degradation, undercut_window, head_to_head_pace, weather_strategy_impact, qualifying_analysis, race_pace_compare, predict_pit_strategy, simulate_championship |
| Cricket (IPL) | live_matches, scorecard, points_table, schedule, squad, live_odds | build_dream11_team, captain_recommendation, differential_picks, player_form_index, pitch_report, head_to_head, player_matchup, find_value_bets |
| Cross-sport | — | build_accumulator |
Plus sportiq_health (included in the 46; cache backend + per-adapter status and remaining API quota).
MCP resources (static JSON, readable without a tool call): sportiq://instructions, sportiq://football/wc2026/draw, sportiq://football/team-codes, sportiq://f1/circuits, sportiq://cricket/venues, sportiq://cricket/teams, sportiq://cricket/scoring-profile.
Data sources (per chain, with keyless fallbacks): football → API-Football → football-data.org → openfootball (keyless) → bundled wc2026.json; standings fall back to a table derived from fixture results. F1 → OpenF1 → Jolpica → fastf1. Cricket → CricAPI → RapidAPI Cricbuzz (paid fallback) + static seeds (NDTV/Cricbuzz scrapers opt-in). Odds (football + cricket) → The Odds API.
Where it works
Anywhere that speaks MCP — Claude (Desktop + web), ChatGPT, Cursor, and any MCP client. Two ways to run it:
- Hosted (no install): add a custom connector — works in claude.ai web & ChatGPT.
- Local (`uvx`/Desktop config/IDEs): install from PyPI.
How it works
Hosted — no install
A public instance runs on the home server behind Cloudflare. Add this as a custom connector with No authentication:
https://sportiq.utkarshgupta.org/mcp
Hosting history (GCP Cloud Run → home server): docs/wiki/findings/product-hosting-arc.md. Old *.run.app connector URLs are gone.
- claude.ai (web): Settings → Connectors → Add custom connector → paste URL → Save.
- ChatGPT: Settings → Apps & Connectors → enable Developer mode → Create app (MCP) → paste URL → No authentication → Connect.
All 46 tools register on the plain URL. Whether a live/provider-backed call can return current data depends on the credentials, quota, and fallbacks available to the hosted operator; the repository does not claim the public instance's current key inventory.
| Mode | What is available |
|---|---|
| Hosted | All tools register; live/provider-backed results depend on the host's current keys, quota, and fallbacks. |
| Local, keyless | All tools register; bundled seeds and keyless sources work where supported, while credential-only live sources are skipped. |
| Local, BYO keys | The same tools can use the configured providers for fresher/live data, subject to provider quota. |
The hosted HTTP boundary rejects request bodies over 1 MiB, limits traffic to 60 requests per client and 300 total requests per minute, and permits at most two concurrent expensive model/solver calls. These counters are per process, so the home-server Compose stack runs one replica (always-on idle; no scale-to-zero).
Local install
uvx sportiq-mcp # from PyPI
or from source:
git clone https://github.com/Ninjabeam20/SportIQ-MCP && cd SportIQ-MCP uv sync --extra dev && uv run python -m sportiq.server # --extra dev = pytest/ruff for contributors
Claude Desktop config:
{
"mcpServers": { "sportiq": { "command": "uvx", "args": ["sportiq-mcp"], "env": { "CRICAPI_KEY": "your_cricapi_key", "APIFOOTBALL_KEY": "your_apifootball_key", "THEODDS_KEY": "your_theodds_key" } } } }
The server boots and registers every tool without keys. Seed/keyless fallbacks and the intelligence layer work where their required inputs are available; provider keys add fresher/live sources and quota rather than unlocking a separate paid tool tier.
| Var | Unlocks | Free tier |
|---|---|---|
APIFOOTBALL_KEY | Live football fixtures / standings / squads / scorers | 100 req/day |
THEODDS_KEY | Market odds (football + cricket probability tools) | 500 req/month |
FOOTBALLDATA_KEY | football-data.org fallback — required for World Cup endpoints (they return 403 without it) | 10 req/min, 100/day |
CRICAPI_KEY | Live cricket scores / scorecards / schedules / squads | 100 req/day |
RAPIDAPI_KEY | Paid Cricbuzz fallback (player career stats) | plan-dependent |
SPORTIQ_ENABLE_NDTV / SPORTIQ_ENABLE_CRICBUZZ | Opt-in cricket scrapers (off by default — ToS) | — |
REDIS_URL | Shared cache backend (defaults to local diskcache) | — |
SPORTIQ_TRANSPORT | stdio (default, local) or http (remote / home server) | — |
TOOL_DEADLINE_SECONDS | Per-tool deadline (default 30); a slower call returns UPSTREAM_TIMEOUT | — |
macOS arm64: the Dream11 solver needs CBC —
brew install cbc(the binary bundled with PuLP is x86-only).
Self-host
Set SPORTIQ_TRANSPORT=http and the server serves the MCP endpoint at /mcp (binds 0.0.0.0:$PORT). GET /healthz returns 200 ok for liveness only (it never touches the cache, chains or network). A ready-to-build Dockerfile and home-server docker-compose.yml are included. cloud.md is the old Cloud Run runbook (historical). With your own keys set, the live-score and odds tools come online too.
Support SportIQ
Every tool is free and open source — the raw-data tools, sportiq_health, and the full intelligence layer (the three flagships + everything in the INTEL columns). SportIQ has no paid feature gate; provider-backed data can still require operator credentials and quota.
If SportIQ saves you time, [sponsor the project at github.com/sponsors/Ninjabeam20](https://github.com/sponsors/Ninjabeam20) to help fund hosting and ongoing development. It's a voluntary donation — you get the same fully-unlocked server either way.
Is it safe?
- Open source, MIT licensed, published on PyPI with signed build attestations — read the code before you connect it.
- Read-only. Tools only fetch and analyse public sports data — no write, delete, payment, email, or file-system tools.
- Limited operational telemetry. HTTP mode logs client software name/version, User-Agent, tool name, outcome, latency, selected source, and staleness. The public host (Dell) can persist
tool_call/mcp_requestlines to a local JSONL volume. Local stdio emits local logs but sends no telemetry to a SportIQ-hosted service. - Hosted abuse controls. HTTP POST bodies are capped at 1 MiB; requests are limited to 60/client/minute and 300/process/minute; the seven expensive simulation/strategy/solver tools share a concurrency limit of two; every tool call has a 30 s deadline (
TOOL_DEADLINE_SECONDS) and each fallback chain a 15 s total