Search players
search_playersUse when looking up a player by name. Searches 4,900+ players across every season since 2010-11. Returns active players by default; set active=false for retired/historical. Use the returned player ID with get_player_stats for full details. Costs 2 credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_players"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team | No | Filter by team abbreviation | |
| limit | No | Max results (default 10) | |
| query | Yes | Player name to search for (partial match supported) | |
| active | No | Filter by active status (default: true). Set false to search active plus retired/historical players. | |
| league | No | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. | |
| position | No | Filter by position |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| count | Yes | ||
| players | Yes | ||
| included_inactive | Yes |