# Beverage Batch Planner AI Agent Connect

> Beverage Batch Planner MCP handles the math for large scale drink service. It calculates exact liquid volumes by accounting for ice displacement and garnish size, tells you exactly how many bottles to buy, and checks recipes against dietary restrictions. Your AI client does the heavy lifting so you don't overbuy or run out mid-event.

## Overview
- **Category:** logistics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_fPZ8JbMlLfAwpVCVyzaxozzfWf6I3GprTDMLsg7I/ai-agent-connect
- **Tags:** cocktails, catering, batching, inventory, event-management

## Description

Planning drinks for a hundred people is different than making a single cocktail. You have to account for how much space ice takes up in a glass, how much room a lime wedge occupies, and exactly how many bottles of gin to order to avoid waste. This MCP turns your AI client into a professional catering assistant that handles these logistics instantly.

You can pull up base recipes and their unit costs to build accurate budgets. If you're worried about guest allergies, the tool checks your recipes against dietary or regional restrictions to keep things safe. Instead of guessing how much liquid you need, you provide the guest count and glass size, and the math is done for you. It's a direct way to move from a recipe idea to a shopping list without manual spreadsheets.

## Tools

### calculate_batch_requirements
This tool calculates total liquid volumes, specific ingredient amounts, and the total cost for your planned event.

### estimate_inventory_needs
This tool determines the exact number of full ingredient units you need to purchase to cover your batch.

### get_recipe_by_name
This tool retrieves the base recipe and the unit costs for a specific beverage.

### validate_recipe_safety
This tool checks if a recipe contains ingredients that conflict with dietary or regional restrictions.

## Prompt Examples

**Prompt:** 
```
I need to make 50 Margaritas. The glasses are 300ml, ice takes up 50ml, and lime garnish takes up 10ml. How much liquid do I need?
```

**Response:** 
```
To serve 50 guests, you will need a total batch volume of 12,000ml of liquid.
```

**Prompt:** 
```
Is the Mojito recipe safe for someone who is vegan?
```

**Response:** 
```
Yes, the Mojito is safe for vegan dietary restrictions.
```

**Prompt:** 
```
How many 750ml bottles of Gin do I need for 100 servings of a Gin Fizz?
```

**Response:** 
```
You will need to purchase 4 bottles of Gin.
```

## Capabilities

### Volume Calculation
The AI calculates liquid needs by subtracting ice and garnish displacement from glass volume.

### Inventory Planning
Your agent determines the number of full bottles required based on recipe needs.

### Dietary Verification
The AI checks recipes against specific dietary or regional restrictions.

### Cost Estimation
The tool calculates total ingredient costs for a planned batch.

### Recipe Retrieval
Your agent pulls base recipes and unit costs for specific drinks.

## Use Cases

### Wedding Beverage Planning
Calculate exactly how much champagne and mixers to buy for a specific guest count.

### Catering Inventory Management
Turn a recipe list into a specific number of bottles to order from suppliers.

### Dietary Compliance
Verify that a cocktail menu is safe for guests with specific dietary needs.

### Budgeting for Events
Determine the total cost of a drink menu before purchasing ingredients.

## Benefits

- Accounts for ice and garnish displacement to prevent liquid shortages.
- Converts ingredient volumes into full bottle purchase counts.
- Identifies dietary conflicts within recipes automatically.
- Calculates total event beverage costs based on unit pricing.

## How It Works

Connect your AI client to Vinkius to start running beverage math.

1. Connect your MCP-compatible client to Vinkius.
2. Provide your drink recipe or name to your agent.
3. Input guest count, glass size, and displacement details.
4. Receive precise liquid volumes, bottle counts, and cost totals.

## Frequently Asked Questions

**How does this MCP handle ice in a drink?**
It uses ice displacement to calculate the actual liquid volume needed to fill a glass.

**Can I use this with Claude or Cursor?**
Yes, you can connect this MCP to any MCP-compatible client like Claude, Cursor, or Windsurf.

**Does it help with shopping lists?**
Yes, it calculates how many full units or bottles of an ingredient you need to buy.

**Can it check for vegan recipes?**
Yes, the tool can validate if a recipe meets specific dietary restrictions.

**How does it calculate costs?**
It uses unit costs from the recipe to determine the total cost for the batch.

**How does the tool account for ice?**
The tool uses the `iceDisplacement` parameter to subtract the volume occupied by ice from the total glass capacity, ensuring you don't overfill.

**Can I check if a drink is vegan?**
Yes, you can use `validate_recipe_safety` with the 'vegan' restriction to check for conflicting ingredients.

**How many bottles of gin should I buy?**
You can use `estimate_inventory_needs` to get the exact number of purchase units required for your batch.