# CocktailFyi MCP for AI Agents AI Agent Connect > CocktailFyi connects your AI agent to a database of over 600 cocktail recipes, spirits, and mixology guides. It lets you ask for specific drinks based on what's in your fridge, learn the difference between shaking and stirring, and get step-by-step instructions for professional-grade cocktails. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_okLMy5wqGGkD3kL6I0oBcFrcbUfLOmA9WS6BpNjZ/ai-agent-connect - **Tags:** cocktail-recipes, bartending, educational-guides, open-source, data-lookup ## Description CocktailFyi lets you turn your AI client into a professional mixologist who knows every drink in the book. You don't have to scroll through endless blogs or guess which ingredients go together when you're hosting a party or practicing your craft at home. This Connector pulls from a massive database of spirits, mixers, and flavor profiles to give you accurate measurements and prep times without the fluff. Whether you're looking for a low-calorie option or a classic spirit-forward drink, you get the facts immediately. It's one of the many specialized tools in the Vinkius catalog that turns a generic chat into a dedicated mixology assistant. You can ask for a drink using only what you have on hand, or find out exactly how to muddle mint for a Mojito without making a mess. It covers everything from the basic lingo to complex preparation methods, making it easy to level up your home bar game or host a perfect event. ## Tools ### get_cocktail_stats View high-level statistics about the cocktail database. Use this to see the scale of the information available. ### list_categories See every cocktail category available in the database. It helps you understand the variety of drinks you can explore. ### list_cocktails Browse a paginated list of all cocktails with flavor profiles and instructions. This is great for general browsing and discovery. ### list_faqs Get answers to common questions about mixology and cocktail making. It provides quick answers to frequent beginner queries. ### list_glossary Access a list of terms used in professional bartending. This helps you learn the industry lingo quickly. ### get_cocktail Get full details on a specific drink, including prep time and ABV. It provides all necessary measurements for making a drink correctly. ### get_ingredient Get detailed info on specific spirits, mixers, or garnishes. It explains what each component brings to the drink. ### list_guides See all available educational guides for making cocktails. These guides provide deeper context on mixology. ### search_cocktails Find drinks by name, specific ingredients, or guide titles. This is the fastest way to find a drink based on your current inventory. ### get_cocktails_by_category Find drinks filtered by specific styles like Highball or Martini. This helps you narrow down options based on a specific vibe. ### list_ingredients See a full list of all ingredients used across the database. Use this to see what components the system recognizes. ### list_techniques Get a list of preparation methods like shaking or muddling with descriptions. It explains exactly when and how to use each method. ## Prompt Examples **Prompt:** ``` What can I make with pomegranate juice and gin? ``` **Response:** ``` Based on your ingredients, here are a few great options: | Cocktail | Difficulty | Prep Time | | :--- | :--- | :--- | | **Pomegranate Gin Fizz** | Easy | 3 min | | **Gin & Pomegranate Smash** | Medium | 5 min | | **Sparkling Pomegranate Gin** | Easy | 1 min | Would you like the full recipe for any of these? ``` **Prompt:** ``` Should I shake or stir a Margarita? ``` **Response:** ``` You should **shake** a Margarita. Because it contains citrus juice and other ingredients that need aeration, shaking is the standard technique. It helps chill the drink quickly and creates a nice frothy texture. Stirring is usually reserved for spirit-forward drinks like Martinis. ``` **Prompt:** ``` Give me a 3-minute drink recipe. ``` **Response:** ``` Here is a quick and easy drink you can whip up in under 3 minutes: **Classic Gin and Tonic** * **Ingredients**: 2 oz Gin, 4 oz Tonic Water, Lime Wedge * **Instructions**: Fill a glass with ice, pour in the gin, top with tonic water, and garnish with a lime wedge. * **Prep Time**: 2 min * **Difficulty**: Easy ``` ## Capabilities ### Search by ingredient Find drinks based on specific spirits, mixers, or garnishes you already have. ### Get step-by-step recipes Retrieve exact measurements and instructions for over 600 different cocktails. ### Learn mixology techniques Discover the correct way to shake, stir, muddle, or build a drink. ### View flavor profiles Check ratings for sweetness, sourness, bitterness, and strength for any drink. ### Browse cocktail categories Explore drinks by style, glass type, or alcoholic status. ### Access bartending guides Get educational content on mixology basics and glossary terms. ## Use Cases ### Finding drinks with limited ingredients A user asks what they can make with tequila and lime. The agent uses search_cocktails to find 45 options and suggests the easiest ones. ### Learning correct drink preparation A user wants to know the difference between shaking and stirring. The agent uses list_techniques to explain how each affects texture and dilution. ### Planning a themed party menu A host asks for tropical drinks. The agent uses get_cocktails_by_category to list themed options with their specific flavor profiles. ### Quick recipe lookup for classics A user needs a classic Mojito recipe. The agent uses get_cocktail to provide the exact measurements, prep time, and glass type. ## Benefits - Stop guessing measurements with get_cocktail to get exact proportions every time. - Save time on research by using search_cocktails to find drinks based on your current inventory. - Improve your bar skills by learning the correct methods via list_techniques. - Plan balanced menus by checking flavor profiles to ensure a variety of tastes. - Learn the lingo and basics quickly using list_glossary and list_guides. ## How It Works The bottom line is you get professional mixology knowledge without the manual research. 1. Subscribe to the CocktailFyi MCP on Vinkius. 2. Connect the Connector to your preferred AI client like Claude or Cursor. 3. Ask for recipes or mixology tips in plain English. ## Frequently Asked Questions **Can I use CocktailFyi to find drinks based on what's in my fridge?** Yes, you can. Just tell your AI agent what spirits or mixers you have, and it will search the database to find recipes that match your current inventory. **How does CocktailFyi help me learn bartending?** It provides access to mixology techniques, glossary terms, and educational guides. You can learn the difference between shaking, stirring, and muddling. **Can I get specific measurements for classic cocktails with CocktailFyi?** Absolutely. The Connector provides full recipes with exact measurements, prep times, and difficulty ratings for over 600 different cocktails. **What kind of ingredients are in the CocktailFyi database?** The database includes a wide range of spirits, mixers, garnishes, and bitters, along with detailed information on how they are typically used. **Can CocktailFyi help me plan a themed drink menu?** Yes, you can use it to browse categories or search for specific flavor profiles to ensure your drink menu has a good balance of tastes. **Is CocktailFyi good for beginners?** It is perfect for beginners because it includes easy recipes, clear instructions, and a glossary of terms to help you learn the basics of mixology. **Do I need an API key or account?** No! CocktailFyi is a completely free and open API with no authentication required. **How many cocktails are available?** The database contains 600+ cocktails with complete recipes, plus hundreds of ingredients, techniques, guides, and glossary terms. **Can I search for cocktails by ingredient?** Yes! Use the `search_cocktails` tool with an ingredient name like 'vodka' or 'lime juice' to find all cocktails that use that ingredient.