# Hockay API

> Read-only access to Hockay's seasons, teams, players, games, and standings, over REST or MCP.

Hockay is a simulated league of 48 fictional teams; it is its own sport, not hockey. The API is read-only and never runs ahead of the broadcast. To query Hockay from Claude or ChatGPT, connect the MCP server at https://hockay.com/mcp rather than calling these endpoints.

## Docs

- [The Hockay API](https://hockay.com/docs): Hockay's record, read-only, over REST or MCP.
- [Quickstart](https://hockay.com/docs/quickstart): Issue a key and make your first request.
- [Keys](https://hockay.com/docs/authentication): How to send a key, who holds one, and why one is refused.
- [Claude and ChatGPT](https://hockay.com/docs/mcp): Connect Hockay to an assistant over MCP.
- [Nothing before it airs](https://hockay.com/docs/broadcast): Why the API never runs ahead of the broadcast.
- [Responses](https://hockay.com/docs/responses): The envelope, pages, caching, ids, and versions.
- [Limits](https://hockay.com/docs/limits): How many requests a minute, and what happens past it.
- [Errors](https://hockay.com/docs/errors): Every error code the API returns.

## Reference

- [Hockay API](https://hockay.com/docs/reference): Read-only access to Hockay's public data: seasons, teams, players, games, standings, the bracket, and the league's reference tables.

### Seasons

- [Every season, newest first](https://hockay.com/docs/reference/seasons/list-seasons): Every season, newest first. Reference for the GET /seasons endpoint in the Hockay API.
- [One season](https://hockay.com/docs/reference/seasons/get-season): One season. Reference for the GET /seasons/{id} endpoint in the Hockay API.
- [A season's nights, in calendar order](https://hockay.com/docs/reference/seasons/list-matchdays): A season's nights, in calendar order. Reference for the GET /seasons/{id}/matchdays endpoint in the Hockay API.

### Teams

- [The league's teams](https://hockay.com/docs/reference/teams/list-teams): The league's teams. Reference for the GET /teams endpoint in the Hockay API.
- [One team, its roster, and its rivalries](https://hockay.com/docs/reference/teams/get-team): One team, its roster, and its rivalries. Reference for the GET /teams/{id} endpoint in the Hockay API.

### Players

- [Players, by name](https://hockay.com/docs/reference/players/list-players): Players, by name. Reference for the GET /players endpoint in the Hockay API.
- [One player](https://hockay.com/docs/reference/players/get-player): One player. Reference for the GET /players/{id} endpoint in the Hockay API.
- [A player's season lines](https://hockay.com/docs/reference/players/get-player-stats): A player's season lines. Reference for the GET /players/{id}/stats endpoint in the Hockay API.
- [A player's last final games](https://hockay.com/docs/reference/players/get-player-games): A player's last final games. Reference for the GET /players/{id}/games endpoint in the Hockay API.
- [Modifiers a player gained and lost](https://hockay.com/docs/reference/players/get-player-modifiers): Modifiers a player gained and lost. Reference for the GET /players/{id}/modifiers endpoint in the Hockay API.
- [One season's leaders for one stat](https://hockay.com/docs/reference/players/get-leaders): One season's leaders for one stat. Reference for the GET /leaders endpoint in the Hockay API.

### Games

- [A season's games, in start order](https://hockay.com/docs/reference/games/list-games): A season's games, in start order. Reference for the GET /games endpoint in the Hockay API.
- [One game](https://hockay.com/docs/reference/games/get-game): One game. Reference for the GET /games/{id} endpoint in the Hockay API.
- [A game's aired events, in broadcast order](https://hockay.com/docs/reference/games/get-game-events): A game's aired events, in broadcast order. Reference for the GET /games/{id}/events endpoint in the Hockay API.
- [Player lines, totals, and lineups](https://hockay.com/docs/reference/games/get-game-box-score): Player lines, totals, and lineups. Reference for the GET /games/{id}/boxscore endpoint in the Hockay API.
- [JM's commentary](https://hockay.com/docs/reference/games/get-game-commentary): JM's commentary. Reference for the GET /games/{id}/commentary endpoint in the Hockay API.
- [Games in progress](https://hockay.com/docs/reference/games/get-live-scores): Games in progress. Reference for the GET /live endpoint in the Hockay API.

### Standings

- [The table](https://hockay.com/docs/reference/standings/get-standings): The table. Reference for the GET /standings endpoint in the Hockay API.
- [The table after each matchday](https://hockay.com/docs/reference/standings/get-standings-history): The table after each matchday. Reference for the GET /standings/history endpoint in the Hockay API.
- [The bracket](https://hockay.com/docs/reference/standings/get-playoffs): The bracket. Reference for the GET /playoffs endpoint in the Hockay API.
- [Running injuries that have aired](https://hockay.com/docs/reference/standings/get-injuries): Running injuries that have aired. Reference for the GET /injuries endpoint in the Hockay API.

### League

- [Arenas and neutral sites](https://hockay.com/docs/reference/league/list-arenas): Arenas and neutral sites. Reference for the GET /arenas endpoint in the Hockay API.
- [One arena or neutral site](https://hockay.com/docs/reference/league/get-arena): One arena or neutral site. Reference for the GET /arenas/{slug} endpoint in the Hockay API.
- [Modifiers' names and descriptions](https://hockay.com/docs/reference/league/list-modifiers): Modifiers' names and descriptions. Reference for the GET /modifiers endpoint in the Hockay API.
- [League rivalries and the most despised](https://hockay.com/docs/reference/league/get-rivalries): League rivalries and the most despised. Reference for the GET /rivalries endpoint in the Hockay API.

## Agent skills

- [hockay-api](https://hockay.com/docs/.well-known/agent-skills/hockay-api/SKILL.md): Read the Hockay API docs instead of answering from memory. Read-only access to Hockay's seasons, teams, players, games, and standings, over REST or MCP. Use when a task involves Hockay API: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://hockay.com/docs/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://hockay.com/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://hockay.com/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://hockay.com/docs/openapi.json.
- [Agent skills](https://hockay.com/docs/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://hockay.com/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://hockay.com/docs/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://hockay.com/docs/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://hockay.com/docs/sitemap.xml): Every indexable page URL with its last-modified date.