NBA

live Sports

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

4 tools
0ms auth
free tier 50 calls/day

Tools

search_players required: query

Search NBA players by name. Returns player profile including position, height, weight, college, and current team.

Parameters
Name Type Description
query req string Player name or partial name to search for
limit opt number Number of results to return (default: 10, max: 100)
▶ Try it
get_player required: id

Get detailed profile for a single NBA player by their BallDontLie player ID.

Parameters
Name Type Description
id req number BallDontLie player ID
▶ Try it
get_teams

List all 30 NBA teams with their full names, abbreviations, conference, and division.

No parameters required.

▶ Try it
get_games required: season

Get NBA games for a given season. Returns game date, status, teams, and scores.

Parameters
Name Type Description
season req number Season start year (e.g., 2024 for the 2024-25 season)
limit opt number Number 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"}}}'