# TheCocktailDB MCP for AI Agents AI Agent Connect > TheCocktailDB. Global cocktail database for AI agents to find recipes, ingredients, and mixology guides. It lets your agent act as a professional bartender, pulling thousands of drink details, filtering by what's in your cabinet, and generating drink ideas on the fly. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_mkEg9UMG9ZayNQrhmpLLWTzbhpaf39ILSENxkk48/ai-agent-connect - **Tags:** recipes, mixology, database-search, ingredients, beverages, culinary ## Description Imagine you're hosting a party and someone asks for a non-alcoholic drink that doesn't have ginger. Instead of scrolling through endless blogs or guessing ratios, you just ask your AI agent. It pulls from a massive library of thousands of drinks to give you exact measurements and instructions instantly. This Connector turns your agent into a mixology expert that knows every classic and modern recipe. You can ask it to find drinks based on the specific bottles you have on your bar cart or look up the exact properties of a rare spirit. It handles the heavy lifting of searching through categories, glass types, and alcohol content so you don't have to. If you're a content creator, you can get high-quality image links and structured data for every drink to populate your menu or social feed. It's one of the many high-quality tools you can find in the Vinkius catalog to make your AI much more capable in the culinary space. You get professional-grade mixology intelligence without having to memorize a single recipe. ## Tools ### filter_by_category Filter cocktails by specific categories like Ordinary Drink or Cocktail. This helps you quickly find a certain style of drink. ### filter_by_ingredient Find drinks that contain a specific ingredient you have on hand. This is perfect for when you want to use up what's in your cabinet. ### list_alcoholic_filters See the available options for filtering drinks by alcohol content. This lets you choose between alcoholic and non-alcoholic choices. ### list_categories Get a full list of all drink categories in the database. You can use this to see the breadth of the mixology library. ### list_glasses See a list of different glassware types for various drinks. This helps you figure out the right presentation for your cocktails. ### list_ingredients Pull a complete list of all ingredients available in the database. Use this to see every possible component in the library. ### get_cocktail_details Retrieve full instructions and image links for a specific cocktail ID. This gives you everything you need to make the drink perfectly. ### get_ingredient_details Get the specific metadata and details for a single ingredient. This is useful for understanding the properties of a specific spirit or fruit. ### get_random_cocktail Ask for a completely random drink recipe to find new inspiration. Use this when you want to try something different and unexpected. ### search_ingredient_by_name Look up an ingredient by its name to see if it's in the database. This helps you verify what components your agent can access. ### search_cocktail_by_first_letter Find drinks by their starting letter when you're browsing. This is a quick way to navigate the database alphabetically. ### search_cocktail_by_name Search for a specific cocktail by its full name. Use this to get the exact recipe for a well-known classic. ## Prompt Examples **Prompt:** ``` I have gin and lime. What can I make? ``` **Response:** ``` Based on the ingredients you have, here are a few great options: | Drink Name | Key Ingredients | | :--- | :--- | | **Gin Rickey** | Gin, Lime, Soda Water | | **Tom Collins** | Gin, Lemon, Sugar, Soda | Would you like the full instructions for one of these? ``` **Prompt:** ``` Give me a random drink for a summer night. ``` **Response:** ``` How about a **Mojito**? It's a refreshing classic made with: * White Rum * Lime Juice * Mint Leaves * Sugar * Soda Water I can provide the full step-by-step instructions if you're ready to mix! ``` **Prompt:** ``` How do I make a Margarita? ``` **Response:** ``` Here is the classic **Margarita** recipe: **Ingredients:** * Tequila * Triple Sec * Lime Juice **Instructions:** 1. Combine all ingredients in a shaker. 2. Shake with ice. 3. Strain into a salt-rimmed glass. [Image: A crisp Margarita with a salt rim] ``` ## Capabilities ### Find specific drink recipes Your agent pulls complete instructions and image links for any drink in the database. ### Pull ingredient metadata Get detailed information about specific spirits, fruits, or mixers. ### Filter by alcohol content Quickly separate alcoholic choices from non-alcoholic options. ### Get random drink ideas Generate a completely random cocktail to find new inspiration. ### Match drinks to current inventory Find every drink you can make using the ingredients you already have. ### Search by first letter Browse the database alphabetically to find specific drink names. ## Use Cases ### Creating a non-alcoholic party menu A host asks their agent to find drinks for a guest who doesn't drink. The agent uses list_alcoholic_filters to find perfect mocktails. ### Finding the right glassware A bartender needs to know the correct glass for a rare cocktail. The agent uses list_glasses to provide the correct presentation. ### Building a themed social media feed A creator wants a Tequila-themed menu. The agent pulls all recipes using that ingredient via filter_by_ingredient. ### Inventory-based recipe discovery A home cook has a few random items and asks their agent what they can make. The agent uses filter_by_ingredient to find matches. ## Benefits - Get exact measurements for any drink using get_cocktail_details so you never have to guess ratios again. - Save time on menu planning by using list_categories and list_glasses to see what's available in the database. - Reduce waste by using filter_by_ingredient to see exactly what you can make with your current supplies. - Find new drink ideas quickly with get_random_cocktail when you're stuck for inspiration during a party. - Build high-quality content faster using search_cocktail_by_name to pull images and data for your social media. ## How It Works The bottom line is your AI gets instant access to a professional mixology database for real-time drink creation. 1. Subscribe to the Connector and grab your API key. 2. Plug that key into your AI client settings. 3. Ask your agent to find a drink or build a custom menu. ## Frequently Asked Questions **Can TheCocktailDB find non-alcoholic drinks?** Yes, it can. You can ask your agent to filter for non-alcoholic options, which allows you to find a wide variety of mocktails and other beverages. **Does TheCocktailDB include images for the recipes?** Yes, it provides high-quality image links for the drinks in the database, making it easy to see what the final result should look like. **Can I use TheCocktailDB to build a professional drink menu?** Absolutely. You can use it to pull data for dozens of drinks at once, including categories and glass types, to build a complete menu quickly. **Can TheCocktailDB help me with specific ingredients?** Yes, it can find every drink that uses a specific ingredient. This is great for seeing what you can make with the supplies you already have. **Is TheCocktailDB good for professional bartenders?** Yes, it is designed to provide exact measurements and ratios, which is essential for professional mixology and consistent drink quality. **Can I search for cocktails that only contain a specific ingredient like Gin?** Yes! Use the `filter_by_ingredient` tool with 'Gin'. It will return a list of all cocktails in the database that include Gin as one of their primary components. **How do I get the full instructions and image for a specific drink?** First, find the drink ID using `search_cocktail_by_name`. Then, use the `get_cocktail_details` tool with that ID to retrieve the high-res image URL, full ingredient list, and step-by-step instructions. **Does the integration provide non-alcoholic drink options?** Absolutely. You can use the `list_alcoholic_filters` tool to see available filters, and then use `filter_by_category` or specific search queries to identify 'Non_Alcoholic' drinks.