TheCocktailDB Extended MCP. Filter recipes using ingredients, categories, or glass types.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
TheCocktailDB Extended provides a deep connection to cocktail recipes and ingredients. Your agent can search for drinks by name, filter results by alcohol content or glass type, and look up specific ingredient properties.
It handles complex filtering across multiple criteria, letting you find the perfect drink recipe instantly.
What your AI agents can do
Filter by alcoholic
Narrows down cocktail results based on whether they contain alcohol or not.
Filter by category
Filters the database to show only drinks belonging to a specific type, like 'Tropical' or 'Sour'.
Filter by glass
Limits results to cocktails served in a particular glass shape, such as a coupe or martini glass.
Limits cocktail results to alcoholic, non-alcoholic, or optional drinks using filter_by_alcoholic.
Finds a specific cocktail recipe when you know the exact title with search_cocktail_by_name.
Narrows down cocktails to only those containing one specified item, like lime juice, using filter_by_ingredient.
Retrieves curated lists of the most popular cocktails (get_popular_cocktails) or just gives you a single surprise recipe via get_random_cocktail.
Looks up every detail for one specific cocktail using its unique identifier with get_cocktail_by_id.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
TheCocktailDB Extended: 18 Tools for Mixology Data
These tools let your AI client perform granular actions on cocktail recipes, allowing you to search, filter, and analyze ingredients using structured calls.
019e5d5efilter by alcoholic
Narrows down cocktail results based on whether they contain alcohol or not.
019e5d5efilter by category
Filters the database to show only drinks belonging to a specific type, like 'Tropical' or 'Sour'.
019e5d5efilter by glass
Limits results to cocktails served in a particular glass shape, such as a coupe or martini glass.
019e5d5efilter by ingredient
Filters the list to show only drinks that contain one specific ingredient by name.
019e5d5efilter by multi ingredient
Requires Premium access. Filters cocktails based on a combination of multiple ingredients you specify.
019e5d5eget cocktail by id
Retrieves the full recipe and details for any single cocktail when given its unique database ID.
019e5d5eget ingredient by id
Looks up complete information on a specific ingredient using its unique identifier.
019e5d5eget latest cocktails
Requires Premium access. Lists the most recently added cocktails to the database.
019e5d5eget popular cocktails
Requires Premium access. Returns a list of the most commonly requested or popular drinks.
019e5d5eget random cocktail
Fetches and returns details for one random cocktail recipe from the entire database.
019e5d5eget random selection
Requires Premium access. Fetches a selection of 10 random cocktails to give you variety.
019e5d5elist alcoholic filters
Lists all available statuses for filtering by alcohol content in the database.
019e5d5elist categories
Shows a list of every cocktail category defined in the database.
019e5d5elist glasses
Returns all available glass types so you know what to filter by when searching for presentation style.
019e5d5elist ingredients
Lists every ingredient known in the database, helping you see what's even searchable.
019e5d5esearch cocktail by first letter
Returns a list of all cocktails that start with a specific letter of the alphabet.
019e5d5esearch cocktail by name
Searches for and finds cocktail recipes using a known or partial name string.
019e5d5esearch ingredient by name
Finds details about an ingredient by searching its common name in the database.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with TheCocktailDB Extended, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This server connects your agent directly to a massive cocktail database. It makes your AI client an instant mixology expert, handling thousands of recipes and complex ingredient lookups.
When you need to find drinks, you've got several ways to start the search. You can use search_cocktail_by_name to pull up recipes when you know even a partial name. If you just remember the first letter, run search_cocktail_by_first_letter for a list of all cocktails starting with that alphabet character. To figure out what ingredients are available in the system, use list_ingredients, which gives you every known ingredient name.
You can also check details on any specific component using search_ingredient_by_name, pulling up info by its common name, or if you have a unique ID, get_ingredient_by_id provides all the deep data you need.
The filtering capabilities are where this server really shines. It lets you narrow down choices with precision. You can limit results to specific presentation styles using filter_by_glass, which accepts input from list_glasses to show every available glass type. Similarly, if a drink has a certain profile—like 'Tropical' or 'Sour'—you filter by that type using filter_by_category, pulling the valid options list via list_categories.
For filtering based on alcohol content, you use filter_by_alcoholic to narrow results down to alcoholic, non-alcoholic, or optional drinks; you can see all available statuses by running list_alcoholic_filters. If you know one ingredient that has to be in the drink, run filter_by_ingredient for a quick cut. For maximum specificity, and if you've got Premium access, use filter_by_multi_ingredient, which requires a combination of multiple ingredients you specify.
For deeper data retrieval, your agent can pull all the details on one single beverage using its unique ID via get_cocktail_by_id. You don't need to guess; if you know what it is, you get everything. To find inspiration or just want a surprise drink, you have options: run get_random_cocktail for one random recipe from the entire database, or check out the most commonly requested drinks with get_popular_cocktails.
If you've got Premium access, you can also request ten different variety picks using get_random_selection, and see what came in today by calling get_latest_cocktails.
If you need a full picture of the filtering options available, use list_categories to show all defined types, or run list_glasses to list every glass type for your search. The tools handle complex queries so you just tell them what you want—for example, combining filter_by_alcoholic and filter_by_glass lets you instantly see a precise set of matching cocktails.
How TheCocktailDB Extended MCP Works
- 1 First, you ask your agent to perform a search. For instance, 'Find me cocktails that use tequila and are non-alcoholic.'
- 2 The server executes multiple tools: it uses
filter_by_alcoholicfor the status and then runsfilter_by_multi_ingredient(if available) or successive single filters. - 3 Your agent gets back a precise, filtered list of cocktails that match all criteria. You can then request full details for any result using
get_cocktail_by_id.
The bottom line is: you tell the AI what you want, and it runs the specific combination of tools needed to find the exact recipe in the database.
Who Is TheCocktailDB Extended MCP For?
Anyone who needs detailed product knowledge—from a home bartender planning a party to an app developer needing reliable data for a drinks app. If you struggle with manual research or need accurate ingredient relationships, this is for you.
Needs instant recipes based only on the ingredients they have sitting in their pantry right now.
Uses structured data to test ingredient relationships and build logic for a new digital menu or cocktail recommendation app.
Wants to explore the history, composition, and variations of classic drinks without reading disorganized blogs.
What Changes When You Connect
- Eliminate guesswork when hosting. Instead of guessing what works, you can ask your agent to use
filter_by_ingredientwith the three unique things you have on hand (e.g., 'rum', 'pineapple', 'lime'). It instantly pulls a recipe that uses exactly those components. - Build faster apps by treating data as code. Developers bypass manual database queries; they just call tools like
get_cocktail_by_idto get complete JSON objects for testing the entire cocktail lifecycle directly from their IDE. - Never settle for an incomplete search again. You can combine filters—like asking for non-alcoholic drinks (
filter_by_alcoholic) that are also in a specific category (filter_by_category) and served in a particular glass type (filter_by_glass). - Quickly check the market trends. Use
get_popular_cocktails(Premium) to see what's trending, or uselist_categoriesto find niche types you never knew existed. - Speed up research dramatically. Instead of jumping through dozens of recipe blogs, your agent runs a single tool call like
search_cocktail_by_name('Mojito'), and the full, structured data comes right back.
Real-World Use Cases
The 'I have nothing' party scenario
You walk into a kitchen with only whiskey, bitters, and lemon juice. Instead of panicking, you ask your agent: 'What can I make with these ingredients?' The agent uses filter_by_ingredient for each item to find recipes that contain the required combination, solving the menu crisis instantly.
The developer needs a dataset
A backend engineer needs 50 unique drinks for testing. They use get_random_selection (Premium) in their workflow to pull a diverse batch of cocktail data, validating ingredient relationships and IDs without needing to manually build a complex SQL query.
The themed party planner
You're planning an 'Italian Riviera' night. You ask your agent to find all cocktails that are both in the 'Italian' category (filter_by_category) AND served in a specific type of glass (filter_by_glass), guaranteeing theme consistency.
Checking ingredient availability
A restaurant needs to know if they can serve any cocktail using only the ingredients currently stocked. They first run list_ingredients and then use search_ingredient_by_name on their current stock list, ensuring zero waste.
The Tradeoffs
Treating it like a general search bar
Just typing 'cocktail' and expecting the AI to magically know which filters to apply.
→
Don't rely on vague input. Be specific. If you need a certain type of drink, start by listing potential constraints: 'Use filter_by_category for 'Sour', then use filter_by_alcoholic.' This guides the agent precisely.
Overlooking premium tools
Trying to find a wide variety of drinks by calling get_random_cocktail repeatedly, which is slow and unrepresentative.
→
If you need diversity or popular options, use the specialized endpoint: call get_random_selection (Premium) for 10 results, or get_popular_cocktails to see what's trending.
Skipping ingredient checks
Assuming a recipe works because it looks good on paper, but forgetting that the required ingredient might be listed as 'Lime Juice' and not just 'lime'.
→
Always verify ingredients first. Run search_ingredient_by_name('lime juice') to confirm the exact spelling and ID needed for filtering tools like filter_by_ingredient.
When It Fits, When It Doesn't
Use this server if your goal is structured data retrieval: you need concrete lists, defined properties (alcohol content, glass type), or ingredient relationships. Use it when you're building logic—like a recommendation engine or inventory checker.
Don't use this if you just want casual browsing inspiration. If you simply want to see 'what I could drink right now,' starting with get_random_cocktail is fine, but for serious work, start by listing your constraints first. For example, if you only have a bar cart full of specific items, don't search by name; instead, run list_ingredients and then use those results to drive the filter_by_multi_ingredient tool. If you are building an app that needs type safety for inputs, make sure your agent uses get_cocktail_by_id first, so it gets a verifiable ID before trying any complex filtering.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TheCocktailDB. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 18 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Finding the perfect drink shouldn't feel like cross-referencing three separate databases.
Today, if you want to know what drinks work for your party, you open Google. You find a recipe blog, which gives ingredients. Then you open another tab to check if those ingredients are even available in a store. Finally, you cross-reference the recipe's instructions with a glass type guide just to make sure it looks right. It takes five tabs and minimum three copy/pastes.
With this server, your agent handles the whole process. You tell it: 'I need a cocktail that uses Tequila, is alcoholic, and fits in a Coupe glass.' The agent runs `filter_by_ingredient` for tequila, then checks `list_alcoholic_filters` to confirm status, and finally uses `filter_by_glass`—all in one go. It gives you the final, perfect list.
TheCocktailDB Extended MCP Server: Get structured drink data using filters.
Manual research requires remembering that 'Sour' is a category, but 'Margarita' is a name. You have to juggle `search_cocktail_by_name` and `filter_by_category` separately. If you forget one step, the whole search fails, forcing you back to the start.
Now, your agent manages that complexity. It knows when to run `list_categories` first to confirm valid types, then uses those confirmed values inside a single filtering call. The data flow is clean and predictable—it just works.
Common Questions About TheCocktailDB Extended MCP
How do I find drinks that use multiple ingredients? (filter_by_multi_ingredient) +
You must use the filter_by_multi_ingredient tool. This requires a Premium API key, but it lets your agent check for combinations of several items at once, which single filters can't do.
What is the difference between searching by name and filtering? (search_cocktail_by_name vs filter_by_category) +
Use search_cocktail_by_name when you know the title, like 'Mojito.' Use filter_by_category when you only know the style, like 'Tropical,' and want to see all potential candidates.
Can I list every ingredient in the database? (list_ingredients) +
Yes, running list_ingredients returns a full inventory of all known ingredients. This is useful for checking if an obscure item you have on hand is even recognized by the system.
How do I find popular drinks? (get_popular_cocktails) +
You need to call get_popular_cocktails. Remember, this tool requires a Premium API key. It gives you the current best-sellers so you don't have to guess.
What is the most reliable way to check details for one drink? (get_cocktail_by_id) +
The most direct method is using get_cocktail_by_id. If you already know the unique ID, this tool pulls every single piece of data—ingredients, glass type, etc.—without any guesswork.
If I want to use advanced filtering like `filter_by_multi_ingredient`, how do I check my API key status? +
You must verify your subscription tier and API key validity before calling this tool. If you hit a limit or need premium features, the server will return an explicit rate-limit error. Check our documentation for upgrade options.
Before I use `filter_by_category`, how can I see all available cocktail types? +
Use the list_categories tool first. This provides a comprehensive list of every filter option you can apply. It's best practice to run this before building complex queries.
I don't know what drink I want. Can I use `get_random_cocktail` for inspiration? +
Yes, that's exactly what it's for. Calling get_random_cocktail fetches a complete recipe instantly without needing any input parameters or filters.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Steam Platform & Hype Intelligence
The definitive server for Steam platform insights — track trending games, player counts, and social connections via AI.
Artsy
Global art database — search artists, artworks, and shows via AI.
IMDB API (Unofficial)
Search movies and TV shows — audit ratings, cast, and metadata via IA.
You might also like
Gupshup Messaging
Send WhatsApp messages, templates, media, and reactions via Gupshup API.
Authorize.net
Manage payments, transactions, and customer profiles via Authorize.net — the trusted payment gateway directly via AI.
Pics.io
Organize and share creative assets with a digital asset management platform that tags, searches, and delivers files fast.