`get_player`

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

Get detailed NBA player profile including career stats, season-by-season performance, biographical info, and team history. Requires player ID from search_players.

Parameters

Name	Type	Required	Description
`id`	number	yes	BallDontLie player ID
`_apiKey`	string	yes	BallDontLie API key

Example call

Arguments

{
  "id": 114,
  "_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_player","arguments":{"id":114,"_apiKey":"your-nba-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

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

Response shape

Always returns: id, name, position, height, weight, jersey_number, college, country, draft_year, draft_round, draft_number, team

Field	Type	Description
`id`	number	Player ID
`name`	string	Full name (first + last)
`position`	string \| null	Player position
`height`	string \| null	Player height
`weight`	string \| null	Player weight
`jersey_number`	string \| null	Jersey number
`college`	string \| null	College attended
`country`	string \| null	Country of origin
`draft_year`	number \| null	Year drafted
`draft_round`	number \| null	Draft round
`draft_number`	number \| null	Draft pick number
`team`	object \| null	Current team information

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Player ID"
    },
    "name": {
      "type": "string",
      "description": "Full name (first + last)"
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "description": "Player position"
    },
    "height": {
      "type": [
        "string",
        "null"
      ],
      "description": "Player height"
    },
    "weight": {
      "type": [
        "string",
        "null"
      ],
      "description": "Player weight"
    },
    "jersey_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "Jersey number"
    },
    "college": {
      "type": [
        "string",
        "null"
      ],
      "description": "College attended"
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Country of origin"
    },
    "draft_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Year drafted"
    },
    "draft_round": {
      "type": [
        "number",
        "null"
      ],
      "description": "Draft round"
    },
    "draft_number": {
      "type": [
        "number",
        "null"
      ],
      "description": "Draft pick number"
    },
    "team": {
      "type": [
        "object",
        "null"
      ],
      "description": "Current team information",
      "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": [
    "id",
    "name",
    "position",
    "height",
    "weight",
    "jersey_number",
    "college",
    "country",
    "draft_year",
    "draft_round",
    "draft_number",
    "team"
  ]
}

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_player