TheCocktailDB Connector for AI agents.
5 live capabilities
Find authentic cocktail recipes and mixology instructions instantly.
Waiting for input…
Why people use TheCocktailDB
TheCocktailDB for Mixology and Hospitality Apps
This Connector fixes that by giving your agent a direct connection to a massive library of 600+ recipes. Instead of scraping, your agent just asks for the data it needs. You get a clean, consistent set of instructions for every drink instantly.
What Vinkius changes
You get instant access to a professional-grade cocktail database without any manual data entry.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding drinks with specific ingredients
A user asks, 'I have a bottle of Gin and some lime; what can I make?
- Real-world use case 02
Building a drink discovery app
A developer needs a list of common shots for a new UI.
- Real-world use case 03
Learning a classic recipe
A home bartender asks, 'How do I make a proper Old Fashioned?
Complete set · 5capabilities
The complete TheCocktailDB capability set.
These are the exact actions your AI can choose when you ask it to work with TheCocktailDB.
01—03
3 capabilities in this set.
Part of 5 available through TheCocktailDB.
- 01 Capability
Browse cocktail category
See what's available in categories like shots, coffee, or party drinks.
- 02 Capability
Search cocktails
Search for a specific drink by name to get its full preparation guide.
- 03 Capability
Find cocktails by ingredient
Find every drink that features a specific spirit like Tequila or Bourbon.
04—05
2 capabilities in this set.
Part of 5 available through TheCocktailDB.
- 04 Capability
Get cocktail details
Pull the full recipe, measurements, and instructions for a specific drink ID.
- 05 Capability
Get random cocktail
Get a surprise drink recommendation when you don't know what to mix.
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_p4KWEqA8nKxMDD4zgZIgVrDMgddGP19RBIC03CT4/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_p4KWEqA8nKxMDD4zgZIgVrDMgddGP19RBIC03CT4/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": {
"url": "https://edge.vinkius.com/vk_preview_p4KWEqA8nKxMDD4zgZIgVrDMgddGP19RBIC03CT4/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...". 5 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"thecocktaildb": {
"url": "https://edge.vinkius.com/vk_preview_p4KWEqA8nKxMDD4zgZIgVrDMgddGP19RBIC03CT4/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...". 5 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"thecocktaildb": {
"url": "https://edge.vinkius.com/vk_preview_p4KWEqA8nKxMDD4zgZIgVrDMgddGP19RBIC03CT4/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...". 5 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"thecocktaildb": {
"url": "https://edge.vinkius.com/vk_preview_p4KWEqA8nKxMDD4zgZIgVrDMgddGP19RBIC03CT4/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...". 5 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add thecocktaildb --transport http "https://edge.vinkius.com/vk_preview_p4KWEqA8nKxMDD4zgZIgVrDMgddGP19RBIC03CT4/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...". 5 tools are ready
Where the request belongs
Work TheCocktailDB can move forward.
This is for hospitality app developers needing reliable drink data, bartenders seeking quick drink specs, and home mixology fans who want to learn proper techniques.
Hospitality App Developer
Building a drink discovery feature that needs reliable data.
Bartender
Looking for quick drink specs during a busy shift.
Home Mixology Enthusiast
Learning proper techniques and glass pairings.
Content Creator
Writing drink menus that need accurate measurements.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsTheCocktailDB
Global cocktail database. search recipes, ingredients, and mixology guides via AI.
CocktailFyi
Explore cocktails, ingredients, and bartending techniques. get recipes and guides via AI.
Cocktail API
Search cocktail recipes. audit ingredients and instructions 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 MCP help me build a bar app?
Yes, it provides a structured way to pull drink data for your app's menu or search features.
Does TheCocktailDB MCP include mixing instructions?
Yes, every recipe includes step-by-step instructions and exact measurements.
Can I use TheCocktailDB MCP to find drinks with specific spirits?
You can ask your agent to find any drink containing ingredients like Gin, Rum, or Whiskey.
Will TheCocktailDB MCP tell me what glass to use?
Yes, the recipes include the correct glassware for an authentic presentation.
Can I get random drink ideas with TheCocktailDB MCP?
You can ask your agent for a random recommendation whenever you need some inspiration.
Is there a limit to the recipes in TheCocktailDB MCP?
It provides access to over 600 recipes from around the world.
Do I need an API key?
No. TheCocktailDB provides free open access. No registration or API key required.
Are measurements standardized across all recipes?
Measurements on TheCocktailDB typically default to imperial measurements (oz, parts, dashes). They match exactly what the database provides.
Can I search for non-alcoholic mocktails?
Definitely! The DB maintains a 'Non-Alcoholic' category you can filter by when asking for a refreshing drink with zero ABV.
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