{"openapi":"3.1.0","info":{"title":"Cellar API","version":"0.1.0","description":"A fully local wine & spirits reference toolkit: wine varietal and region guides, food-pairing heuristics, spirit-category profiles, a cocktail/bartending glossary, serving temperature and glassware guidance, tasting-note vocabulary, and typical ABV reference ranges. Purely informational and educational.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://cellar.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/cellar/docs"},"termsOfService":"https://connectorbay.com/cellar/terms"},"servers":[{"url":"https://cellar.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/cellar/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/wine_varietal_guide":{"post":{"operationId":"wine_varietal_guide","summary":"A wine grape varietal's general flavor profile, typical body (light/medium/full), typical regions it's","description":"A wine grape varietal's general flavor profile, typical body (light/medium/full), typical regions it's\n    associated with, and its general food-pairing style. Use for \"what does Malbec taste like\", \"is Riesling\n    sweet\", \"what body is Zinfandel\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A wine grape varietal, e.g. 'Cabernet Sauvignon', 'Pinot Noir'. Omit to list all.","title":"Name"}},"title":"wine_varietal_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/wine_region_guide":{"post":{"operationId":"wine_region_guide","summary":"A major wine region's general style and the grape varietals it's best known for. Use for \"what's Rioja","description":"A major wine region's general style and the grape varietals it's best known for. Use for \"what's Rioja\n    known for\", \"what grapes come from Burgundy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A major wine region, e.g. 'Bordeaux', 'Napa Valley'. Omit to list all.","title":"Name"}},"title":"wine_region_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/food_pairing_guide":{"post":{"operationId":"food_pairing_guide","summary":"General classic wine-pairing heuristics for a food category (red meat, white fish, poultry, spicy food,","description":"General classic wine-pairing heuristics for a food category (red meat, white fish, poultry, spicy food,\n    cheese, dessert) — phrased as general guidance, not a strict rule. Use for \"what wine goes with spicy food\",\n    \"what pairs with steak\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dish_or_ingredient":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A food category or common dish/ingredient, e.g. 'red meat', 'steak', 'spicy food', 'blue cheese'. Omit to list all categories.","title":"Dish Or Ingredient"}},"title":"food_pairing_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/spirit_category_guide":{"post":{"operationId":"spirit_category_guide","summary":"A spirit category's general production method, flavor profile, and common serving style — whiskey and its","description":"A spirit category's general production method, flavor profile, and common serving style — whiskey and its\n    sub-types (bourbon, scotch, rye, Irish), vodka, gin, rum, tequila, and brandy/cognac. Use for \"how is tequila\n    made\", \"what's the difference between bourbon and rye\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A spirit category, e.g. 'bourbon', 'gin', 'tequila'. Omit to list all.","title":"Name"}},"title":"spirit_category_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/cocktail_glossary":{"post":{"operationId":"cocktail_glossary","summary":"Definitions of common bartending/cocktail terms (muddle, neat vs. up vs. on the rocks, jigger, dry shake,","description":"Definitions of common bartending/cocktail terms (muddle, neat vs. up vs. on the rocks, jigger, dry shake,\n    proof, ABV, garnish, and more), and the general composition of classic cocktails by name (e.g. \"an Old\n    Fashioned is built from a base spirit, sugar, bitters, and a twist\") — never exact proportions or proof. Use\n    for \"what does 'up' mean\", \"what's a Manhattan made of\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A bartending term (e.g. 'muddle', 'neat', 'jigger') or a classic cocktail name (e.g. 'Old Fashioned', 'Negroni'). Omit to list everything.","title":"Term"}},"title":"cocktail_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/serving_temperature_guide":{"post":{"operationId":"serving_temperature_guide","summary":"General serving-temperature guidance for red wine, white wine, sparkling wine, and spirits neat vs. on the","description":"General serving-temperature guidance for red wine, white wine, sparkling wine, and spirits neat vs. on the\n    rocks. Use for \"what temperature should red wine be served at\", \"should champagne be cold\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"beverage_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'red wine', 'white wine', 'sparkling wine', 'spirits neat', or 'spirits on the rocks'. Omit to list all.","title":"Beverage Type"}},"title":"serving_temperature_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/glassware_guide":{"post":{"operationId":"glassware_guide","summary":"General glass-shape guidance — red wine glass, white wine glass, champagne flute, rocks/old-fashioned","description":"General glass-shape guidance — red wine glass, white wine glass, champagne flute, rocks/old-fashioned\n    glass, highball glass, coupe glass — and why the shape matters (aroma concentration, temperature retention,\n    carbonation). Use for \"why is a wine glass shaped that way\", \"what glass for a Negroni\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"beverage_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'red wine glass', 'white wine glass', 'champagne flute', 'rocks glass', 'highball glass', or 'coupe glass'. Omit to list all.","title":"Beverage Type"}},"title":"glassware_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/tasting_note_vocabulary":{"post":{"operationId":"tasting_note_vocabulary","summary":"A glossary of common tasting-note descriptor vocabulary (tannic, oaky, crisp, dry vs. sweet, body, finish,","description":"A glossary of common tasting-note descriptor vocabulary (tannic, oaky, crisp, dry vs. sweet, body, finish,\n    legs/tears, peaty, and more), grouped as wine-only, spirits-only, or shared. Use for \"what does 'tannic'\n    mean\", \"what's the difference between 'legs' and 'finish'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'wine', 'spirits', or 'shared' to list a group; a specific term also works. Omit to see every group.","title":"Category"}},"title":"tasting_note_vocabularyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/abv_reference_guide":{"post":{"operationId":"abv_reference_guide","summary":"Typical, general alcohol-by-volume (ABV) ranges by beverage category (beer, wine, fortified wine, spirits)","description":"Typical, general alcohol-by-volume (ABV) ranges by beverage category (beer, wine, fortified wine, spirits)\n    — purely factual reference, not a health claim in either direction. Use for \"what's the typical ABV of wine\",\n    \"how much stronger is a fortified wine than table wine\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"beverage_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'beer', 'wine', 'fortified wine', or 'spirits'. Omit to list all.","title":"Beverage Category"}},"title":"abv_reference_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}