Site API
Read-only HTTP API that describes the public Drunk Monk Studios website, including a health check, OpenAPI document, and API catalog.
The site API is a public, read-only description of this website. It does not start games, join rooms, or change any data. Requests do not need an account or an API key.
Send GET or HEAD. Any other method receives 405 Method Not Allowed.
API catalog
Agents discover this API from the API catalog. That address returns a linkset (application/linkset+json) as defined by RFC 9727. The catalog entry points here for documentation, to the OpenAPI document for a machine-readable description, and to the health endpoint for status.
A2A Agent Card
Agents discover this origin via the A2A Agent Card. That document lists the Site API as an HTTP+JSON interface plus skills for site metadata, Auth.md discovery, and markdown content negotiation.
MCP Server Card
MCP clients discover this origin via the MCP Server Card (SEP-1649). That document advertises Streamable HTTP at /mcp with read-only tools for site metadata, health, and discovery links.
Agent Skills
Installable Agent Skills are listed at /.well-known/agent-skills/index.json per the Agent Skills Discovery RFC (v0.2.0). Each entry points at a SKILL.md artifact with a SHA-256 digest.
Auth.md
Registration and credential guidance for agents lives in auth.md. Protected Resource Metadata is at /.well-known/oauth-protected-resource. Authorization Server metadata is at /.well-known/oauth-authorization-server. The Site API itself does not require an account or a bearer token.
Web Bot Auth
Outbound bot and agent requests from this origin can identify themselves with Web Bot Auth HTTP message signatures. The public JWKS is at /.well-known/http-message-signatures-directory (application/http-message-signatures-directory+json). Signed requests carry Signature-Agent, Signature-Input, and Signature headers that verifiers check against that directory.
WebMCP
Browser agents that support WebMCP receive in-page tools on load via document.modelContext.registerTool() (with a navigator.modelContext fallback). Tools cover site search, navigation to public paths, Markdown page retrieval, Site API health, and discovery links. Registration uses an AbortController so tools can be unregistered when the page tears down.
DNS for AI Discovery (DNS-AID)
Agents can also find these endpoints through DNS-AID ServiceMode SVCB records under _agents.drunkmonkstudios.com:
_index._agents→ apex HTTPS, well-known API catalog_a2a._agents→ A2A Agent Card at/.well-known/agent-card.json_mcp._agents→ MCP Server Card at/.well-known/mcp/server-card.json
Experimental parameters use private-use keyNNNNN SvcParamKeys (key65402 for agent protocol, key65409 for the well-known path). The discovery zone is DNSSEC-signed.
Endpoints
Service root
GET /api/site returns the API name and links to the health check, this page, and the OpenAPI document.
Health
GET /api/site/health returns { "status": "ok" } when the API is reachable.
OpenAPI description
GET /api/site/openapi.json returns an OpenAPI 3.1 document for the operations above.
Terms
Use of the website, including this API, follows the terms of service and the privacy policy.