@pipeworx/balldontlie

Connect: https://gateway.pipeworx.io/balldontlie/mcp · Install: one-click buttons

Tools: 8

balldontlie.io MCP — NBA stats. Free tier requires API key (5 req/min free).

Auth

teams() — all teams
team(id) — single team
players(query?, team_ids?, cursor?, per_page?) — players
player(id) — single player
games(seasons?, team_ids?, dates?, postseason?, cursor?, per_page?) — games
game(id) — single game
season_averages(season, player_ids) — season averages
stats(seasons?, player_ids?, game_ids?, postseason?, cursor?, per_page?) — stats

https://api.balldontlie.io/v1/

teams — All 30 NBA teams: ID, name, city, abbreviation, conference, division. Use as a directory to resolve a team name into the numeric team_id required by other balldontlie tools.
team — Single NBA team by ID: name, abbreviation, city, conference, division. Use after teams() to confirm details.
players — NBA player roster — search by name substring or filter by team. Returns ID, first/last name, position, height, weight, jersey number, and team. Use to resolve a player name to a numeric player_id requ
player — Single NBA player by ID: name, position, height, weight, jersey, team. Use after players() to confirm.
games — NBA games filtered by season, team, or date range. Returns matchup, scores, date, season, postseason flag, status. Use for “did the Lakers win last night”, schedule lookup, historical game search.
game — Single NBA game by ID: matchup, scores, date, period, time, venue, season, postseason flag. Use after games() to fetch detail.
season_averages — Fetch per-season NBA stat averages for one or more player_ids in a given season year; returns PTS, REB, AST, FG%, and other averages per player.
stats — Per-game NBA player box-score stats filtered by player, team, game, or season. Returns PTS, REB, AST, STL, BLK, TO, FG%, FT%, 3P%, minutes, +/-. Use for individual game performance lookup, box-score a

game — Single NBA game by ID: matchup, scores, date, period, time, venue, season, postseason flag. Use after games() to fetch detail.
games — NBA games filtered by season, team, or date range. Returns matchup, scores, date, season, postseason flag, status. Use for did the Lakers win last night , schedule lookup, historical game search.
player — Single NBA player by ID: name, position, height, weight, jersey, team. Use after players() to confirm.
players — NBA player roster — search by name substring or filter by team. Returns ID, first/last name, position, height, weight, jersey number, and team. Use to resolve a player name to a numeric player_id requ
season_averages — Fetch per-season NBA stat averages for one or more player_ids in a given season year; returns PTS, REB, AST, FG%, and other averages per player.
stats — Per-game NBA player box-score stats filtered by player, team, game, or season. Returns PTS, REB, AST, STL, BLK, TO, FG%, FT%, 3P%, minutes, +/-. Use for individual game performance lookup, box-score a
team — Single NBA team by ID: name, abbreviation, city, conference, division. Use after teams() to confirm details.
teams — All 30 NBA teams: ID, name, city, abbreviation, conference, division. Use as a directory to resolve a team name into the numeric team_id required by other balldontlie tools.