live · Personal & Media · JSON · API for agents
Search the cocktail catalogue by name. Returns matching cocktails with their page URLs, family, and glassware.
{
"name": "search_cocktails",
"kind": "read",
"impl": "imperative",
"description": "Search the cocktail catalogue by name. Returns matching cocktails with their page URLs, family, and glassware.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Cocktail name or part of a name"
}
},
"required": [
"query"
]
},
"page": "/"
}Get the full recipe for a cocktail by name: ingredients with measures, preparation steps, garnish, glassware, page URL, and any film or TV appearances.
{
"name": "get_cocktail_recipe",
"kind": "read",
"impl": "imperative",
"description": "Get the full recipe for a cocktail by name: ingredients with measures, preparation steps, garnish, glassware, page URL, and any film or TV appearances.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The cocktail name"
}
},
"required": [
"name"
]
},
"page": "/"
}Find every cocktail that uses a given ingredient (spirit, juice, liqueur, etc.). Useful for "what can I make with ..." questions.
{
"name": "find_cocktails_by_ingredient",
"kind": "read",
"impl": "imperative",
"description": "Find every cocktail that uses a given ingredient (spirit, juice, liqueur, etc.). Useful for \"what can I make with ...\" questions.",
"inputSchema": {
"type": "object",
"properties": {
"ingredient": {
"type": "string",
"description": "An ingredient name, e.g. \"gin\" or \"lime juice\""
}
},
"required": [
"ingredient"
]
},
"page": "/"
}Find every cocktail that appears in a given film or TV show. Match is on the title or the scene description, so a character or actor works too — e.g. "Casablanca", "Bond", "Hemingway". Each result names the cocktail, the title, the year, and the scene.
{
"name": "find_cocktails_in_movie",
"kind": "read",
"impl": "imperative",
"description": "Find every cocktail that appears in a given film or TV show. Match is on the title or the scene description, so a character or actor works too — e.g. \"Casablanca\", \"Bond\", \"Hemingway\". Each result names the cocktail, the title, the year, and the scene.",
"inputSchema": {
"type": "object",
"properties": {
"movie": {
"type": "string",
"description": "A film or TV show title, full or partial"
}
},
"required": [
"movie"
]
},
"page": "/"
}Given the ingredients you have on hand, find every cocktail you can make completely — one where you already have all of its ingredients. Garnishes are treated as optional and plain water is assumed available. Returns two lists: "makeable" (drinks you can make now) and "almostMakeable" (drinks one ingredient short, each naming the missing ingredient). Both are ordered simplest drink first.
{
"name": "find_makeable_cocktails",
"kind": "read",
"impl": "imperative",
"description": "Given the ingredients you have on hand, find every cocktail you can make completely — one where you already have all of its ingredients. Garnishes are treated as optional and plain water is assumed available. Returns two lists: \"makeable\" (drinks you can make now) and \"almostMakeable\" (drinks one ingredient short, each naming the missing ingredient). Both are ordered simplest drink first.",
"inputSchema": {
"type": "object",
"properties": {
"ingredients": {
"type": "array",
"items": {
"type": "string"
},
"description": "The ingredients you have available — spirits, liqueurs, juices, mixers, etc. e.g. [\"gin\", \"sweet vermouth\", \"Campari\", \"lime\"]"
}
},
"required": [
"ingredients"
]
},
"page": "/"
}Suggest a random cocktail and return its full recipe. Optionally restrict to a drink family.
{
"name": "random_cocktail",
"kind": "action",
"impl": "imperative",
"description": "Suggest a random cocktail and return its full recipe. Optionally restrict to a drink family.",
"inputSchema": {
"type": "object",
"properties": {
"family": {
"type": "string",
"description": "Optional drink family, e.g. Spirit-Forward, Sour, Highball, Fizz & Collins, Spritz, Champagne Cocktail, Tiki, Punch, Flip & Nog, Hot Drink, Shot"
}
}
},
"page": "/"
}