search_players

2 creditsBasic lookupPOST /v1/search_players

Find players by name, team, or position.

Use it when you need a player's ID to look up their stats, or you want to search a roster by position. For example, "find all active centers on the Sabres" or "look up Tage Thompson's player ID."

Parameters

querystringrequired: Search string (e.g. "Tage Thompson")
teamstringoptional: Filter by team abbreviation
positionstringoptional: G, D, C, LW, or RW
activebooleanoptional: Active players only (default true)
limitintegeroptional: Max results (1-50, default 10)
leagueenum: nhl | pwhl | ohl | whl | qmjhl | echl | ahl | ushloptional: League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl.

Notes

Over MCP, ask for it in plain English and the client calls search_players itself. Point any MCP client at https://mcp.puckapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.puckapi.com/v1/search_players \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Thompson",
  "team": "BUF"
}'

Response

json

{
  "players": [
    {
      "id": 8480208,
      "name": "Tage Thompson",
      "team": "BUF",
      "teamName": "Buffalo Sabres",
      "position": "C",
      "jerseyNumber": 72,
      "active": true
    }
  ]
}