mcp/server.json at main · PuckAPI/mcp · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.noahowsh/puckapi",
  "title": "PuckAPI",
  "description": "NHL and PWHL stats, play-by-play, expected goals and odds. REST API and MCP server. Free to start.",
  "version": "1.1.4",
  "license": "MIT",
  "repository": {
    "url": "https://github.com/PuckAPI/mcp",
    "source": "github",
    "id": "1233426731"
  },
  "icons": [
    {
      "src": "https://github.com/PuckAPI/mcp/raw/main/assets/logo-400x400.png",
      "mimeType": "image/png",
      "sizes": [
        "400x400"
      ]
    }
  ],
  "homepage": "https://puckapi.com",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://mcp.puckapi.com/mcp",
      "headers": [
        {
          "name": "x-api-key",
          "description": "Your PuckAPI API key. Get a free key with 500 credits at puckapi.com/signup",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "tools": [
    {
      "name": "list_teams",
      "description": "All 32 active NHL teams with divisions, conferences, and arenas",
      "readOnlyHint": true
    },
    {
      "name": "get_standings",
      "description": "Current standings with advanced stats",
      "readOnlyHint": true
    },
    {
      "name": "get_schedule",
      "description": "Upcoming games for next N days",
      "readOnlyHint": true
    },
    {
      "name": "search_players",
      "description": "Find players by name, team, or position",
      "readOnlyHint": true
    },
    {
      "name": "get_games",
      "description": "Query by date, team, season, game state, or type",
      "readOnlyHint": true
    },
    {
      "name": "get_team_stats",
      "description": "Detailed stats for a specific team with advanced metrics",
      "readOnlyHint": true
    },
    {
      "name": "get_player_stats",
      "description": "Player bio and team context; season line for skaters, goalie stats for goalies",
      "readOnlyHint": true
    },
    {
      "name": "get_goalie_stats",
      "description": "Goalie leaderboard sorted by save%, GAA, GSAX, or wins",
      "readOnlyHint": true
    },
    {
      "name": "get_skater_season_stats",
      "description": "Skater leaderboard sorted by points, goals, assists, +/-, or shots",
      "readOnlyHint": true
    },
    {
      "name": "get_player_game_log",
      "description": "A player's game-by-game stat lines for a season, not a season total",
      "readOnlyHint": true
    },
    {
      "name": "get_odds",
      "description": "Odds by game with bookmaker filters",
      "readOnlyHint": true
    },
    {
      "name": "get_game_detail",
      "description": "Full game detail with odds and goalie starts",
      "readOnlyHint": true
    },
    {
      "name": "get_head_to_head",
      "description": "Matchup history with win/loss records",
      "readOnlyHint": true
    },
    {
      "name": "get_plays",
      "description": "Play-by-play events with rink coordinates, strength state, and the players involved",
      "readOnlyHint": true
    },
    {
      "name": "get_shot_map",
      "description": "Every shot attempt with rink coordinates, shot type, shooter and goalie",
      "readOnlyHint": true
    },
    {
      "name": "get_line_movement",
      "description": "Time-series odds grouped by bookmaker",
      "readOnlyHint": true
    }
  ]
}