nba-mcp-server

tanvir-dhanjal/nba-mcp-server

3.2

If you are the rightful owner of nba-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The NBA MCP Server is a Model Context Protocol server that provides access to comprehensive NBA data, enabling AI assistants to retrieve information about teams, players, games, and box scores.

Tools
8
Resources
0
Prompts
0

NBA MCP Server

A Model Context Protocol (MCP) server that provides access to NBA data. This server enables AI assistants to retrieve NBA information including teams, players, games, and box scores.

Features

  • Team information and rosters
  • Player search and details
  • Game data with filtering options
  • Live and historical box scores

Prerequisites

  • Python 3.10+
  • API key (get from provider)

Installation

  1. Clone this repository:
git clone https://github.com/yourusername/nba-mcp-server.git
cd nba-mcp-server
  1. Install dependencies:
source .venv/bin/activate
pip install fastmcp balldontlie
  1. Add your API key to server.py

Usage

python server.py

Available Tools

Teams

  • nba_teams() - List all teams
  • nba_teams_details(team_id) - Team details and roster

Players

  • nba_players() - Search players with filters
  • get_player_by_id(player_id) - Player details

Games

  • nba_games() - Games with date/team filters
  • nba_game_by_id(game_id) - Game details

Box Scores

  • nba_live_box_scores() - Live scores
  • nba_box_scores_by_date(date) - Scores by date

Configuration

Update your API key:

api = BalldontlieAPI(api_key="YOUR_API_KEY")

License

MIT License