labeveryday/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:
2. Add to your Claude Desktop config file:
**MacOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
**Windows**: %APPDATA%/Claude/claude_desktop_config.json
Or if you installed from source:
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
- get_scoreboard(date?) - Games for a date (defaults to today)
- find_game(team1, team2?, date?) - Find game_id by team matchup
- get_game_details(game_id) - Live game info with team stats
- get_box_score(game_id) - Full box score with player stats
- get_play_by_play(game_id) - Play-by-play with timestamps
- get_game_rotation(game_id) - Player rotation/substitution data
League Tools
- get_leaders(category, scope) - Current season, all-time, or hustle leaders
- get_season_awards(season?) - Season MVP and major awards
Composite Tools (new in v0.3.0)
- compare_players(player1, player2) - Side-by-side player comparison
- daily_summary(date?) - All games + scores for a date
- team_overview(team) - Roster + record + upcoming schedule
Resolution Tools
- resolve_player_id(query) - Fuzzy match player name to ID
- resolve_team_id(query) - Fuzzy match team name to ID
Visual Assets (Public NBA CDN)
This MCP server also returns **public NBA CDN asset URLs** (no API key) alongside IDs in several tool responses, so UI clients can render visuals.
- **Player headshots**:
- Full size: https://cdn.nba.com/headshots/nba/latest/1040x760/{playerId}.png
- Thumbnail: https://cdn.nba.com/headshots/nba/latest/260x190/{playerId}.png
- **Team logos (SVG)**:
- https://cdn.nba.com/logos/nba/{teamId}/global/L/logo.svg
Tools that include these URLs:
- **players**: resolve_player_id, get_player_info, get_player_stats
- **teams**: resolve_team_id, get_standings, get_team_roster