Agent Discovery

MagicTiles.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://magictiles.org/.well-known/api-catalog
curl https://magictiles.org/api/games/index.json
curl https://magictiles.org/api/games/magic-tiles-3.json

Markdown Negotiation

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