# Cocktail API MCP for AI Agents AI Agent Connect

> Cocktail API gives your AI agent direct access to a massive database of global drink recipes. It lets you search for specific cocktails, break down ingredient lists, and pull out step-by-step preparation instructions instantly. Whether you're building a new bar menu or researching regional spirits, this Connector handles the heavy lifting of drink data.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_H1BSqerAHU58v7F5z0BJ2h5aQqjSvNiLlMYHBts2/ai-agent-connect
- **Tags:** recipe-database, mixology, ingredients, data-lookup, api-integration

## Description

Imagine you're trying to build a new cocktail menu for a high-end lounge. Instead of digging through old notebooks or searching dozens of different websites, you just tell your agent what you need. This Connector lets your AI act as a research assistant that knows every drink from a classic martini to regional tequila specialties. It handles the tedious work of checking what's in a drink, finding recipes based on specific ingredients you have on hand, and pulling out precise instructions for your staff. You'll get consistent data every time, which makes it a huge time-saver when you're trying to keep your drink list fresh and accurate. It's one of the most practical ways to bring real-world mixology data into your workflow through the Vinkius catalog, turning a research project into a quick conversation.

## Tools

### get_cocktails_by_ingredients
Finds recipes based on the items you have in stock. This is perfect for minimizing waste in a busy bar.

### get_classic_martinis
Retrieves different takes on the Martini. Use this to see how different regions style the drink.

### get_gin_cocktails
Lists popular Gin-based drinks. It's a quick way to see what's trending for that specific spirit.

### get_rum_cocktails
Provides a list of Rum cocktails. Use this to explore tropical or spicy drink profiles.

### get_tequila_cocktails
Shows various Tequila drinks. This is great for identifying assets for a Mexican-themed menu.

### get_vodka_cocktails
Fetches popular Vodka recipes. It helps you quickly see what's available for a clean spirit base.

### get_classic_margaritas
Pulls specific variations of the classic Margarita. It helps you find different ways to serve this staple drink.

### search_cocktails
Searches for any specific drink by its name. This is your primary way to look up a single recipe quickly.

## Prompt Examples

**Prompt:** 
```
What's a good way to use vodka and coffee in a drink?
```

**Response:** 
```
I found a few great options for vodka and coffee! The most popular choice is the **Espresso Martini**. 

**Espresso Martini**
*   **Ingredients**: Vodka, espresso, coffee liqueur, and simple syrup.
*   **Instructions**: Shake all ingredients with ice and strain into a chilled glass.

Would you like to see more coffee-based drinks?
```

**Prompt:** 
```
Can you find me three different ways to make a Margarita?
```

**Response:** 
```
Here are three classic variations of the Margarita:

| Variation | Key Ingredients |
| :--- | :--- |
| **Classic** | Tequila, Lime Juice, Triple Sec |
| **Tommy's** | Tequila, Lime Juice, Agave Nectar |
| **Cadillac** | Tequila, Lime Juice, Triple Sec, Cointreau |

I can get the full instructions for any of these if you'd like!
```

**Prompt:** 
```
I have tequila and lime. What can I make?
```

**Response:** 
```
With tequila and lime, you have a lot of great options! Here are a few favorites:

*   **Margarita** (The classic choice)
*   **Paloma** (If you have grapefruit soda)
*   **Tequila Sunrise** (If you have orange juice and grenadine)

Would you like the full recipe for the Margarita?
```

## Capabilities

### Search specific drink recipes
Find any cocktail by name to get a full breakdown of ingredients and preparation steps.

### Filter by available ingredients
Identify which drinks you can make based on the specific spirits or mixers you have in stock.

### Pull step-by-step instructions
Retrieve clear, sequential preparation guides for any beverage in the database.

### Explore spirit-based variations
Query popular drinks for specific bases like gin, rum, tequila, or vodka.

### Find classic drink iterations
Get different variations of staple drinks like margaritas and martinis.

## Use Cases

### Building a seasonal menu
A bartender asks for all drinks with vodka and coffee to create a winter list. The agent uses `get_vodka_cocktails` to compile a list.

### Inventory management
A bar manager asks what drinks can be made using only lime, tequila, and agave. The agent uses `get_cocktails_by_ingredients` to find options.

### Recipe auditing
A hospitality lead needs to check the instructions for 20 different drinks to ensure staff training is consistent. The agent pulls these instantly.

### Drink discovery
A home enthusiast wants to see every variation of a classic margarita to find a unique twist. The agent uses `get_classic_margaritas` to show the variety.

## Benefits

- Stop manual searching by using `search_cocktails` to pull up any recipe in seconds.
- Reduce bar waste by using `get_cocktails_by_ingredients` to see what you can make with current stock.
- Build diverse menus faster by querying `get_gin_cocktails` or `get_rum_cocktails` for spirit-specific trends.
- Ensure consistency across locations by using `get_classic_margaritas` and `get_classic_martinis` for standard variations.
- Speed up menu planning by using `get_tequila_cocktails` and `get_vodka_cocktails` to find high-volume assets.

## How It Works

The bottom line is you get instant, accurate mixology data without leaving your chat window.

1. Connect the Cocktail API to your preferred client via Vinkius.
2. Provide your API Ninjas key to authorize the connection.
3. Ask your agent to find recipes, audit ingredients, or build menus.

## Frequently Asked Questions

**Can I use Cocktail API to build a bar menu?**
Yes, it's a great way to do that. Your agent can pull dozens of recipes at once, organized by spirit or theme, so you can build a consistent menu in minutes.

**How does Cocktail API help with mixology?**
It acts as a massive database for your agent. You can ask it to find specific drink variations, check ingredients, or research regional drink styles quickly.

**Does Cocktail API include step-by-step instructions?**
Yes, it provides full preparation instructions for the recipes it finds. This makes it easy to share consistent drink guides with your staff.

**Can I find drinks based on what's in my fridge with Cocktail API?**
Absolutely. You can tell your agent which ingredients you have, and it will use the Connector to find recipes that match what you have on hand.

**Is Cocktail API good for hospitality managers?**
It's perfect for auditing drink lists. You can quickly see what's in every drink on your menu to help with cost analysis and inventory planning.

**How do I get drink data for my AI agent using Cocktail API?**
Once you connect the Connector through Vinkius and add your API key, your agent can access the entire database using natural language commands.

**How do I find my API Ninjas Key?**
Log in to your [**API Ninjas dashboard**](https://api-ninjas.com/profile), and you will find your API Key on the main page. Copy and paste it below.

**Can I search for cocktails by ingredients?**
Yes. Use the `get_cocktails_by_ingredients` tool providing a comma-separated list (e.g., 'vodka,orange juice'). Your agent will return matching recipes instantly.

**Does it support detailed instructions?**
Yes. Every cocktail recipe retrieved by your agent includes the official preparation instructions provided by API Ninjas.