An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Thecocktaildb Extended to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Turn your AI agent into a professional bartender.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 18 capabilities

We ship only the actions that matter.

Capability set01 / 05

01-04

4 capabilities in this set.

Part of 18 available through TheCocktailDB.

  1. 01

    Filter by alcoholic

    This capability filters the database for alcoholic or non-alcoholic drinks.

  2. 02

    Filter by category

    Use this to narrow down cocktail choices by their specific category.

  3. 03

    Filter by glass

    This capability returns cocktails that are served in a specific type of glass.

  4. 04

    Filter by ingredient

    Filter the cocktail list to find drinks containing a single specific ingredient.

Capability set02 / 05

05-08

4 capabilities in this set.

Part of 18 available through TheCocktailDB.

  1. 05

    Get cocktail by ID

    Retrieve the full recipe and details for a cocktail using its unique ID.

  2. 06

    Get latest cocktails

    This premium capability pulls a list of the most recently added cocktails.

  3. 07

    Get popular cocktails

    Access a list of the most popular cocktails via this premium capability.

  4. 08

    Get random selection

    This premium capability fetches 10 random cocktails for discovery.

Capability set03 / 05

09-12

4 capabilities in this set.

Part of 18 available through TheCocktailDB.

  1. 09

    List alcoholic filters

    Get a list of all available alcoholic status filters.

  2. 10

    List categories

    Retrieve all available cocktail categories from the database.

  3. 11

    List glasses

    This capability provides a list of all available glass types used for cocktails.

  4. 12

    Search ingredient by name

    Search for specific details about an ingredient by its name.

Capability set04 / 05

13-15

3 capabilities in this set.

Part of 18 available through TheCocktailDB.

  1. 13

    Get random cocktail

    Fetch one random cocktail recipe for quick inspiration.

  2. 14

    Filter by multi ingredient

    This premium capability filters cocktails that contain multiple specific ingredients.

  3. 15

    Get ingredient by ID

    Look up the specific properties of an ingredient using its ID.

Capability set05 / 05

16-18

3 capabilities in this set.

Part of 18 available through TheCocktailDB.

  1. 16

    List ingredients

    Get a full list of all available ingredients in the database.

  2. 17

    Search cocktail by first letter

    Find cocktails that start with a specific letter.

  3. 18

    Search cocktail by name

    Search the database for a cocktail using its name.

Real work

What teams actually run

01

Inventory-Based Recipes

Tell your AI what is in your liquor cabinet and have it suggest cocktails you can actually make.

02

App Data Testing

Feed cocktail and ingredient data directly into your development environment for rapid testing.

03

Menu Planning

Use category and glass type filters to plan a themed drink menu for an event.

04

Mixology Research

Query specific ingredients to understand how they are used across different drink styles.

Automate a task

Put TheCocktailDB to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

TheCocktailDB works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put TheCocktailDB to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

939ms average. Fast in production.

TheCocktailDB is checked daily against the live service.

Daily averagePeak 1179ms
Oct 3Today
Fastest day
762ms
Slowest day
1179ms
14-day trend
Slowing+43%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 18 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of TheCocktailDB, so you can see the experience inside your AI.

It does not authenticate your account with TheCocktailDB. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

TheCocktailDB Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — TheCocktailDB capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "thecocktaildb-extended-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_8nIPUR51H6To6XQh6KAjVmUfk2FhH1dCSgTIrOHA/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up TheCocktailDB in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work TheCocktailDB owners hand off.

This MCP is built for anyone needing structured mixology data within an AI workflow.

  • 01

    Home Bartenders

    They ask the AI to find recipes based on the ingredients they currently have.

  • 02

    App Developers

    They use the capability to pull drink and ingredient data for testing applications.

  • 03

    Food and Beverage Enthusiasts

    They use the AI to research the composition and history of various cocktails.

FAQ

Questions TheCocktailDB owners ask.

  • 01

    Do I need a paid API key to use this MCP?

    No, you can use the free test tier by entering '1' as your API key. Premium features like searching by multiple ingredients or viewing popular cocktails require a premium key.

  • 02

    Which AI clients can I use with this?

    This MCP works with any compatible client, including Claude, Cursor, and Windsurf.

  • 03

    Can I find non-alcoholic drinks?

    Yes, you can use the alcoholic filter capability to specifically find non-alcoholic options.

  • 04

    How does Vinkius handle the connection?

    Vinkius hosts the MCP and manages the credentials so you only have to connect your client once.

  • 05

    Can I search for drinks by the glass they are served in?

    Yes, the filter_by_glass capability allows your agent to find drinks based on the glassware used.

  • 06

    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.

  • 07

    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.

  • 08

    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.

Explore

More in Gaming Entertainment

Suggestions

Connect TheCocktailDB to Claude, Cursor, ChatGPT & more