NBA MCP Server
A simple MCP (Model Context Protocol) server for getting NBA data through nba_api. This server allows LLMs to retrieve live game data, player stats, team stats, game logs, team standings, and more.
Demo
https://github.com/user-attachments/assets/ce448f94-0226-4303-95e2-19f125a83a02
Tools
Player Tools
get_player_career_stats(player_id: str)
Gets comprehensive career statistics for a player.
get_player_awards(player_id: str)
Retrieve all awards and achievements for a player, including MVP awards, All-Star selections, championships, etc.
get_player_game_log(player_id: str, season: str, season_type: str)
Player game-by-game statistics and results.
Team Tools
get_team_details(team_id: str)
Get comprehensive team information includes championships, conference awards, division awards, history, and background.
get_team_year_by_year_stats(team_id: str)
Historical year-by-year team performance statistics.
get_team_game_log(team_id: str, season: str, season_type: str)
Team game-by-game statistics and results.
get_league_team_standings(season: str, season_type: str)
Standings for all teams in the league by season.
Live Game Tools
get_today_scoreboard()
Retrieves today's NBA games, including live scores, game statuses, and teaminformation.
get_live_game_boxscore(game_id: str)
Gets live game data, including scores, player stats, timeouts, and more.
get_live_game_play_by_play(game_id: str)
Gets live play-by-play data from a game.
Resources
nba://players
Returns a list of all NBA players (past and present).
nba://active_players
Returns a list of currently active NBA players.
nba://teams
Returns a list of all NBA teams.
Usage
To use this MCP server with Claude for Desktop, add either of the following to your Claude Desktop config file.
Via uv:
{
"mcpServers": {
"nba_mcp": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/nba_mcp",
"run",
"server.py"
]
}
}
}
Via Docker:
{
"mcpServers": {
"nba_mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"stevenyuser/nba-mcp"
]
}
}
}