smart_search_cocktails
Search cocktails by ingredients, flavors, or similarity using batch processing to retrieve complete recipes with measurements, instructions, and specifications.
Instructions
🚀 PREFERRED TOOL: Advanced cocktail search with intelligent batch processing and complete recipes.
🎯 BATCH PROCESSING SYSTEM:
High Performance: Parallel processing with 5-10x speed improvement
Smart Caching: Automatic caching for 70%+ faster repeated searches
Error Resilience: Individual failures don't break entire batch operations
Flexible Limits: Configure result count (default: 20, max: 50)
📋 Use Cases:
General searches: "gin cocktails", "winter drinks", "classic cocktails"
Similarity queries: "cocktails like Manhattan", "similar to Negroni"
Ingredient-based: "cocktails with bourbon", "drinks using Campari"
Flavor profiles: "bitter cocktails", "sweet drinks", "herbal spirits"
Complex filtering: combine ingredients, ABV ranges, glass types, methods
Batch comparisons: Multiple ingredient searches simultaneously
🔄 Batch Processing Examples:
Single search: {query: "Manhattan"} → Complete recipe + similar cocktails
Multi-ingredient: {ingredient: "gin", must_include: ["vermouth", "bitters"]}
Similarity batch: {similar_to: "Negroni", limit: 10} → 10 similar cocktails
Complex filter: {preferred_flavors: ["bitter"], abv_min: 25, limit: 15}
📊 Response Format: Returns structured data with complete recipes including:
Ingredients with precise measurements in oz (auto-converted from ml)
Step-by-step preparation instructions
Cocktail specifications (ABV, glass, method, garnish)
Direct links to cocktail database pages
Performance metrics (processing time, cache hits)
Similar cocktail recommendations with full recipes
⚡ Performance Features:
Parallel API processing for multiple results
Intelligent caching system with TTL management
Batch fetching of complete recipe details
Error isolation and fallback handling
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "smart_search_cocktails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | 🔍 Natural language search query (e.g., "Negroni", "gin cocktails", "bitter drinks") | |
| similar_to | No | 🔄 Find cocktails similar to this name (e.g., "Manhattan", "Negroni"). Triggers similarity batch processing. | |
| similar_to_id | No | 🆔 Find cocktails similar to this ID. Use similar_to (by name) unless you have the specific ID. | |
| ingredient | No | 🥃 Primary ingredient filter (e.g., "gin", "whiskey", "campari"). Combines with other filters for batch processing. | |
| must_include | No | ✅ Required ingredients array. Batch processes cocktails containing ALL these ingredients. | |
| must_exclude | No | ❌ Excluded ingredients array. Filters out cocktails with ANY of these ingredients. | |
| preferred_flavors | No | 🎯 Flavor profile preferences: ["bitter", "sweet", "sour", "spicy", "herbal"]. Improves batch ranking. | |
| preferred_strength | No | 💪 Alcohol strength preference. Filters batch results by ABV ranges. | |
| abv_min | No | 📊 Minimum ABV percentage. Lower bound for batch filtering. | |
| abv_max | No | 📊 Maximum ABV percentage. Upper bound for batch filtering. | |
| glass_type | No | 🥂 Required glassware (e.g., "coupe", "rocks", "martini"). Filters entire batch. | |
| preparation_method | No | 🔧 Required method (e.g., "shake", "stir", "build"). Filters batch by technique. | |
| limit | No | 🎛️ Maximum results to return (default: 20, max: 50). Controls batch size for optimal performance. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cocktails | No | Complete cocktail recipes with full details | |
| search_results | No | ||
| search_metadata | No | ||
| similar_cocktails | No | Additional similar cocktails (when using similarity search) | |
| performance_metrics | No | Batch processing performance data |