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

WNBA Support

NBAStatPy supports WNBA data out of the box. Player and Team classes automatically detect whether a player or team belongs to the NBA or WNBA:

from nbastatpy.player import Player
from nbastatpy.team import Team

# WNBA players are auto-detected
player = Player("A'ja Wilson")
print(player.league)  # "WNBA"
stats = player.get_career_stats()

# WNBA teams are auto-detected by abbreviation
team = Team("LVA")  # Las Vegas Aces
print(team.league)  # "WNBA"
roster = team.get_roster()

For league-wide WNBA data, pass the league parameter:

from nbastatpy.league import League

wnba_season = League(2024, league="WNBA")
leaders = wnba_season.get_league_leaders(stat_category="PTS")

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:

Installation

Pip

pip install nbastatpy

UV

uv add nbastatpy