NBA

liveSports

NBA player profiles, team rosters, and game scores via BallDontLie

4tools
0msauth
free tier50 calls/day

Tools

search_playersrequired: query

"Find NBA player [name]" / "search NBA roster for [X]" / "is [player] in the NBA" — search NBA players by name on BallDontLie. Returns position, height, weight, college, country, draft info, and curre

Parameters
NameTypeDescription
queryreqstringPlayer name or partial name to search for
limitoptnumberNumber of results to return (default: 10, max: 100)
▶Try it
get_playerrequired: id

Direct lookup of a single NBA player by BallDontLie ID. ⚠️ TIER-GATED: the /players/{id} endpoint requires the ALL-STAR tier ($9.99/mo) or higher; free-tier _apiKey gets a 403 with "No approval receiv

Parameters
NameTypeDescription
idreqnumberBallDontLie player ID
▶Try it
get_teams

Get all 30 NBA teams with full names, abbreviations, conference, and division. Use to find team info or prepare for get_games queries. Requires a free BallDontLie API key.

No parameters required.

▶Try it
get_gamesrequired: season

Get NBA games for a season (e.g., 2023, 2024). Returns game date, status, matchup teams, and final or live scores. Requires a free BallDontLie API key.

Parameters
NameTypeDescription
seasonreqnumberSeason start year (e.g., 2024 for the 2024-25 season)
limitoptnumberNumber of results to return (default: 25, max: 100)
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/nba/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/nba/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_players","arguments":{"query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_players", {"query":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("nba player profiles, team rosters, and game scores via balldontlie");