TheCocktailDB Connector for AI agents.
12 live capabilities
Get professional mixology recipes and drink data instantly.
Waiting for input…
Why people use TheCocktailDB
TheCocktailDB Mixology Database for Accurate Drink Recipes
This Connector lets your agent do the digging for you. It pulls the exact specs, images, and instructions from a massive database in one go. You just ask for what you want and get the facts immediately.
What Vinkius changes
Your AI gets instant access to a professional mixology database for real-time drink creation.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Creating a non-alcoholic party menu
A host asks their agent to find drinks for a guest who doesn't drink.
- Real-world use case 02
Finding the right glassware
A bartender needs to know the correct glass for a rare cocktail.
- Real-world use case 03
Building a themed social media feed
A creator wants a Tequila-themed menu.
Complete set · 12capabilities
The complete TheCocktailDB capability set.
These are the exact actions your AI can choose when you ask it to work with TheCocktailDB.
01—04
4 capabilities in this set.
Part of 12 available through TheCocktailDB.
- 01 Capability
Filter by category
Filter cocktails by specific categories like Ordinary Drink or Cocktail. This helps you quickly find a certain style of drink.
- 02 Capability
Filter by ingredient
Find drinks that contain a specific ingredient you have on hand. This is perfect for when you want to use up what's in your cabinet.
- 03 Capability
List alcoholic filters
See the available options for filtering drinks by alcohol content. This lets you choose between alcoholic and non-alcoholic choices.
- 04 Capability
List categories
Get a full list of all drink categories in the database. You can use this to see the breadth of the mixology library.
05—08
4 capabilities in this set.
Part of 12 available through TheCocktailDB.
- 05 Capability
List glasses
See a list of different glassware types for various drinks. This helps you figure out the right presentation for your cocktails.
- 06 Capability
List ingredients
Pull a complete list of all ingredients available in the database. Use this to see every possible component in the library.
- 07 Capability
Get cocktail details
Retrieve full instructions and image links for a specific cocktail ID. This gives you everything you need to make the drink perfectly.
- 08 Capability
Get ingredient details
Get the specific metadata and details for a single ingredient. This is useful for understanding the properties of a specific spirit or fruit.
09—12
4 capabilities in this set.
Part of 12 available through TheCocktailDB.
- 09 Capability
Get random cocktail
Ask for a completely random drink recipe to find new inspiration. Use this when you want to try something different and unexpected.
- 10 Capability
Search ingredient by name
Look up an ingredient by its name to see if it's in the database. This helps you verify what components your agent can access.
- 11 Capability
Search cocktail by first letter
Find drinks by their starting letter when you're browsing. This is a quick way to navigate the database alphabetically.
- 12 Capability
Search cocktail by name
Search for a specific cocktail by its full name. Use this to get the exact recipe for a well-known classic.
Set up in minutes
One URL. Then ask TheCocktailDB to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TheCocktailDB from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_mkEg9UMG9ZayNQrhmpLLWTzbhpaf39ILSENxkk48/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it TheCocktailDB, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable TheCocktailDB for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_mkEg9UMG9ZayNQrhmpLLWTzbhpaf39ILSENxkk48/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the TheCocktailDB URL.
- Step 03
Save and start
Save the connection and enable TheCocktailDB in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"thecocktaildb-alternative": {
"url": "https://edge.vinkius.com/vk_preview_mkEg9UMG9ZayNQrhmpLLWTzbhpaf39ILSENxkk48/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using TheCocktailDB
Open Agent mode in chat and ask: "Using TheCocktailDB, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"thecocktaildb-alternative": {
"url": "https://edge.vinkius.com/vk_preview_mkEg9UMG9ZayNQrhmpLLWTzbhpaf39ILSENxkk48/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using TheCocktailDB
Ask Copilot: "Using TheCocktailDB, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"thecocktaildb-alternative": {
"url": "https://edge.vinkius.com/vk_preview_mkEg9UMG9ZayNQrhmpLLWTzbhpaf39ILSENxkk48/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using TheCocktailDB
Open Cascade and ask: "Using TheCocktailDB, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"thecocktaildb-alternative": {
"url": "https://edge.vinkius.com/vk_preview_mkEg9UMG9ZayNQrhmpLLWTzbhpaf39ILSENxkk48/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using TheCocktailDB
Ask Cline: "Using TheCocktailDB, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add thecocktaildb-alternative --transport http "https://edge.vinkius.com/vk_preview_mkEg9UMG9ZayNQrhmpLLWTzbhpaf39ILSENxkk48/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using TheCocktailDB
Ask Claude: "Using TheCocktailDB, show me...". 12 tools are ready
Where the request belongs
Work TheCocktailDB can move forward.
This is for the bartender who needs to recall ratios under pressure, the home enthusiast who wants to use what's in their fridge, and the content creator who needs accurate data for drink menus.
Bartenders & Mixologists
They use this to instantly pull exact measurements and ratios for thousands of drinks during a busy shift.
Home Enthusiasts
They use it to discover new recipes based on the specific ingredients they have in their home cabinet.
Content Creators
They use it to automate the retrieval of high-quality drink images and recipe data for social media production.
Party Organizers
They use it to quickly compile themed drink lists by filtering for categories or alcohol content.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsTheCocktailDB
Access a massive database of cocktail recipes and ingredients. search by name, filter by alcohol content, and discover new drinks.
Cocktail API
Search cocktail recipes. audit ingredients and instructions via AI.
CocktailFyi
Explore cocktails, ingredients, and bartending techniques. get recipes and guides via AI.
Punk
Explore the BrewDog beer catalog. search by ingredients, food pairings, and technical specs like ABV or IBU.
PunkAPI
Explore BrewDog's beer catalog. search by name, style, ABV, IBU, hops, food pairing and get random beer suggestions.
NotCo
Interact with Giuseppe AI, NotCo's proprietary plant-based formulation engine, to analyze ingredients, match flavor profiles, and generate recipes.
Bring your own AI
Change the model, client or framework. Keep TheCocktailDB connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about TheCocktailDB.
The practical details behind the request, access and result.
Can TheCocktailDB find non-alcoholic drinks?
Yes, it can. You can ask your agent to filter for non-alcoholic options, which allows you to find a wide variety of mocktails and other beverages.
Does TheCocktailDB include images for the recipes?
Yes, it provides high-quality image links for the drinks in the database, making it easy to see what the final result should look like.
Can I use TheCocktailDB to build a professional drink menu?
Absolutely. You can use it to pull data for dozens of drinks at once, including categories and glass types, to build a complete menu quickly.
Can TheCocktailDB help me with specific ingredients?
Yes, it can find every drink that uses a specific ingredient. This is great for seeing what you can make with the supplies you already have.
Is TheCocktailDB good for professional bartenders?
Yes, it is designed to provide exact measurements and ratios, which is essential for professional mixology and consistent drink quality.
Can I search for cocktails that only contain a specific ingredient like Gin?
Yes! Use the filter_by_ingredient capability with 'Gin'. It will return a list of all cocktails in the database that include Gin as one of their primary components.
How do I get the full instructions and image for a specific drink?
First, find the drink ID using search_cocktail_by_name. Then, use the get_cocktail_details capability with that ID to retrieve the high-res image URL, full ingredient list, and step-by-step instructions.
Does the integration provide non-alcoholic drink options?
Absolutely. You can use the list_alcoholic_filters capability to see available filters, and then use filter_by_category or specific search queries to identify 'Non_Alcoholic' drinks.
One connection away
Give your agent a direct line to TheCocktailDB.
Connect TheCocktailDB once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available