Bar Assistant MCP Server

🚀 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

🍸 Advanced recipe retrieval with powerful batch processing for multiple cocktails.

🚀 BATCH PROCESSING SYSTEM:

• High Performance: 5-10x faster than sequential requests

• Parallel Processing: Simultaneous API calls with error isolation

• Smart Caching: 70%+ cache hit rate for repeated requests

• Flexible Input: Mix cocktail names and IDs in single request

• Error Resilience: Individual failures don't break entire batch

📋 LLM Usage Patterns:

• Single Recipe: When user asks for "how to make [cocktail]"

• Recipe Comparison: When user wants to compare multiple cocktails

• Menu Planning: Batch retrieve recipes for event planning

• Variation Exploration: Get base recipe + similar cocktails

• Research Mode: Efficient lookup of multiple specific recipes

🎯 Input Methods (Choose Based on Use Case):

1. Single Recipe (Backwards Compatible):

   • cocktail_name: "Manhattan" → One complete recipe

   • cocktail_id: 123 → Recipe by database ID

2. Batch by Names (Most Common):

   • cocktail_names: ["Negroni", "Manhattan", "Martini"] → Multiple complete recipes

3. Batch by IDs (When Available):

   • cocktail_ids: [1, 2, 3] → Multiple recipes by database IDs

4. Mixed Batch (Maximum Flexibility):

   • cocktail_names: ["Aviation"] + cocktail_ids: [123, 456] → Combined approach

5. With Variations (Exploration):

   • Any above + include_variations: true → Base recipes + similar cocktails

📊 Response Format: Structured output with complete recipe data:

• Precise ingredient measurements (auto-converted to oz)

• Step-by-step preparation instructions

• Cocktail specifications (ABV, glassware, method, garnish)

• Direct database links for each recipe

• Performance metrics (timing, cache usage)

• Similar recipes when requested

• Rich formatting with emojis and clear sections

⚡ Performance Examples:

• Single recipe: ~150-300ms (cached responses faster)

• Batch (3 cocktails): ~250-400ms (vs 900ms+ sequential)

• Mixed batch (5 cocktails): ~300-500ms with parallel processing

• Cache hit: <50ms instant response

🎛️ Batch Control Parameters:

• limit: 1-20 recipes (default: 10) - controls batch size

• include_variations: Boolean - adds similar cocktails to results

Get comprehensive information about cocktail ingredients and their usage.

Use Cases:

• Ingredient research: "what is Aperol?", "tell me about gin"

• Substitution guidance: finding alternatives for unavailable ingredients

• Usage exploration: see how ingredients are used across different cocktails

• Flavor profile understanding: learn about ingredient characteristics

Response Format: Returns detailed ingredient information including:

• Ingredient description and characteristics

• List of cocktails using this ingredient (with complete recipes)

• Suggested substitutions with flavor impact notes

• Common flavor profiles and tasting notes

• Direct links to featured cocktails

Examples:

• {ingredient_name: "Campari"} → Campari info + Negroni, Boulevardier recipes

• {ingredient_name: "rye whiskey"} → Usage in Manhattan, Sazerac, etc.

• {ingredient_name: "elderflower liqueur"} → Aviation, Paper Plane recipes