{
  "name": "Cocktailary API",
  "version": "1.0",
  "description": "Read-only cocktail knowledge: classic and modern cocktails, fully mapped.",
  "endpoints": {
    "/api/cocktails": "list — filters: ?q= ?spirit= ?taste= ?occasion=",
    "/api/cocktails/{slug}": "full entry incl. recipe, taste, history, variations — ?volumeMl=<ml> returns scaled recipes",
    "/api/spirits": "spirit and liqueur categories",
    "/api/random": "one random cocktail",
    "/api/openapi.json": "OpenAPI 3.1 document",
    "/mcp": "MCP server (Streamable HTTP) — tools: list_cocktails, get_cocktail, random_cocktail, list_spirits, search_cocktails, list_collections, get_collection, list_entities, get_entity"
  }
}