Agent Discovery

PlayWaterSort.org 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://playwatersort.org/.well-known/api-catalog
curl https://playwatersort.org/api/games/index.json
curl https://playwatersort.org/api/games/water-sort.json

Markdown Negotiation

curl -H 'Accept: text/markdown' https://playwatersort.org/
curl -H 'Accept: text/markdown' https://playwatersort.org/docs/api