{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Cocktail name or part of one — a single drink name, not an ingredient or category.",
"examples": [
"Negroni",
"margarita",
"carre"
]
}
},
"required": [
"query"
]
}{
"type": "object",
"properties": {
"family": {
"type": "string",
"description": "Optional drink family — one of: Spirit-Forward, Sour, Highball, Fizz & Collins, Spritz, Champagne Cocktail, Tiki, Punch, Flip & Nog, Hot Drink, Shot. Matched exactly (case- and diacritic-insensitive); an unknown family returns an empty list. Omit to list the entire catalogue.",
"examples": [
"Sour",
"Tiki"
]
}
}
}{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "The cocktail name. Exact is best; partial names work but resolve to the first substring match, so prefer search_cocktails when the name is uncertain.",
"examples": [
"Negroni",
"Margarita"
]
}
},
"required": [
"name"
]
}{
"type": "object",
"properties": {
"ingredient": {
"type": "string",
"minLength": 1,
"description": "A single ingredient term. One value only; passing a comma-separated list is treated as one literal string and will rarely match. Use find_makeable_cocktails for multi-ingredient queries.",
"examples": [
"gin",
"lime juice",
"Campari"
]
}
},
"required": [
"ingredient"
]
}{
"type": "object",
"properties": {
"movie": {
"type": "string",
"minLength": 1,
"description": "A film or TV show title, full or partial",
"examples": [
"Casablanca",
"Bond",
"Hemingway"
]
}
},
"required": [
"movie"
]
}{
"type": "object",
"properties": {
"ingredients": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "The ingredients you have available — spirits, liqueurs, juices, mixers, etc.",
"examples": [
[
"gin",
"sweet vermouth",
"Campari",
"lime"
]
]
}
},
"required": [
"ingredients"
]
}{
"type": "object",
"properties": {
"family": {
"type": "string",
"description": "Optional drink family — one of: Spirit-Forward, Sour, Highball, Fizz & Collins, Spritz, Champagne Cocktail, Tiki, Punch, Flip & Nog, Hot Drink, Shot. Other values fall back to the full catalogue. Omit for an unrestricted random pick.",
"examples": [
"Tiki",
"Sour"
]
}
}
}