NBA MCP Server

What is NBA MCP Server about?

NBA MCP Server enables Claude, Anthropic's LLM, to retrieve recent NBA game results and detailed player performance data that the model cannot generate on its own. It leverages the open‑source nba_api library to pull official statistics.

How to use NBA MCP Server?

1. Clone the repository.
2. In the project directory run:

   uv venv
   .venv\Scripts\activate   # or `source .venv/bin/activate` on Unix
   uv pip install -e .
   

3. Add the server configuration to your Claude MCP settings, pointing to the running Python service.

Key features of NBA MCP Server

• Retrieve final scores for all games that occurred yesterday or any past date.
• Obtain basic point/rebound/assist breakdowns for every player in those games.
• Access full box‑score details: points, rebounds, assists, steals, blocks, turnovers, plus/minus, minutes played.
• Fetch the "four factors" (effective field goal %, turnover %, offensive rebounding %, free‑throw rate) for each game.

Use cases of NBA MCP Server

• Enabling conversational agents to answer sports trivia with up‑to‑date stats.
• Building analytics dashboards that supplement LLM‑generated insights.
• Supporting fantasy sports assistants that need recent performance data.
• Enhancing news summarization tools with accurate game results.

FAQ from the NBA MCP Server

Q: Do I need an API key for nba_api? A: No, nba_api accesses publicly available NBA data without authentication.

Q: Can I query games from a specific date range? A: The server currently supports "yesterday" or any past date via the provided endpoints.

Q: Is the server compatible with other LLMs? A: Yes, any model that supports the MCP protocol can interact with this server.

Q: How do I update the data source? A: The server pulls the latest data each request, so no manual updates are required.

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