Quick Start

This guide gets you from API key to first working request.

1. Get Your API Key

After you subscribe, Scottfree Sports sends a welcome email with your API key. You can also view and manage keys in the Account page:

text

https://sports-app.scottfreellc.com/app/account

Export it in your shell:

bash

export SFS_API_KEY="sk_alphapysports_PASTE_YOUR_KEY"

2. List Sports And Models

bash

curl -H "X-API-Key: $SFS_API_KEY" \
  https://sports-api.scottfreellc.com/api/v1/sports

You should see a response with all six sports and three model types. Abbreviated example:

json

{
  "sports": [
    {"code": "mlb", "name": "Major League Baseball"},
    {"code": "nba", "name": "National Basketball Association"}
  ],
  "model_types": [
    {"code": "over_under", "name": "Over/Under"},
    {"code": "won_on_points", "name": "Moneyline"},
    {"code": "won_on_spread", "name": "Point Spread"}
  ]
}

3. Get Predictions

bash

curl -H "X-API-Key: $SFS_API_KEY" \
  https://sports-api.scottfreellc.com/api/v1/predictions/mlb/won_on_points

Response shape:

json

{
  "sport": "mlb",
  "model_type": "won_on_points",
  "predictions_date": "2026-05-23T14:12:05.000000",
  "games": [
    {
      "date": "2026-05-23",
      "time": "19:10:00",
      "away_team": "new_york_yankees",
      "home_team": "colorado_rockies",
      "predictions": {
        "IMPLIED": 0.3741,
        "BLEND": 0.4112,
        "XGB": 0.3929
      },
      "away_money_line": -135,
      "home_money_line": 115
    }
  ],
  "models_used": ["IMPLIED", "AI", "BLEND", "CATB", "RF", "LGB", "LOGR", "XGB", "XT"]
}

For spreads:

bash

curl -H "X-API-Key: $SFS_API_KEY" \
  https://sports-api.scottfreellc.com/api/v1/predictions/nfl/won_on_spread

For totals:

bash

curl -H "X-API-Key: $SFS_API_KEY" \
  https://sports-api.scottfreellc.com/api/v1/predictions/nba/over_under

4. Get Results And Summary

5. Check Usage

bash

curl -H "X-API-Key: $SFS_API_KEY" \
  https://sports-api.scottfreellc.com/api/v1/customers/me/usage

6. Use The CLI

Premium customers can install the CLI:

bash

python3 -m pip install --upgrade scottfree-sports-cli
sfs config set --api-key "$SFS_API_KEY"
sfs predictions get mlb ml
sfs brief get mlb

7. Use MCP

Premium customers can connect sfs-mcp to Claude Desktop, Claude Code, Cursor, or another MCP host:

bash

which sfs-mcp

See MCP Server Setup.

Next Steps

Need help: scottfree.analytics@scottfreellc.com

Quick Start #

1. Get Your API Key #

2. List Sports And Models #

3. Get Predictions #

4. Get Results And Summary #

5. Check Usage #

6. Use The CLI #

7. Use MCP #

Next Steps #

Quick Start

1. Get Your API Key

2. List Sports And Models

3. Get Predictions

4. Get Results And Summary

5. Check Usage

6. Use The CLI

7. Use MCP

Next Steps