`games`

Pack: balldontlie · Endpoint: https://gateway.pipeworx.io/balldontlie/mcp

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.

Parameters

Name	Type	Required	Description
`seasons`	array	no
`items`	number	no
`team_ids`	array	no
`items`	number	no
`dates`	array	no	YYYY-MM-DD
`items`	string	no
`postseason`	boolean	no
`cursor`	number	no
`per_page`	number	no

Example call

Arguments

{
  "seasons": [
    2023
  ]
}

curl

curl -X POST https://gateway.pipeworx.io/balldontlie/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"games","arguments":{"seasons":[2023]}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('games', {
  "seasons": [
    2023
  ]
});

More examples

{
  "team_ids": [
    1
  ],
  "dates": [
    "2023-10-24"
  ],
  "postseason": false
}

Response shape

Full JSON Schema

{
  "type": "object",
  "description": "Response from balldontlie API /games endpoint with pagination"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "balldontlie": {
      "url": "https://gateway.pipeworx.io/balldontlie/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

games