NBA MCP Server

Name: NBA MCP Server
Author: Taidgh-Robinson

@Taidgh-Robinson

Repository

About NBA MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "nba-mcp-server-taidgh-robinson": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is NBA MCP Server?

An MCP server for Anthropic's Claude LLM that enables the model to fetch recent NBA games and stats that it struggles to recall. It uses the open-source nba_api library.

How to use NBA MCP Server?

Clone the repository, create a virtual environment with uv venv, activate it, and install the package with uv pip install -e .. Then add the server configuration to your Claude desktop app as you would for any MCP server.

Key features of NBA MCP Server

Fetch final scores for games from yesterday or the past.
Fetch basic points/rebounds/assists breakdown for players in those games.
Fetch full stats including PTS, REB, AST, STL, BLK, TO, PLUS_MINUS, MIN.
Fetch the four factors (eFG%, FTA rate, TOV%, OREB%) for past games.

Use cases of NBA MCP Server

Ask Claude for yesterday's NBA scores and box scores.
Get per-player stat lines for any completed NBA game day.
Analyze team or player performance using the four factors.

FAQ from NBA MCP Server

What data does NBA MCP Server fetch?

It fetches game scores, basic points/rebounds/assists, full player stats (PTS, REB, AST, STL, BLK, TO, PLUS_MINUS, MIN), and the four factors for games that occurred yesterday or in the past.

How do I install NBA MCP Server?

Run uv venv, activate the virtual environment, then uv pip install -e . in the cloned repository directory. Finally, add the server to your Claude MCP configuration.

What runtime or dependencies does NBA MCP Server require?

It requires Python and the nba_api package, which is installed automatically via the pip install command. It does not appear to require any API key or external authentication.

What time period of games does NBA MCP Server cover?

It only retrieves games from "yesterday or in the past" – it does not fetch live or future game data.

Does NBA MCP Server use authentication or a specific transport?

No authentication or special transport is mentioned; it connects to the public nba_api endpoint and is configured as a standard MCP server over stdio.