SportsQuant Server

License: MIT MCP Version

Quant-Sports MCP is a high-performance Model Context Protocol (MCP) server that wraps the quantitative_sports 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 quant-sports-mcp

OpenCode Integration

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

{
  "mcpServers": {
    "quantitative_sports": {
      "command": "uv",
      "args": ["run", "quant-sports-mcp"],
      "env": {
        "QUANT_SPORTS_BETTING_MATH": "true",
        "QUANT_SPORTS_BACKTESTING": "true",
        "QUANT_SPORTS_PREDICTIONS": "true",
        "QUANT_SPORTS_RATINGS": "true",
        "QUANT_SPORTS_DATA_SOURCES": "true",
        "QUANT_SPORTS_PORTFOLIO": "true",
        "QUANT_SPORTS_PARLAY": "true",
        "QUANT_SPORTS_ANALYSIS": "true"
      }
    }
  }
}

⚙️ 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 Quant-Sports 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 Quant-Sports data warehouse.

📄 License

MIT License. See LICENSE file for details.