Vinkius
TheCocktailDB Extended

TheCocktailDB Extended MCP for AI. 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 MCP on Cursor AI Code EditorTheCocktailDB MCP on Claude Desktop AppTheCocktailDB MCP on OpenAI Agents SDKTheCocktailDB MCP on Visual Studio CodeTheCocktailDB MCP on GitHub Copilot AI AgentTheCocktailDB MCP on Google Gemini AITheCocktailDB MCP on Lovable AI DevelopmentTheCocktailDB MCP on Mistral AI AgentsTheCocktailDB MCP on Amazon AWS Bedrock

How this MCP server connects to your AI agent

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 AI agents can do with TheCocktailDB Automation

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.

Included with Plan

Waiting for input…

AI Agent

What AI agents can do with 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.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using TheCocktailDB on Vinkius

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...

Filter By Glass

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

Filter By Ingredient

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

Filter By Multi Ingredient

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

Get Cocktail By Id

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

Get Ingredient By Id

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

Get Latest Cocktails

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

Get Popular Cocktails

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

Get Random Cocktail

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

Get Random Selection

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

List Alcoholic Filters

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

List Categories

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

List Glasses

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

List Ingredients

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

Search Cocktail By First Letter

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

Search Cocktail By Name

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

Search Ingredient By Name

Finds details about an ingredient by searching its common name in the database.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The TheCocktailDB Extended integration is available immediately — no restart needed.

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, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,100+ 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
TheCocktailDB Extended MCP server cover

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

Your data is protected. See how we built it.

Built on the Model Context Protocol (MCP) for 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 connection provides 18 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Finding the perfect drink shouldn't feel like cross-referencing three separate databases., Solved with Vinkius AI Gateway

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.

What your AI can actually do with this

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.

Built · Hosted · Managed by Vinkius CocktailDB Extended MCP Server - Filter Recipes & Ingredients
Server ID 019e5d5e-dbba-7396-be59-7311cee1f31d
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

Questions you might have

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.

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.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on 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.