# TheCocktailDB MCP for AI Agents AI Agent Connect > TheCocktailDB lets your AI agent pull from a library of over 600 cocktail recipes. It handles everything from specific ingredient searches to finding the right glassware for a classic drink. You can get full mixing instructions, exact measurements, and category browsing in one go. It's the easiest way to give your agent mixology knowledge without building your own database. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_p4KWEqA8nKxMDD4zgZIgVrDMgddGP19RBIC03CT4/ai-agent-connect - **Tags:** recipe-database, mixology, ingredient-search, cooking-assistant, api-integration ## Description TheCocktailDB MCP gives your AI agent access to a library of over 600 cocktail recipes from around the world. Instead of hunting through old blogs or guessing measurements, this connector lets your agent pull data from a large database of global drinks. It knows the difference between a shot and a punch, and it tells you which glass to use so you don't end up serving a Negroni in a coffee mug. You can ask it to find every drink that uses a specific spirit like gin or pull up the full breakdown for a Margarita. It's a big help for anyone who needs accurate mixology data on demand. Because Vinkius hosts this Connector, you can get it connected to your favorite AI client in minutes, turning a basic chat into a real bartending assistant. No more copy-pasting from websites or guessing ratios. You just ask, and the agent provides the full breakdown of ingredients, steps, and presentation details instantly. ## Tools ### browse_cocktail_category See what's available in categories like shots, coffee, or party drinks. ### search_cocktails Search for a specific drink by name to get its full preparation guide. ### find_cocktails_by_ingredient Find every drink that features a specific spirit like Tequila or Bourbon. ### get_cocktail_details Pull the full recipe, measurements, and instructions for a specific drink ID. ### get_random_cocktail Get a surprise drink recommendation when you don't know what to mix. ## Prompt Examples **Prompt:** ``` How do I make a classic Mojito? ``` **Response:** ``` Here is a classic Mojito recipe: **Ingredients:** - 60ml White Rum - 30ml Lime Juice - 2 sprigs Mint - 1 tsp Sugar - Splash of Soda Water **Instructions:** 1. Muddle mint and sugar in a glass. 2. Add lime juice and rum. 3. Stir well with ice. 4. Top with soda water. **Glass Type:** Highball Glass ``` **Prompt:** ``` I have some Tequila. What are some drinks I can make? ``` **Response:** ``` Since you have Tequila, here are a few options: - **Margarita**: A classic citrus and agave blend. - **Paloma**: A refreshing grapefruit and lime mix. - **Tequila Sunrise**: A vibrant fruit-forward drink. Would you like the full instructions for one of these? ``` **Prompt:** ``` Give me a random drink idea for a party. ``` **Response:** ``` How about a **Punch/Party Drink**? **Recipe:** - 2 oz Vodka - 1 oz Orange Juice - 1 oz Pineapple Juice - Splash of Grenadine **Instructions:** Mix all ingredients in a large bowl with ice. Serve in a punch bowl or individual glasses. Perfect for a crowd! ``` ## Capabilities ### Search for specific drinks by name Find any drink and get its full recipe, measurements, and mixing steps. ### Filter recipes based on a primary spirit See every drink that uses a specific spirit like Tequila, Gin, or Bourbon. ### Browse drinks by category Explore drinks grouped by type, such as shots, coffee, or party drinks. ### Get a random drink suggestion Get a surprise cocktail recommendation when you need inspiration. ### Pull full recipe details Get specific details including the correct glass type for authentic presentation. ## Use Cases ### Finding drinks with specific ingredients A user asks, 'I have a bottle of Gin and some lime; what can I make?' The agent uses `find_cocktails_by_ingredient` to list all relevant options. ### Building a drink discovery app A developer needs a list of common shots for a new UI. The agent uses `browse_cocktail_category` to pull a pre-made list of shots and coffee drinks. ### Learning a classic recipe A home bartender asks, 'How do I make a proper Old Fashioned?' The agent uses `search_cocktails` to provide the step-by-step guide. ### Getting party inspiration A host asks for a drink idea for a large group. The agent uses `get_random_cocktail` to provide a unique punch or party drink recommendation. ## Benefits - Get accurate measurements for every drink. Use `search_cocktails` to stop guessing ratios and start making drinks that taste exactly how they should. - Discover new drinks based on what's in your cabinet. `find_cocktails_by_ingredient` helps you use up your leftover spirits without wasting anything. - Learn proper presentation. Every recipe includes the correct glass type, so your drinks look like they came from a professional bar. - Save time on research. Instead of browsing multiple websites, your agent can pull 600+ recipes from one place using `get_cocktail_details`. - Beat decision fatigue at the bar. Use `get_random_cocktail` to get a high-quality suggestion whenever you're stuck on what to make next. ## How It Works The bottom line is you get instant access to a professional-grade cocktail database without any manual data entry. 1. Connect the TheCocktailDB MCP to your AI client via Vinkius. 2. Ask your agent to find a drink or a list of recipes. 3. Receive a complete breakdown of ingredients and mixing steps. ## Frequently Asked Questions **Can TheCocktailDB MCP help me build a bar app?** Yes, it provides a structured way to pull drink data for your app's menu or search features. **Does TheCocktailDB MCP include mixing instructions?** Yes, every recipe includes step-by-step instructions and exact measurements. **Can I use TheCocktailDB MCP to find drinks with specific spirits?** You can ask your agent to find any drink containing ingredients like Gin, Rum, or Whiskey. **Will TheCocktailDB MCP tell me what glass to use?** Yes, the recipes include the correct glassware for an authentic presentation. **Can I get random drink ideas with TheCocktailDB MCP?** You can ask your agent for a random recommendation whenever you need some inspiration. **Is there a limit to the recipes in TheCocktailDB MCP?** It provides access to over 600 recipes from around the world. **Do I need an API key?** No. TheCocktailDB provides free open access. No registration or API key required. **Are measurements standardized across all recipes?** Measurements on TheCocktailDB typically default to imperial measurements (oz, parts, dashes). They match exactly what the database provides. **Can I search for non-alcoholic mocktails?** Definitely! The DB maintains a 'Non-Alcoholic' category you can filter by when asking for a refreshing drink with zero ABV.