nba-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NBA_USER_AGENT | No | User-Agent header for requests | Mozilla/5.0 ... |
| NBA_MAX_RETRIES | No | Maximum number of retries for failed requests | 2 |
| NBA_LIVE_BASE_URL | No | Base URL for live data endpoints | https://cdn.nba.com/static/json/liveData |
| NBA_STATS_BASE_URL | No | Base URL for stats.nba.com endpoints | https://stats.nba.com/stats |
| NBA_LIVE_TIMEOUT_MS | No | Timeout in milliseconds for live data requests | 10000 |
| NBA_STATS_TIMEOUT_MS | No | Timeout in milliseconds for stats.nba.com requests | 30000 |
| NBA_STATS_RATE_LIMIT_MS | No | Rate limit in milliseconds between stats.nba.com requests | 650 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nba_stats_endpointC | Advanced raw stats.nba.com endpoint caller. Use a documented endpoint name and NBA parameter names. |
| nba_search_teamsA | Search NBA teams by name, city, abbreviation, slug, or team id. |
| nba_live_scoreboardA | Get today's NBA live scoreboard from cdn.nba.com. |
| nba_live_boxscoreB | Get the live box score for a 10-digit NBA game id from cdn.nba.com. |
| nba_live_play_by_playA | Get live play-by-play actions for a 10-digit NBA game id from cdn.nba.com. |
| nba_live_oddsA | Get live betting odds for today's games from cdn.nba.com when available. |
| nba_schedule_by_dateB | Get NBA schedule and scores for a specific date via stats.nba.com scoreboardv2. |
| nba_search_playersB | Search NBA players by name using stats.nba.com playerindex. Defaults to the supplied season and active players only. |
| nba_player_infoB | Get biographical and headline information for an NBA player id. |
| nba_player_career_statsB | Get career and season totals for an NBA player id. |
| nba_player_game_logC | Get game-by-game statistics for an NBA player in a season. |
| nba_team_game_logC | Get game-by-game statistics for an NBA team in a season. |
| nba_league_standingsC | Get NBA standings for a season and season type. |
| nba_league_player_statsA | Get league-wide player statistics for a season. Results are limited by default. |
| nba_league_team_statsC | Get league-wide team statistics for a season. Results are limited by default. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Each tool targets a distinct aspect of NBA data (player stats, standings, live games, search, etc.) with clear descriptions, minimizing confusion.
All tools follow a consistent snake_case pattern with 'nba_' prefix and descriptive resource/action names, making them predictable.
15 tools is well-scoped for a sports data API, covering essential player, team, game, and schedule operations without excess.
Core CRUD-like operations are covered (stats, logs, info, search, live). Minor gaps like explicit team roster are mitigated by the raw endpoint.