Scottfree Sports Overview

Scottfree Sports is the customer-facing layer on top of AlphaPy Sports. Basic gives you the web dashboard and REST API. Premium adds the Python CLI and conversational access through Claude Desktop, Claude Code, Cursor, and other MCP-capable assistants. ChatGPT support depends on your ChatGPT plan/workspace supporting custom remote MCP apps/connectors.

Four ways to use your data

1. Scottfree Sports web app — browse and manage

A clean web dashboard for reading predictions, tracking model performance, and managing your account.

Browse daily model probabilities across all 6 sports and 9 model columns
View historical results and model performance summaries
Manage your API keys, see your request usage
Subscribe to Scottfree Sports Data and trigger dataset refreshes
Works on desktop and mobile browsers

You'll get the web app URL in your welcome email along with your API key. Paste the key in Settings and you're in.

2. REST API — use your own tools

The raw data, behind authentication, returned as JSON. Integrate predictions into your own dashboards, trading bots, or research notebooks.

GET /api/v1/predictions/{sport}/{model} — today's predictions
GET /api/v1/results/{sport}/{model} — historical results
GET /api/v1/summary/{sport}/{model} — model performance summaries
GET /api/v1/odds/{sport} — current odds
Three authentication methods: X-API-Key header, Authorization: Bearer, or ?api_key= query param

See the API docs for the full endpoint reference.

3. Python CLI (`sfs`) — query from the terminal

A Premium command-line tool wrapping the REST API. Use it interactively, script with it, or pipe results into your own analysis tools.

bash

sfs predictions get nba over_under
sfs results get nfl won_on_spread --limit 20
sfs summary get mlb over_under

Install the current CLI release with python3 -m pip install --upgrade scottfree-sports-cli. The CLI includes twelve command groups and 23 subcommands covering predictions, odds, results, summaries, and account management.

4. Claude Desktop / Cursor / MCP-capable assistants — chat with your data

The Premium sfs-mcp server exposes Scottfree Sports as MCP tools. Once configured, your assistant can query your data directly and answer questions in plain English. This is meant for betting research: model picks, line movement, odds, model history, public consensus, weather, injuries, and prediction-market context in one conversation.

Example conversations with Claude Desktop:

You: Show me tonight's NBA over/under model picks and the supporting research.
Claude: Calls get_daily_brief, get_predictions, get_odds, and get_summary, then explains the model pick, model probability, market-implied probability, and recent model performance.

You: How has the over/under model been doing for MLB this week?
Claude: Calls get_summary and get_results, then summarizes recent model performance and line-movement history.

Setup is a one-time copy-paste into your assistant config for local MCP hosts such as Claude Desktop and Cursor. Premium includes 16 public MCP tools covering model probabilities, line movement through opener/current fields, odds, results, summaries, public consensus, prediction markets, weather, live scores, injuries, rosters, and account info.

Data coverage

Sports: MLB, NBA, NFL, NHL, NCAAF, NCAAB
Model columns: CatBoost, LightGBM, XGBoost, Random Forest, Extra Trees, Logistic Regression, AI, Implied, Blend (9 total)
Prediction targets: over/under, won on spread (ATS), moneyline (won on points)
Update cadence: daily predictions, every-2-hours odds refresh, daily model training

Pricing

Scottfree Sports Basic — $39/month, 50,000 requests, web app and REST API
Scottfree Sports Premium — $59/month, 200,000 requests, web app, REST API, CLI, MCP, and priority support
Scottfree Sports Data — $19/month, refresh the historical odds datasets you own up to 8 times per month

View pricing details →

Getting started

The full step-by-step guide is in Getting Started with Scottfree Sports. The short version:

Buy a Scottfree Sports subscription on our store
Check your email for your API key and the Scottfree Sports web app URL
Paste the key into the web app and start browsing
(Optional) Install the CLI and configure the MCP for Claude Desktop / Cursor

Scottfree Sports Overview #

Four ways to use your data #

1. Scottfree Sports web app — browse and manage #

2. REST API — use your own tools #

3. Python CLI (sfs) — query from the terminal #

4. Claude Desktop / Cursor / MCP-capable assistants — chat with your data #

Data coverage #

Pricing #

Getting started #

Next steps #