🏀 NBA MCP Server

Access comprehensive NBA statistics via Model Context Protocol

A Model Context Protocol (MCP) server that provides access to live and historical NBA data including player stats, game scores, team information, and advanced analytics. v0.3.0: All 21 tools accept human names (not just IDs), return structured data + compact text, and default season to current. Optimized for both large and small LLM clients.

Quick Start with Claude Desktop

1. Install the server:

# Using uvx (recommended - no install required)
uvx nba-stats-mcp

# Or using pip
pip install nba-stats-mcp

# Or from source
git clone https://github.com/labeveryday/nba-stats-mcp.git
cd nba-stats-mcp
uv sync

2. Add to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nba-stats": {
      "command": "uvx",
      "args": ["nba-stats-mcp"]
    }
  }
}

Or if you installed from source:

{
  "mcpServers": {
    "nba-stats": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/nba-stats-mcp/",
        "run",
        "nba-stats-mcp"
      ]
    }
  }
}

3. Restart Claude Desktop

What You Can Ask

• “Show me today’s NBA games”
• “What are LeBron James’ stats this season?”
• “Get the box score for Lakers vs Warriors”
• “Who are the top 10 scorers this season?”
• “Show me all-time assists leaders”
• “When do the Celtics play next?”
• “Get Stephen Curry’s shot chart”
• “Who are the league leaders in deflections?”
• “Show me Giannis’ career awards”

Available Tools (21 total)

All tools accept human names — no need to resolve IDs first. Every response includes structured data + compact text.

Player Tools

• get_player_info(player) - Player bio and details (accepts name or ID)
• get_player_stats(player, stat_type) - Season, career, game log, hustle, defense, or advanced stats
• get_player_awards(player) - All awards and accolades
• get_shooting_data(player, data_type) - Shot chart or shooting splits

Team Tools

• get_team_roster(team) - Team roster (accepts team name or ID)
• get_team_advanced_stats(team) - Team efficiency metrics (ORtg, DRtg, pace)
• get_schedule(team) - Upcoming games
• get_standings() - League standings by conference

Game Tools