


Setup guide
From zero to analyst in 3 steps
SportIQ runs as a hosted MCP server. Add it as a custom connector in Claude, ChatGPT or Cursor, sponsor Pro, and paste your key. Two minutes, no build step.
Add the connector
Paste the hosted SportIQ URL into your AI client as a custom MCP connector — or run it locally with uvx.
Sponsor Pro
Sponsor SportIQ on GitHub at the Pro or Lifetime tier. Your Pro key arrives instantly in the welcome message.
Paste your key
Drop the key into your config as SPORTIQ_PRO_KEY. All 24 intelligence tools unlock immediately.
Hosted MCP endpoint — every tool is free right now while in trial:
https://sportiq-mcp-329580761892.us-central1.run.app/mcpPick your client
Claude.ai
Custom connector- 1.Open Settings → Connectors → Add custom connector.
- 2.Paste the hosted MCP URL below.
- 3.Approve the tools when Claude prompts you.
ChatGPT / Cursor
Any MCP client- 1.Open your client's MCP / connectors settings.
- 2.Add a new server pointing at the hosted URL (or the uvx command).
- 3.Reload — the SportIQ tools appear in the tool list.
Local (uvx)
Run it yourself- 1.Make sure uv is installed (pipx install uv).
- 2.Run uvx sportiq-mcp, or add the JSON config to claude_desktop_config.json.
- 3.Set your API keys + SPORTIQ_PRO_KEY in the env block.
Quickstart Config
Command Line
uvx sportiq-mcpClaude Config (JSON)
{
"mcpServers": {
"sportiq": {
"command": "uvx",
"args": ["sportiq-mcp"],
"env": {
"CRICAPI_KEY": "optional",
"APIFOOTBALL_KEY": "optional",
"THEODDS_KEY": "optional",
"SPORTIQ_PRO_KEY": "sq_your_key_here"
}
}
}
}No keys? It still runs on free seed + public-source data.
No install? Add the hosted server as a custom connector — every tool, including the Pro intelligence layer, is free right now: …run.app/mcp
The Claude.ai connector flow
What it looks like, click by click.
Where the Pro key goes
After you sponsor at the Pro ($10/mo) or Lifetime ($49 one-time) tier, your key arrives in the GitHub Sponsors welcome message. Set it as SPORTIQ_PRO_KEY in your MCP config's env block — that's the only thing standing between you and the full intelligence layer.
SportIQ is an analytics and entertainment tool. Betting outputs surface probabilities and value — not guarantees. Not financial advice; bet responsibly, and only where it's legal for you.