Query NBA Game and Player Statistics
MCP server giving Claude access to recent NBA scores, player stats, and four factors via the nba_api library.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Access and retrieve detailed NBA game and player statistics using the nba_api. This asset enables querying final scores, player performance breakdowns, and advanced game metrics for past and recent games.
Outcomes
What it gets done
Retrieve final scores for past and recent NBA games.
Fetch player statistics (points, rebounds, assists, etc.) for games played.
Access advanced game statistics like four factors.
Integrate with Claude for data retrieval.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-nba | bash Overview
NBA MCP Server
An MCP server wrapping the nba_api library to give Claude accurate scores, player box scores, and four-factors stats for past NBA games. Use when Claude needs accurate recent or historical NBA game results and player stats. Scoped to completed games only, not live or future game tracking.
What it does
NBA MCP Server gives Claude access to recent NBA games and stats that the model otherwise struggles to answer accurately, by wrapping the open-source nba_api Python library. It fetches final scores for games that happened yesterday or in the past, a basic points/rebounds/assists breakdown for all players in those games, the full per-player stat line (points, rebounds, assists, steals, blocks, turnovers, plus-minus, and minutes played), and the four factors for completed games.
uv venv
.venv\Scripts\activate
uv pip install -e .
When to use - and when NOT to
Use this connector when you need Claude to answer questions about recent or historical NBA game results and player statistics with accurate, sourced data rather than relying on the model's own (often outdated or unreliable) knowledge of recent games.
It is scoped to games that have already happened (yesterday or earlier) - it is not built for live, in-progress game tracking or future schedule lookups, and its data is only as current and accurate as the underlying nba_api library and NBA's own public stats feeds.
Capabilities
Fetch final scores for past games, fetch basic P/R/A breakdowns per player, fetch full box-score stats (PTS/REB/AST/STL/BLK/TO/PLUS_MINUS/MIN) per player, and fetch the four factors for completed games.
How to install
Clone the repository, create a virtual environment with uv (uv venv), activate it, and install in editable mode (uv pip install -e .). Then add the server to your Claude configuration like any other MCP server.
Who it's for
NBA fans and analysts who want Claude to answer questions about recent game results and player stats with accurate, sourced data instead of the model's own limited built-in knowledge.
Source README
NBA MCP Server
Description
An MCP server for Anthropic's Claude LLM that allows the model to fetch recent NBA games and stats that it struggles to currently. It does this using the opensource nba_api
Installation
Run these steps in the directory where you have cloned the repo
uv venv
.venv\Scripts\activate
uv pip install -e .
Then add the configuration to your Claude config as you would for any other MCP Server.
Features
- Fetch the fetch the final score for all game(s) that happened yesterday / in the past
- Fetch the basic P/R/A breakdown for all players that played in game(s) that happened yesterday / in the past
- Fetch the full PTS/REB/AST/STL/BLK/TO/PLUS_MINUS/MIN that happened yesterday / in the past
- Fetch the four factors for all the game(s) that happened yesterday / in the past
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.