4,500+ servers built on MCP Fusion
Vinkius

TheCocktailDB Extended MCP. Filter recipes using ingredients, categories, or glass types.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

TheCocktailDB Extended MCP on Cursor AI Code Editor MCP Client TheCocktailDB Extended MCP on Claude Desktop App MCP Integration TheCocktailDB Extended MCP on OpenAI Agents SDK MCP Compatible TheCocktailDB Extended MCP on Visual Studio Code MCP Extension Client TheCocktailDB Extended MCP on GitHub Copilot AI Agent MCP Integration TheCocktailDB Extended MCP on Google Gemini AI MCP Integration TheCocktailDB Extended MCP on Lovable AI Development MCP Client TheCocktailDB Extended MCP on Mistral AI Agents MCP Compatible TheCocktailDB Extended MCP on Amazon AWS Bedrock MCP Support

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.

+ 15 more capabilities included
Filter by alcohol status

Limits cocktail results to alcoholic, non-alcoholic, or optional drinks using filter_by_alcoholic.

Search recipes by name

Finds a specific cocktail recipe when you know the exact title with search_cocktail_by_name.

Filter by ingredient

Narrows down cocktails to only those containing one specified item, like lime juice, using filter_by_ingredient.

Find popular or random drinks

Retrieves curated lists of the most popular cocktails (get_popular_cocktails) or just gives you a single surprise recipe via get_random_cocktail.

Get full drink details by ID

Looks up every detail for one specific cocktail using its unique identifier with get_cocktail_by_id.

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

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.

filter019e5d5e

filter by alcoholic

Narrows down cocktail results based on whether they contain alcohol or not.

filter019e5d5e

filter by category

Filters the database to show only drinks belonging to a specific type, like 'Tropical' or 'Sour'.

filter019e5d5e

filter by glass

Limits results to cocktails served in a particular glass shape, such as a coupe or martini glass.

filter019e5d5e

filter by ingredient

Filters the list to show only drinks that contain one specific ingredient by name.

filter019e5d5e

filter by multi ingredient

Requires Premium access. Filters cocktails based on a combination of multiple ingredients you specify.

get019e5d5e

get cocktail by id

Retrieves the full recipe and details for any single cocktail when given its unique database ID.

get019e5d5e

get ingredient by id

Looks up complete information on a specific ingredient using its unique identifier.

get019e5d5e

get latest cocktails

Requires Premium access. Lists the most recently added cocktails to the database.

get019e5d5e

get popular cocktails

Requires Premium access. Returns a list of the most commonly requested or popular drinks.

get019e5d5e

get random cocktail

Fetches and returns details for one random cocktail recipe from the entire database.

get019e5d5e

get random selection

Requires Premium access. Fetches a selection of 10 random cocktails to give you variety.

list019e5d5e

list alcoholic filters

Lists all available statuses for filtering by alcohol content in the database.

list019e5d5e

list categories

Shows a list of every cocktail category defined in the database.

list019e5d5e

list glasses

Returns all available glass types so you know what to filter by when searching for presentation style.

list019e5d5e

list ingredients

Lists every ingredient known in the database, helping you see what's even searchable.

search019e5d5e

search cocktail by first letter

Returns a list of all cocktails that start with a specific letter of the alphabet.

search019e5d5e

search cocktail by name

Searches for and finds cocktail recipes using a known or partial name string.

search019e5d5e

search 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
Start building

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. 1 First, you ask your agent to perform a search. For instance, 'Find me cocktails that use tequila and are non-alcoholic.'
  2. 2 The server executes multiple tools: it uses filter_by_alcoholic for the status and then runs filter_by_multi_ingredient (if available) or successive single filters.
  3. 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.

Home Bartender

Needs instant recipes based only on the ingredients they have sitting in their pantry right now.

Food & Beverage Developer

Uses structured data to test ingredient relationships and build logic for a new digital menu or cocktail recommendation app.

Mixology Student/Enthusiast

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_ingredient with 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_id to 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 use list_categories to 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

01

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.

02

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.

03

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.

04

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

How we secure it →

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

filter_by_alcoholic filter_by_category filter_by_glass filter_by_ingredient filter_by_multi_ingredient get_cocktail_by_id get_ingredient_by_id get_latest_cocktails get_popular_cocktails get_random_cocktail get_random_selection list_alcoholic_filters list_categories list_glasses list_ingredients search_cocktail_by_first_letter search_cocktail_by_name search_ingredient_by_name

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.

You might also like

Built & Managed by Vinkius 30s setup 18 tools

We've already built the connector for TheCocktailDB Extended. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 18 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.