TheCocktailDB Connector for AI agents.

18 live capabilities

Find and filter thousands of cocktail recipes and drink ingredients.

Live agent request TheCocktailDB / Connector

Waiting for input…

AI Agent

Why people use TheCocktailDB

TheCocktailDB for Real-Time Mixology Data

This Connector changes that by giving your AI client direct access to a massive, structured database. Your agent pulls the exact specs instantly, giving you a clear, consistent recipe every time.

What Vinkius changes

You get a reliable mixology database without the manual research.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Pantry search for home drinks

A user has limes and tequila and asks for a drink.
Real-world use case 02

Planning a mocktail party

A host wants 5 non-alcoholic drinks for a gathering.
Real-world use case 03

Researching global trends

A bartender wants to know what's popular.

Complete set · 18capabilities

The complete TheCocktailDB capability set.

These are the exact actions your AI can choose when you ask it to work with TheCocktailDB.

Capability set01 / 05

01—04

4 capabilities in this set.

Part of 18 available through TheCocktailDB.

01 Capability
List ingredients
Get a master list of all ingredients. Use this to see what the agent can search for.
02 Capability
Filter by alcoholic
This capability checks if a drink contains alcohol or not. It makes it easy to find mocktails or hard seltzers in one go.
03 Capability
Filter by category
Use this to sort drinks by types like Ordinary or Shot. It helps you find the right vibe for your occasion.
04 Capability
Filter by glass
This allows you to find drinks served in specific glassware. It's perfect for when you only have certain glasses on hand.

Capability set02 / 05

05—08

4 capabilities in this set.

Part of 18 available through TheCocktailDB.

05 Capability
Filter by ingredient
Search for drinks that feature a specific main ingredient. It's great for using up what's in your pantry.
06 Capability
Filter by multi ingredient
Find drinks containing several specific ingredients. You'll need a premium key for this advanced filtering.
07 Capability
Get cocktail by id
Pull every detail for a specific drink using its unique ID. This is perfect for deep dives into single recipes.
08 Capability
Get ingredient by id
Get the full profile of an ingredient from its ID. Use this to learn more about specific spirits or fruits.

Capability set03 / 05

09—12

4 capabilities in this set.

Part of 18 available through TheCocktailDB.

09 Capability
Get latest cocktails
See what's new in the mixology world. This requires a premium key to access the most recent additions.
10 Capability
Get popular cocktails
Find the most-ordered drinks globally. This also requires a premium key to see what's trending.
11 Capability
Get random selection
Pull a list of 10 random drinks at once. This requires a premium key for your agent to browse.
12 Capability
List alcoholic filters
See all available categories for alcohol content. This helps your agent understand the filtering options.

Capability set04 / 05

13—15

3 capabilities in this set.

Part of 18 available through TheCocktailDB.

13 Capability
List categories
Get a full list of cocktail categories. Use this to see what types of drinks are in the database.
14 Capability
List glasses
See every type of glassware in the database. This helps you know what glasses you can filter by.
15 Capability
Search cocktail by first letter
Find drinks starting with a specific letter. It's a quick way to browse the database alphabetically.

Capability set05 / 05

16—18

3 capabilities in this set.

Part of 18 available through TheCocktailDB.

16 Capability
Search cocktail by name
Look up a specific drink by its common name. This is the most direct way to get a recipe.
17 Capability
Search ingredient by name
Find details on a specific ingredient by name. Use this to check properties of various spirits or mixers.
18 Capability
Get random cocktail
Get a completely random drink idea. It's the perfect choose for me button for your agent.

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 preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/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

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/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

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "thecocktaildb-extended": {
      "url": "https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/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...". 18 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "thecocktaildb-extended": {
      "url": "https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/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...". 18 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "thecocktaildb-extended": {
      "url": "https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/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...". 18 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "thecocktaildb-extended": {
      "url": "https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/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...". 18 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add thecocktaildb-extended --transport http "https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/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...". 18 tools are ready

Where the request belongs

Work TheCocktailDB can move forward.

Built around the request

This is for home bartenders tired of recipe hunting, beverage app developers needing clean data, and food enthusiasts who want to master mixology.

01

Home Mixologist

Uses the agent to find drink recipes based on the specific ingredients they have in their cabinet on a Friday night.

02

Beverage App Developer

Pulls structured drink data to populate a new beverage discovery or recipe app.

03

Menu Consultant

Analyzes popular drink trends and categories to help design a new cocktail menu for a cafe or bar.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 12 capabilities

TheCocktailDB

Global cocktail database. search recipes, ingredients, and mixology guides via AI.

02 12 capabilities

CocktailFyi

Explore cocktails, ingredients, and bartending techniques. get recipes and guides via AI.

03 8 capabilities

Cocktail API

Search cocktail recipes. audit ingredients and instructions via AI.

04 3 capabilities

Punk

Explore the BrewDog beer catalog. search by ingredients, food pairings, and technical specs like ABV or IBU.

05 8 capabilities

PunkAPI

Explore BrewDog's beer catalog. search by name, style, ABV, IBU, hops, food pairing and get random beer suggestions.

06 30 capabilities

Untappd

Track beers, breweries, and venues. Access check-in feeds, beer metadata, and manage your social drinking profile directly from your AI agent.

Bring your own AI

Change the model, client or framework. Keep TheCocktailDB connected.

Before you connect

Questions about TheCocktailDB.

The practical details behind the request, access and result.

Can TheCocktailDB MCP find mocktails?

Yes, it can. You can ask your agent to filter for non-alcoholic options to find a wide variety of mocktails and alcohol-free drinks.

How does TheCocktailDB MCP help with home bartending?

It acts like a digital bartender. You can ask for recipes based on what you have in your fridge or find specific drinks by category.

Can I use TheCocktailDB MCP to find drinks with specific ingredients?

Absolutely. You can tell your agent to find drinks that feature a specific ingredient like tequila, lime, or even more unique mixers.

Does TheCocktailDB MCP include glassware types?

Yes, it does. The database includes information on the specific glass types used for various drinks, so you know exactly what you need.

Can TheCocktailDB MCP help me build a drink app?

Yes, it's great for developers. It provides structured drink data that can be used to populate your own beverage-related applications.

Can I find non-alcoholic drink recipes using this server?

Yes! You can use the filter_by_alcoholic capability 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 capability. 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 capability and provide the name of the ingredient to see all cocktails that include it in their recipe.

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