# Home Bar Stock Planner AI Agent Connect

> Home Bar Stock Planner handles the math for your cocktail parties. It calculates the exact volumes of spirits, mixers, and garnishes you need based on your guest count. Your AI client can check your current inventory against recipe requirements to build a precise shopping list, ensuring you never run out of ingredients mid-party.

## Overview
- **Category:** lifestyle
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YDSGlLGyyRk78Z2cyZgFBGhkDXOsdPDOz2PfMEcN/ai-agent-connect
- **Tags:** cocktails, party-planning, inventory-management, drinks, bar

## Description

Hosting a cocktail event shouldn't involve guessing how many bottles of gin or bags of ice you need. This MCP turns your AI client into a precision planning engine for your home bar. You can pull specific cocktail recipes and immediately translate them into bulk quantities for any number of people. Instead of manual math, you just tell your agent how many guests are coming and what you want to serve. It looks at your current stock to see what you already have on hand and tells you exactly what is missing. This prevents the common headache of running out of a key mixer or realizing you don't have enough glassware halfway through the night. It's a direct way to manage your inventory and event logistics through a simple chat interface.

## Tools

### calculate_total_requirements
This tool calculates the total volume and quantity of every ingredient required for your planned event.

### compare_requirements_to_stock
This tool compares what you need for an event against your current inventory to find out what to buy.

### get_cocktail_recipe
This tool pulls the specific ingredients and glassware needed for a chosen cocktail.

### get_stock_status
Use this to see a summary of what you currently have in your bar inventory.

## Prompt Examples

**Prompt:** 
```
I'm hosting 10 people and want to serve Margaritas. How much tequila and lime juice do I need?
```

**Response:** 
```
For 10 guests, you will need 500ml of Tequila and 250ml of Lime Juice.
```

**Prompt:** 
```
What is my current stock of spirits?
```

**Response:** 
```
You currently have 750ml of Vodka, 500ml of Gin, and 350ml of Tequila in stock.
```

**Prompt:** 
```
I want to make Old Fashioneds for 5 people. What do I need to buy?
```

**Response:** 
```
You need to purchase 150ml of Bourbon and 50ml of Angostura Bitters.
```

## Capabilities

### Recipe Retrieval
Your agent fetches ingredient lists and glassware needs for specific drinks.

### Inventory Auditing
The AI checks your current bar supplies to establish a baseline.

### Bulk Scaling
Your agent calculates total ingredient volumes based on your guest count.

### Gap Analysis
The AI identifies the difference between your needs and your current stock.

## Use Cases

### Party Prep
Calculate exactly how much ice and tequila to buy for a 20-person Margarita night.

### Inventory Management
Check your current spirit levels before heading to the liquor store.

### Shopping Lists
Get a list of only the items you are missing for a specific cocktail menu.

### Recipe Planning
Find the glassware requirements for a specific drink to ensure you have enough cups.

## Benefits

- Eliminates guesswork regarding spirit and mixer volumes.
- Generates shopping lists by comparing needs to current inventory.
- Prevents ingredient shortages during events.
- Automates the math for scaling recipes to any guest count.

## How It Works

Connect your AI client to Vinkius and start planning through natural language.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Ask your agent to check your current bar stock.
3. Request a specific cocktail recipe.
4. Tell your agent how many guests you are hosting.
5. Ask for a shopping list based on the difference between your needs and your stock.

## Frequently Asked Questions

**How does this MCP help with party planning?**
It calculates the exact amounts of spirits, mixers, and garnishes you need based on your guest count and compares those needs to what you already have in stock.

**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 tell me what I need to buy?**
Yes, by using the comparison tool, your agent identifies exactly which ingredients are missing from your inventory so you can create a shopping list.

**Will it help me with glassware?**
Yes, the recipe tool includes the glassware requirements for specific cocktails.

**Do I need to manage the hosting myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after you connect your client.

**How do I know what I need to buy for a party?**
Use `calculate_total_requirements` to find the total needs for your guest count, then use `compare_requirements_to_stock` to see what is missing from your current bar inventory.

**Can I check my current bar inventory?**
Yes, you can use `get_stock_status` to view your current levels of spirits, mixers, garnishes, or glassware.

**Does this tool account for ice and glassware?**
Yes, the planning engine calculates the necessary volume of ice and the specific count of glassware required for the selected cocktails.