# TheCocktailDB MCP for AI Agents AI Agent Connect > TheCocktailDB MCP connects your AI agent to a massive database of cocktail recipes and ingredients. It lets you search by name, filter by alcohol content or glass type, and discover new drinks instantly. It turns your agent into a professional mixologist that knows every detail of the drink world. ## Overview - **Category:** gaming-entertainment - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/ai-agent-connect - **Tags:** cocktails, recipes, mixology, bartending, drinks ## Description Stop wasting time scrolling through messy food blogs or trying to decipher disorganized recipe lists. This Connector connects your AI client to a massive, structured database of mixology data. Instead of asking your agent to guess what's in a drink, it pulls the actual specs, including measurements, categories, and glassware requirements. You can ask for drinks based on what's in your fridge, filter for non-alcoholic options, or find the most popular drinks of the season. It's one of the best ways to add deep, reliable food and beverage data to your workspace through the Vinkius catalog. Your agent becomes a dedicated bartender that knows the history and composition of classic and modern drinks alike. It handles everything from finding a simple margarita to identifying the specific properties of rare spirits. Whether you're looking for a quick drink idea or building a complex beverage menu, the data is always accurate and organized. You can explore the world of mixology without the headache of manual research. This connection ensures your agent provides consistent, high-quality information every time you ask for a drink recommendation or a detailed recipe. This includes access to thousands of entries, making it a go-to resource for anyone who wants to move beyond basic recipes into professional-grade mixology. ## Tools ### list_ingredients Get a master list of all ingredients. Use this to see what the agent can search for. ### filter_by_alcoholic This tool checks if a drink contains alcohol or not. It makes it easy to find mocktails or hard seltzers in one go. ### filter_by_category Use this to sort drinks by types like Ordinary or Shot. It helps you find the right vibe for your occasion. ### filter_by_glass This allows you to find drinks served in specific glassware. It's perfect for when you only have certain glasses on hand. ### filter_by_ingredient Search for drinks that feature a specific main ingredient. It's great for using up what's in your pantry. ### filter_by_multi_ingredient Find drinks containing several specific ingredients. You'll need a premium key for this advanced filtering. ### get_cocktail_by_id Pull every detail for a specific drink using its unique ID. This is perfect for deep dives into single recipes. ### get_ingredient_by_id Get the full profile of an ingredient from its ID. Use this to learn more about specific spirits or fruits. ### get_latest_cocktails See what's new in the mixology world. This requires a premium key to access the most recent additions. ### get_popular_cocktails Find the most-ordered drinks globally. This also requires a premium key to see what's trending. ### get_random_selection Pull a list of 10 random drinks at once. This requires a premium key for your agent to browse. ### list_alcoholic_filters See all available categories for alcohol content. This helps your agent understand the filtering options. ### list_categories Get a full list of cocktail categories. Use this to see what types of drinks are in the database. ### list_glasses See every type of glassware in the database. This helps you know what glasses you can filter by. ### search_cocktail_by_first_letter Find drinks starting with a specific letter. It's a quick way to browse the database alphabetically. ### search_cocktail_by_name Look up a specific drink by its common name. This is the most direct way to get a recipe. ### search_ingredient_by_name Find details on a specific ingredient by name. Use this to check properties of various spirits or mixers. ### get_random_cocktail Get a completely random drink idea. It's the perfect choose for me button for your agent. ## Prompt Examples **Prompt:** ``` I have gin and elderflower. What can I make? ``` **Response:** ``` Based on the ingredients you have, here are a few drink options: | Drink Name | Key Ingredients | Style | | :--- | :--- | :--- | | **Elderflower Gin Fizz** | Gin, Elderflower, Club Soda | Refreshing | | **Gin & Tonic Garden** | Gin, Tonic, Cucumber, Mint | Classic | Would you like the full recipe for the Elderflower Gin Fizz? ``` **Prompt:** ``` Give me a list of popular drinks for a summer party. ``` **Response:** ``` Here are some of the most popular drinks for a summer theme: * **Mojito** (Refreshing and classic) * **Margarita** (Great for groups) * **Paloma** (A popular tequila-based choice) I can pull the specific recipes for any of these for you. ``` **Prompt:** ``` What are the ingredients in a classic Old Fashioned? ``` **Response:** ``` A classic **Old Fashioned** typically includes: * **Spirit:** Bourbon or Rye Whiskey * **Sweetener:** Sugar cube or simple syrup * **Bitters:** Angostura bitters * **Garnish:** Orange peel and a cherry Would you like to see the full preparation instructions? ``` ## Capabilities ### Search for specific cocktails by name Your agent can pull full recipes and details for any drink in the database. ### Pull detailed data on individual ingredients Get specific properties and details for any spirit, fruit, or mixer. ### Filter drinks by glass type or category Narrow down choices based on the glassware you have or the style of drink you want. ### Find non-alcoholic drink options Easily identify mocktails and other alcohol-free beverages. ### Get random drink suggestions Let your agent pick a random cocktail when you need a new idea. ### Access popular and new cocktail trends See what drinks are currently trending or were recently added to the database. ## Use Cases ### Pantry search for home drinks A user has limes and tequila and asks for a drink. The agent finds a recipe using those specific ingredients from the database. ### Planning a mocktail party A host wants 5 non-alcoholic drinks for a gathering. The agent filters the database for mocktails and serves up the list. ### Researching global trends A bartender wants to know what's popular. The agent pulls a list of the most-ordered drinks globally to inform the menu. ### Building a tropical menu A cafe owner wants a tropical theme. The agent suggests drinks based on specific categories and ingredients from the database. ## Benefits - Your agent pulls recipes directly from the database. This ensures every measurement is accurate and stops the AI from making up fake ingredients. - Use pantry-based searching to see what you can make with what you already have. It turns your agent into a smart kitchen assistant. - Get exact glassware and category info for every drink. This ensures the suggestions your agent gives actually fit your home bar setup. - Stay current with modern mixology trends. You can see what's popular globally without doing any manual research. - Break out of a recipe rut instantly. Your agent can provide fresh, random drink ideas whenever you feel uninspired. - Get structured data for beverage projects. This makes building drink-related apps or menus much faster and more reliable. ## How It Works The bottom line is you get a reliable mixology database without the manual research. 1. Subscribe to the Connector in the Vinkius catalog. 2. Provide your TheCocktailDB API key (you can use '1' for the free test tier). 3. Ask your agent for recipes, drink ideas, or ingredient details. ## Frequently Asked Questions **Can TheCocktailDB MCP find mocktails?** Yes, it can. You can ask your agent to filter for non-alcoholic options to find a wide variety of mocktails and alcohol-free drinks. **How does TheCocktailDB MCP help with home bartending?** It acts like a digital bartender. You can ask for recipes based on what you have in your fridge or find specific drinks by category. **Can I use TheCocktailDB MCP to find drinks with specific ingredients?** Absolutely. You can tell your agent to find drinks that feature a specific ingredient like tequila, lime, or even more unique mixers. **Does TheCocktailDB MCP include glassware types?** Yes, it does. The database includes information on the specific glass types used for various drinks, so you know exactly what you need. **Can TheCocktailDB MCP help me build a drink app?** Yes, it's great for developers. It provides structured drink data that can be used to populate your own beverage-related applications. **Can I find non-alcoholic drink recipes using this server?** Yes! You can use the `filter_by_alcoholic` tool with the status 'Non_Alcoholic' to retrieve a list of mocktails and non-alcoholic beverages. **How can I get a random cocktail suggestion for inspiration?** Simply use the `get_random_cocktail` tool. It will return full details, including ingredients and instructions, for one randomly selected drink from the database. **Is it possible to search for cocktails by a specific ingredient like Gin or Vodka?** Absolutely. Use the `filter_by_ingredient` tool and provide the name of the ingredient to see all cocktails that include it in their recipe.