pip install sportiq-mcp==0.2.1

Released: Jun 8, 2026

MCP server for FIFA World Cup 2026 football, Formula 1, and IPL cricket intelligence tools.

Navigation

Verified details

Unverified details

  • License: MIT License (MIT)
  • Author: Utkarsh Gupta
  • Tags cricket , f1 , fantasy , football , mcp , sports
  • Requires: Python >=3.11
  • Provides-Extra: dev , f1
  • Development Status 4 - Beta
  • 4 - Beta
  • Intended Audience Developers
  • Developers
  • License OSI Approved :: MIT License
  • OSI Approved :: MIT License
  • Programming Language Python :: 3.11 Python :: 3.12 Python :: 3.13
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Topic Software Development :: Libraries
  • Software Development :: Libraries

Project description

MCP server exposing AI-callable tools across FIFA World Cup 2026 football, Formula 1, and IPL cricket.

Three flagship intelligence tools sit on top of raw-data primitives:

  • football_simulate_bracket — Monte Carlo with Poisson xG projects World Cup qualification probabilities.
  • f1_predict_pit_strategy — tyre-degradation model on OpenF1 telemetry recommends stop laps and compounds.
  • cricket_build_dream11_team — PuLP constraint solver picks a valid 11 under credit/role/team caps.

Status

44 tools live: 7 football RAW + 8 football INTEL + 6 F1 RAW + 7 F1 INTEL + 6 cricket RAW + 8 cricket INTEL + 1 cross-sport + sportiq_health. All three flagships shipped: football_simulate_bracket (Monte Carlo + Poisson xG over the 48-team WC 2026 format), f1_predict_pit_strategy (tyre-degradation on OpenF1 telemetry), and cricket_build_dream11_team (PuLP ILP).

Football tools (FIFA World Cup 2026)

RAW

INTEL

The 2026 format (48 teams, 12 groups, top 2 + 8 best thirds → 32-team knockout) is encoded in wc2026.json. Data sources: API-Football (APIFOOTBALL_KEY) → football-data.org (free, token optional) → bundled wc2026.json seed.

F1 Tools

RAW

INTEL

Data sources: OpenF1 (free, keyless) → Jolpica → fastf1 (optional, offline, pip install sportiq-mcp[f1]).

Cricket tools

RAW

INTEL

The Dream11 solver uses CBC via PuLP. On macOS arm64 install with brew install cbc; the binary bundled with PuLP is x86-only and won't run on Apple Silicon.

Cross-sport tools

Diagnostics

Cricket adapter defaults

By default only CricAPI (key required) and static data are active. Opt-in adapters:

Copy .env.example to .env and fill in keys.

RapidAPI Hub MCP servers

.mcp.json also wires three external RapidAPI Hub MCP servers (Sportspage Feeds, Football Prediction, Live Sports Odds) via mcp-remote. Because .mcp.json is committed, the API key is a placeholder — replace each <RAPIDAPI_KEY> in .mcp.json with your real RapidAPI key locally to enable them. They run as separate MCP servers and do not affect the in-process sportiq tools.

Install

Claude Desktop config

All env vars are optional — the server boots and serves seed/free-source data without any keys. Add a key to unlock the source it gates (e.g. THEODDS_KEY for the value-bet tools). F1 and most football tools use free, keyless sources.

Environment variables

Transport: stdio only (local subprocess), which is the right fit for a single-client desktop integration. There is no remote/streamable-HTTP endpoint; running it as a shared remote service is out of scope.

Develop

See CLAUDE.md for collaboration rules and docs/index.md for the wiki entry point.

License

Project details

Verified details

Unverified details

  • License: MIT License (MIT)
  • Author: Utkarsh Gupta
  • Tags cricket , f1 , fantasy , football , mcp , sports
  • Requires: Python >=3.11
  • Provides-Extra: dev , f1
  • Development Status 4 - Beta
  • 4 - Beta
  • Intended Audience Developers
  • Developers
  • License OSI Approved :: MIT License
  • OSI Approved :: MIT License
  • Programming Language Python :: 3.11 Python :: 3.12 Python :: 3.13
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Topic Software Development :: Libraries
  • Software Development :: Libraries

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Uploaded Jun 8, 2026 Source

Built Distribution

Filter files by name, interpreter, ABI, and platform.

If you're not sure about the file name format, learn more about wheel file names.

Copy a direct link to the current filters

Uploaded Jun 8, 2026 Python 3

File details

Details for the file sportiq_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: sportiq_mcp-0.2.1.tar.gz
  • Upload date: Jun 8, 2026
  • Size: 333.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

See more details on using hashes here.

Provenance

The following attestation bundles were made for sportiq_mcp-0.2.1.tar.gz:

Publisher: release.yml on Ninjabeam20/SportIQ-MCP

File details

Details for the file sportiq_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: sportiq_mcp-0.2.1-py3-none-any.whl
  • Upload date: Jun 8, 2026
  • Size: 122.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

See more details on using hashes here.

Provenance

The following attestation bundles were made for sportiq_mcp-0.2.1-py3-none-any.whl:

Publisher: release.yml on Ninjabeam20/SportIQ-MCP

Source: Pypi.org