nbastatpy 0.4.1

An easy-to-use wrapper for nba_api to easily find data for a player, game, team, or season

NBAStatPy

Overview

A simple, easy-to-use wrapper for the nba_api package to access NBA data for players, games, teams, and seasons.

Quick Start

from nbastatpy.player import Player

# Create a player object
player = Player("Giannis", season="2023", playoffs=True)

# Get data
awards = player.get_awards()
stats = player.get_career_stats()

Main Classes

• Player - Access player stats, career data, and awards
• Game - Get boxscores, play-by-play, and game details
• League - Query league-wide stats, lineups, and tracking data
• Team - Retrieve team rosters, stats, and splits

Standalone Usage

from nbastatpy.standardize import standardize_dataframe

df = standardize_dataframe(df, data_type='player')

MCP Server

NBAStatPy includes a Model Context Protocol (MCP) server that allows AI assistants like Claude to access NBA statistics data.

Quick Start (No Installation Required)

Using uvx, you can run the MCP server directly without installing:

uvx nbastatpy

Adding to Claude Code

Option 1: CLI Command (Recommended)

claude mcp add nbastatpy -- uvx nbastatpy

Option 2: Manual Configuration

Add to your ~/.claude.json (user-level) or .mcp.json (project-level):

{
  "mcpServers": {
    "nbastatpy": {
      "type": "stdio",
      "command": "uvx",
      "args": ["nbastatpy"]
    }
  }
}

Option 3: With pip install

{
  "mcpServers": {
    "nbastatpy": {
      "command": "python",
      "args": ["-m", "nbastatpy.mcp.server"]
    }
  }
}

Available Tools

The MCP server provides tools for accessing NBA data:

Tool	Description
get_player_salary	Get player salary data by name
get_player_game_logs	Get recent game logs for a player
get_player_career_stats	Get season-by-season career statistics
get_player_play_type_stats	Get play type (synergy) stats for a player
get_player_tracking_stats	Get tracking stats (drives, touches, etc.)
get_league_leaders	Get league leaders for any stat category
get_team_recent_games	Get recent games for a team
get_team_play_type_stats	Get play type stats for a team
get_team_tracking_stats	Get tracking stats for a team
get_recent_games_summary	Get summary of recent NBA games
get_recent_games_player_stats	Get player stats from recent games

Installation

Pip

pip install nbastatpy

UV

uv add nbastatpy