NBA MCP Server

NBA MCP Server is an MCP server that provides access to live NBA game data, historical statistics, and team schedules via the Model Context Protocol. It connects directly to the official NBA data services through the Python nba_api package, utilizing Pydantic for schema validation and Pandas for data manipulation. Sports analysts, fantasy basketball managers, and software developers use this server to query real-time sports information directly within their AI interfaces. By integrating with MCP-compatible clients like Claude Desktop, the server enables users to fetch live scoreboards, box scores, and play-by-play actions during ongoing games. Users can also retrieve comprehensive player career statistics, view active player lists, look up team game logs without needing internal numeric IDs, track league standings, and review past game results. Operating with built-in timeout handling and graceful shutdown features, it serves as a structured bridge between raw NBA telemetry and conversational AI tools for in-depth basketball analysis.

Category: Data & Analytics

Tags: basketball, nba, sports, statistics

Visit NBA MCP Server

How to install and configure NBA MCP Server

1. Clone the repository: bash git clone https://github.com/obinopaul/nba-mcp-server.git cd nba-mcp-server 2. Install required dependencies: bash pip install -r requirements.txt 3. Choose an execution method: - Option A (Docker): Build the image using docker build -t nba_mcp_server . and run it with docker run -d -p 5000:5000 --name nba_mcp_server nba_mcp_server. - Option B (Local Python): Ensure your environment (Python 3.13) is activated. 4. Add the server configuration to your claude_desktop_config.json. For Docker: json { "mcpServers": { "nba_mcp_server": { "command": "docker", "args": ["exec", "-i", "nba_mcp_server", "python", "nba_server.py"] } } } For local Python: json { "mcpServers": { "nba_mcp_server": { "command": "/path/to/your/python", "args": ["/path/to/nba_server.py"] } } } 5. Restart Claude Desktop to load the NBA MCP tools.

What you can do with NBA MCP Server

• Monitoring ongoing NBA matchups by pulling live scoreboards, current quarter scores, broadcast schedules, and real-time box scores. * Inspecting granular play-by-play game actions including scoring sequences, team timeouts, foul tracking, and player substitutions. * Retrieving detailed player biographical profiles and career stats formatted by per-game totals or per-36-minute metrics. * Analyzing team historical performance by fetching game logs and comprehensive team statistics using standard franchise names. * Checking current league standings across different seasons and season types to evaluate playoff positioning and team records.

Key facts

• https://github.com/obinopaul/nba-mcp-server
• Data & Analytics, Other & General Purpose
• basketball, nba, sports, statistics

Part of MCP Servers

What is NBA MCP Server?

NBA MCP Server is a Python-based Model Context Protocol service that connects AI clients to the NBA API. It allows users to query live game telemetry, historical player statistics, game schedules, and team standings through natural language prompts.

How do I install NBA MCP Server?

You can install it by cloning the GitHub repository and installing dependencies via pip. The server can then be run either as a Docker container or directly through a local Python environment using mcp run nba_server.py before configuring Claude Desktop.

Which MCP clients work with NBA MCP Server?

The server works with Claude Desktop and any client that supports the Model Context Protocol over standard input and output, including containerized execution through Docker.

Is NBA MCP Server open source?

Yes, NBA MCP Server is open source software distributed under the terms of the MIT License. The code repository is publicly accessible on GitHub.