@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

  • Platform key: PLATFORM_BALLDONTLIE_KEY.
  • BYO: ?_apiKey=….

Tools

  • 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

Data source

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

Tools

  • 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

Tools

  • 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.

Regenerated from source · build July 4, 2026