`games`

Pack: balldontlie · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/games for the schema, then POST the same URL with its arguments for the data.

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 — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the balldontlie pack

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

See Getting Started for client-specific install steps.

games