{"openapi":"3.0.3","info":{"title":"Gnist Context — Cocktail Recipes","description":"Curated cocktail recipe database — 60+ recipes with ingredients, instructions, and metadata. Search by name, ingredient, spirit, or category.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/cocktails/`\n- **Toolkit page:** `/toolkits/cocktails`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/cocktails/get_cocktail":{"post":{"tags":["Food & Drink"],"summary":"get_cocktail","description":"Get a specific cocktail recipe by its ID.\n\nReturns full recipe including ingredients, instructions, and metadata.","operationId":"cocktails_get_cocktail","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"cocktail_id":{"description":"Cocktail slug ID (e.g. 'margarita', 'old-fashioned').","type":"string"}},"required":["cocktail_id"],"type":"object"}}}}}},"/rest/cocktails/list_cocktails":{"post":{"tags":["Food & Drink"],"summary":"list_cocktails","description":"List cocktail recipes with optional filters.\n\nReturns matching cocktails filtered by category, base spirit, or alcoholic status.","operationId":"cocktails_list_cocktails","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by category (e.g. Classic, Tiki, Sour, Highball, Martini, Shot, Mocktail)."},"base_spirit":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by base spirit (e.g. Vodka, Gin, Rum, Tequila, Whiskey)."},"alcoholic":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Filter by alcoholic (true) or non-alcoholic (false)."}},"type":"object"}}}}}},"/rest/cocktails/search_cocktails":{"post":{"tags":["Food & Drink"],"summary":"search_cocktails","description":"Search for cocktail recipes by keyword.\n\nSearches across cocktail names, ingredient names, and descriptions. Case-insensitive.","operationId":"cocktails_search_cocktails","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search keyword — matches cocktail name, ingredients, or description.","type":"string"},"max_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 20, max: 100)."}},"required":["query"],"type":"object"}}}}}},"/rest/cocktails/get_random_cocktail":{"post":{"tags":["Food & Drink"],"summary":"get_random_cocktail","description":"Get a random cocktail recipe.\n\nReturns a random cocktail, optionally filtered by alcoholic or non-alcoholic.","operationId":"cocktails_get_random_cocktail","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"alcoholic":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Filter by alcoholic (true) or non-alcoholic (false). Omit for any."}},"type":"object"}}}}}},"/rest/cocktails/search_cocktails_by_ingredient":{"post":{"tags":["Food & Drink"],"summary":"search_cocktails_by_ingredient","description":"Find cocktails containing a specific ingredient.\n\nPartial, case-insensitive match on ingredient names.","operationId":"cocktails_search_cocktails_by_ingredient","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"ingredient":{"description":"Ingredient name to search for (e.g. 'lime', 'bourbon', 'mint').","type":"string"}},"required":["ingredient"],"type":"object"}}}}}},"/rest/cocktails/list_base_spirits":{"post":{"tags":["Food & Drink"],"summary":"list_base_spirits","description":"List all base spirits in the cocktail database.\n\nReturns the spirit names that can be used to filter cocktails.","operationId":"cocktails_list_base_spirits","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/cocktails/report_feedback":{"post":{"tags":["Food & Drink"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"cocktails_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Food & Drink","description":"Data sources: Food & Drink"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}