`get_player`

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

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

Get an NHL player’s profile and current season stats by player ID. Returns bio, position, team, and season statistics.

Parameters

Name	Type	Required	Description
`playerId`	number	yes	NHL player ID (e.g., 8478402 for Connor McDavid)

Example call

Arguments

{
  "playerId": 8478402
}

curl

curl -X POST https://gateway.pipeworx.io/nhl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_player","arguments":{"playerId":8478402}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_player', {
  "playerId": 8478402
});

More examples

{
  "playerId": 8477933
}

Response shape

Field	Type	Description
`player_id`	number \| null	Player ID
`name`	string \| null	Player full name
`number`	number \| null	Jersey number
`position`	string \| null	Player position
`team`	string \| null	Current team name
`team_abbrev`	string \| null	Current team abbreviation
`birth_date`	string \| null	Birth date
`birth_city`	string \| null	Birth city
`birth_country`	string \| null	Birth country
`height_in`	number \| null	Height in inches
`weight_lbs`	number \| null	Weight in pounds
`headshot`	string \| null	Headshot image URL
`current_season_stats`	object \| null

Full JSON Schema

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": [
        "number",
        "null"
      ],
      "description": "Player ID"
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Player full name"
    },
    "number": {
      "type": [
        "number",
        "null"
      ],
      "description": "Jersey number"
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "description": "Player position"
    },
    "team": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current team name"
    },
    "team_abbrev": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current team abbreviation"
    },
    "birth_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Birth date"
    },
    "birth_city": {
      "type": [
        "string",
        "null"
      ],
      "description": "Birth city"
    },
    "birth_country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Birth country"
    },
    "height_in": {
      "type": [
        "number",
        "null"
      ],
      "description": "Height in inches"
    },
    "weight_lbs": {
      "type": [
        "number",
        "null"
      ],
      "description": "Weight in pounds"
    },
    "headshot": {
      "type": [
        "string",
        "null"
      ],
      "description": "Headshot image URL"
    },
    "current_season_stats": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "season": {
          "type": [
            "number",
            "null"
          ],
          "description": "Season year"
        },
        "games_played": {
          "type": [
            "number",
            "null"
          ],
          "description": "Games played"
        },
        "goals": {
          "type": [
            "number",
            "null"
          ],
          "description": "Goals scored"
        },
        "assists": {
          "type": [
            "number",
            "null"
          ],
          "description": "Assists"
        },
        "points": {
          "type": [
            "number",
            "null"
          ],
          "description": "Total points"
        },
        "plus_minus": {
          "type": [
            "number",
            "null"
          ],
          "description": "Plus/minus rating"
        },
        "pim": {
          "type": [
            "number",
            "null"
          ],
          "description": "Penalties in minutes"
        }
      }
    }
  }
}

Connect

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

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

See Getting Started for client-specific install steps.

get_player