SportsQuant MCP Server — Quick Start Guide

SportsQuant MCP is a high-performance Model Context Protocol (MCP) server that wraps the sportsquant quantitative sports betting toolkit. It provides AI agents with professional-grade tools for expected value (EV) calculation, Monte Carlo predictions, historical backtesting, and portfolio risk management.

🚀 Quick Start

Installation

Ensure you have uv installed. Navigate to the project root and run:

uv sync
uv run sportsquant-mcp

OpenCode Integration

Add the following to your opencode.json to enable the server with all categories:

{
  "mcpServers": {
    "sportsquant": {
      "command": "uv",
      "args": ["run", "sportsquant-mcp"],
      "env": {
        "SPORTSQUANT_BETTING_MATH": "true",
        "SPORTSQUANT_BACKTESTING": "true",
        "SPORTSQUANT_PREDICTIONS": "true",
        "SPORTSQUANT_RATINGS": "true",
        "SPORTSQUANT_DATA_SOURCES": "true",
        "SPORTSQUANT_PORTFOLIO": "true",
        "SPORTSQUANT_PARLAY": "true",
        "SPORTSQUANT_ANALYSIS": "true"
      }
    }
  }
}

Related MCP server: Polymarket MCP Server

⚙️ Configuration Reference

The server uses a category-based toggle system. You can enable/disable groups of tools via environment variables or a JSON config file.

Environment Variables

📚 Documentation

• TOOLS.md: The comprehensive tool reference including parameter types, return formats, and mathematical formulas for all 37 tools.

• ARCHITECTURE.md: Technical specification and implementation details.

🛠 Companion Servers

For a complete quantitative betting workflow, we recommend integrating SportsQuant with:

• Neuralgentics / memini-ai: For long-term memory of strategy performance.

• boomerang-v3: To orchestrate complex "Research $\rightarrow$ Predict $\rightarrow$ Size $\rightarrow$ Deploy" workflows.

• Calculator MCP: For independent verification of complex math.

• PostgreSQL MCP: For direct access to the SportsQuant data warehouse.

📄 License

MIT License. See LICENSE file for details.