MCP server documentation

Find NBA players and teams by (partial) name. Returns slugs to use with get_player / get_team.

PARAMETERS

RETURNS

season, players[] (slug, full_name, team, position, gp, pts, reb, ast) and teams[] (slug, abbreviation, name). Up to 10 players, ordered by scoring.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "jokic"
    }
  }
}

Schedule and results for one date (YYYY-MM-DD, default today UTC). Returns game_id for get_game.

PARAMETERS

RETURNS

date, count and games[]: game_id, game_date, game_time_utc, status (scheduled / live / final), period, scores, and both teams' id, abbreviation, name, slug and colour.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_games",
    "arguments": {
      "date": "2026-10-27"
    }
  }
}

One game by game_id: teams, status, score, model projection, and (with picks:read) the model's picks and player prop lines.

The picks and prop_lines sections need picks:read; without it they read “requires picks:read scope”.

PARAMETERS

RETURNS

game; projection (model version, home_win_prob, projected points for each side, projected_total, projected_spread, injury adjustments in points); picks.game (team markets), picks.players (player props) and picks.prop_lines (every line offered for every player).

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_game",
    "arguments": {
      "game_id": "0022600128",
      "sections": [
        "projection",
        "picks"
      ]
    }
  }
}

Bio, season averages and recent game log for a player (slug from search).

PARAMETERS

RETURNS

player (bio, team, position, draft), season, season_stats (per-game averages, shooting splits, rebounds split, fouls drawn, plus-minus) and recent_games[] (box score line per game, newest first).

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_player",
    "arguments": {
      "slug": "nikola-jokic",
      "games": 10
    }
  }
}

Record, team stats, roster and latest games for a team (slug from search).

PARAMETERS

RETURNS

season, team (record, per-game team stats and league ranks), roster[] with each player's per-game averages, and recent_games[] — the team's 10 latest games by date, scheduled ones included.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_team",
    "arguments": {
      "slug": "boston-celtics"
    }
  }
}

Top players by a per-game stat for a season.

PARAMETERS

RETURNS

season, stat and leaders[] in rank order — player slug and name, position, team, games played and the per-game value.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_leaderboard",
    "arguments": {
      "stat": "ast",
      "limit": 10
    }
  }
}

Current value picks from the HoopMetrics model: game markets (moneyline, totals, handicap) and top player props, ordered by edge, each with the bookmaker selection behind its price (sb_event_id / sb_market_id / sb_selection_uuid). Requires picks:read.

PARAMETERS

RETURNS

note, game_picks[] and player_picks[], ordered by edge: game_id, market, selection, line, price, model_prob, implied_prob, edge, verdict, sample_games, the bookmaker selection ids (sb_*) and price_captured_at. Player picks add the player, projection, hit rates (last 5, last 15, season, head-to-head) and the opponent's rank against that stat.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_picks",
    "arguments": {
      "only_value": true,
      "player_limit": 20
    }
  }
}