Agent Discovery

PlayPuppetHockey.com public API and agent docs

This site exposes a read-only JSON catalog for games, a lightweight MCP endpoint for agents, homepage Link headers for discovery, and browser-side WebMCP tools. Browsers still receive HTML by default; agents can negotiate markdown on HTML routes with Accept: text/markdown.

Endpoints

GET/api/status.json

Returns deployment metadata, service health, and canonical discovery endpoints.

GET/api/games/index.json

Lists every published game with summary fields and normalized search text.

GET/api/games/{slug}.json

Returns one game detail record, including content text, FAQ, and play URLs.

POST/mcp

Stateless Streamable HTTP MCP endpoint exposing read-only catalog tools.

Quick examples

Catalog

curl https://playpuppethockey.com/.well-known/api-catalog
curl https://playpuppethockey.com/api/games/index.json
curl https://playpuppethockey.com/api/games/puppet-hockey.json

Markdown Negotiation

curl -H 'Accept: text/markdown' https://playpuppethockey.com/
curl -H 'Accept: text/markdown' https://playpuppethockey.com/docs/api