get_player_stats
Data refreshed · changelog
Player bio and goalie stats (if goalie). For skaters, returns bio info and team context.
Use it when you have a player ID (from search_players) and want their full profile: bio, team, position, and for goalies, their complete stat line including GSAX and advanced metrics.
Parameters
player_idintegerrequired- Player ID (from search_players)
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
get_player_statsitself. Point any MCP client athttps://mcp.puckapi.com/mcp?key=YOUR_API_KEY. - Each call costs 5 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/get_player_stats \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"player_id": 8480045
}'Response
{
"player": {
"id": 8480045,
"name": "Ukko-Pekka Luukkonen",
"team": "BUF",
"teamName": "Buffalo Sabres",
"position": "G",
"jerseyNumber": 1,
"birthDate": "1999-03-09",
"birthCountry": "FIN",
"heightInches": 77,
"weightLbs": 220,
"shootsCatches": "L"
},
"goalie_stats": {
"gamesPlayed": 55,
"gamesStarted": 55,
"wins": 31,
"losses": 18,
"otLosses": 4,
"savePct": 0.908,
"gaa": 2.71,
"gsax": 25,
"shutouts": 2,
"expectedGoalsAgainst": 171,
"highDangerSavePct": 0.895,
"rollingSavePct": 0.945,
"rollingGsax": 7,
"trend": "stable",
"restDays": 3
}
}Response fields
player.idinteger- Player ID
player.namestring- Full name
player.teamstring- Team abbreviation
player.teamNamestring- Full team name
player.positionstring- Position code
player.jerseyNumberinteger- Jersey number
player.birthDatestring- Birth date
player.birthCountrystring- Birth country
player.heightInchesinteger- Height in inches
player.weightLbsinteger- Weight in pounds
player.shootsCatchesstring- Shoots/catches (L or R)
goalie_statsobject|null- Goalie stats (null for skaters)
goalie_stats.savePctnumber- Save percentage
goalie_stats.gaanumber- Goals against average
goalie_stats.gsaxnumber- Goals saved above expected
Related endpoints
Returns the player_id this one takes.
Find players by name, team, or position.
Returns the player_id this one takes.
Goalie leaderboard sorted by save%, GAA, GSAX or wins, with high-danger save%, recent form and rest days.
Filters by the same league.
All 32 active NHL teams with divisions, conferences, and arenas.
Filters by the same player_id.
What the market thinks of a game's player props: average implied and fair probability for each player and line
Try it
500 free credits every month: 100 calls to get_player_stats, and no card.