`get_teams`

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

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

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.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	BallDontLie API key (free tier: https://www.balldontlie.io/)

Example call

Arguments

{
  "_apiKey": "your-nba-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/nba/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_teams","arguments":{"_apiKey":"your-nba-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_teams', {
  "_apiKey": "your-nba-api-key"
});

Response shape

Always returns: total, teams

Field	Type	Description
`total`	number	Total number of NBA teams
`teams`	array	List of all NBA teams

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of NBA teams"
    },
    "teams": {
      "type": "array",
      "description": "List of all NBA teams",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Team ID"
          },
          "full_name": {
            "type": "string",
            "description": "Full team name"
          },
          "abbreviation": {
            "type": "string",
            "description": "Team abbreviation"
          },
          "city": {
            "type": "string",
            "description": "Team city"
          },
          "name": {
            "type": "string",
            "description": "Team name"
          },
          "conference": {
            "type": "string",
            "description": "Conference (East/West)"
          },
          "division": {
            "type": "string",
            "description": "Division name"
          }
        }
      }
    }
  },
  "required": [
    "total",
    "teams"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_teams