MCP Connector

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.

Works with nba api

Maintainer of this project? Claim this page to edit the listing.


90
Spark score
out of 100
Updated Apr 2025
Version 1.0.0
Models

Add 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

01

Retrieve final scores for past and recent NBA games.

02

Fetch player statistics (points, rebounds, assists, etc.) for games played.

03

Access advanced game statistics like four factors.

04

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.