WebMCP

MediaWebMCP verified

cocktail.glass WebMCP tools

Cocktail recipe catalogue — find drinks by ingredient, movie/TV scene, or family; check what you can make with what's on your shelf; pull a full recipe or a random pick.

7 tools1 methodsspec API surface

What can an agent do with cocktail.glass WebMCP tools?

Cocktail recipe catalogue — find drinks by ingredient, movie/TV scene, or family; check what you can make with what's on your shelf; pull a full recipe or a random pick. This page documents every listed tool, the action or answer it provides, its installation command, and the input fields an agent should send.

WebMCP tools on cocktail.glass

Tool 1 of 7WebMCPAnswer

search_cocktails

Search the cocktail catalogue by name (substring, case- and diacritic-insensitive, so "carre" matches "Carré"). Returns up to 25 summary results — name, page URL, family, glassware — ranked exact match first, then prefix, then suffix, then any substring. Use this when the user names a drink (even fuzzily) and you want to confirm it exists or disambiguate similar names; once you have a single name, call get_cocktail_recipe for the full recipe. For ingredient-based discovery use find_cocktails_by_ingredient instead.

How to install

Open the cocktail.glass website and ask your browser agent to use search_cocktails

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the search_cocktails tool on cocktail.glass with query: <string>. Return the structured result and cite the source page.

Input contract

  • query string Cocktail name or part of one — a single drink name, not an ingredient or category.

Open the source definition

Tool 2 of 7WebMCPAnswer

list_cocktails

List the whole catalogue: every cocktail as a summary (name, page URL, family, glassware), in catalogue order, optionally restricted to one drink family. Unlike search_cocktails and find_cocktails_by_ingredient — which cap their results and need a query — this takes no query and returns every matching cocktail, so use it to browse or enumerate the full set of 500 drinks (or a whole family) when there is nothing specific to search for. For one named drink use get_cocktail_recipe; to discover by ingredient use find_cocktails_by_ingredient.

How to install

Open the cocktail.glass website and ask your browser agent to use list_cocktails

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the list_cocktails tool on cocktail.glass with family: <string>. Return the structured result and cite the source page.

Input contract

  • family string Optional drink family — one of: Spirit-Forward, Sour, Highball, Fizz & Collins, Spritz, Champagne Cocktail, Tiki, Punch, Flip & Nog, Hot Drink, Shot. Matched exactly (case- and diacritic-insensitive); an unknown family returns an empty list. Omit to list the entire catalogue.

Open the source definition

Tool 3 of 7WebMCPAnswer

get_cocktail_recipe

Get the full recipe for one cocktail by name: ingredients with measures and units, preparation steps, garnish, glassware, family, page URL, and any film or TV appearances. Matching is case- and diacritic-insensitive: it tries an exact name match first, then falls back to the first substring match. Returns one cocktail object, or an { error } if nothing matches. Use this when you have a specific drink name; if the name is ambiguous or you want a list, call search_cocktails first.

How to install

Open the cocktail.glass website and ask your browser agent to use get_cocktail_recipe

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the get_cocktail_recipe tool on cocktail.glass with name: <string>. Return the structured result and cite the source page.

Input contract

  • name string The cocktail name. Exact is best; partial names work but resolve to the first substring match, so prefer search_cocktails when the name is uncertain.

Open the source definition

Tool 4 of 7WebMCPAnswer

find_cocktails_by_ingredient

Find every cocktail in the catalogue that uses one specific ingredient. Matching is a case- and diacritic-insensitive substring match against each cocktail's ingredient names, so "gin" will also match "sloe gin" and "ginger beer" — use a more specific term if that matters. Returns up to 60 summary results (name, URL, family, glassware) in catalogue order. Takes one ingredient only; for "what can I make from X, Y, and Z?" use find_makeable_cocktails instead, which handles multiple ingredients and reports near-misses.

How to install

Open the cocktail.glass website and ask your browser agent to use find_cocktails_by_ingredient

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the find_cocktails_by_ingredient tool on cocktail.glass with ingredient: <string>. Return the structured result and cite the source page.

Input contract

  • ingredient string A single ingredient term. One value only; passing a comma-separated list is treated as one literal string and will rarely match. Use find_makeable_cocktails for multi-ingredient queries.

Open the source definition

Tool 5 of 7WebMCPAnswer

find_cocktails_in_movie

Find every cocktail that appears in a given film or TV show. Case- and diacritic-insensitive substring match against both the title and the scene description, so a character or actor works too — e.g. "Casablanca", "Bond", "Hemingway". Each result names the cocktail, the film/show title, the year, and the scene. Returns up to 60 appearances ordered oldest year first, then by cocktail name. A single cocktail can appear multiple times if it shows up in multiple scenes that match. Use this only for on-screen appearances; for a drink by name use search_cocktails, and to browse the whole catalogue use list_cocktails.

How to install

Open the cocktail.glass website and ask your browser agent to use find_cocktails_in_movie

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the find_cocktails_in_movie tool on cocktail.glass with movie: <string>. Return the structured result and cite the source page.

Input contract

  • movie string A film or TV show title, full or partial

Open the source definition

Tool 6 of 7WebMCPAnswer

find_makeable_cocktails

Given the ingredients you have on hand, find every cocktail you can make completely — one where you already have all of its ingredients. Garnishes are treated as optional and plain water is assumed available; soda and tonic water are not. Matching is word-based, not substring: "gin" matches "London dry gin" but not "ginger beer", and generic terms do not match product-class extras ("gin" will not cover "sloe gin" or "orange bitters"). Returns two lists: "makeable" (drinks you can make now, up to 60) and "almostMakeable" (drinks exactly one ingredient short, up to 25, each naming the missing ingredient). Drinks needing two or more extra ingredients are omitted entirely. Both lists are ordered simplest first — fewest distinct ingredients in the full recipe, then alphabetical by name. Use this for multi-ingredient "what can I make?" questions; for a single ingredient use find_cocktails_by_ingredient.

How to install

Open the cocktail.glass website and ask your browser agent to use find_makeable_cocktails

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the find_makeable_cocktails tool on cocktail.glass with ingredients: <array>. Return the structured result and cite the source page.

Input contract

  • ingredients array The ingredients you have available — spirits, liqueurs, juices, mixers, etc.

Open the source definition

Tool 7 of 7WebMCPAction

random_cocktail

Suggest one cocktail picked uniformly at random from the catalogue (or from one family if "family" is given) and return its full recipe — ingredients with measures, preparation steps, garnish, glassware, page URL, and any film or TV appearances. Each call returns an independent draw, so repeated calls give different drinks. The "family" filter matches the family name exactly (case- and diacritic-insensitive); if no cocktail matches that family the call silently falls back to the full catalogue rather than erroring. Use this only when the user wants a suggestion or inspiration with no specific drink in mind. For a named cocktail use get_cocktail_recipe; for "anything with gin" use find_cocktails_by_ingredient; for "what can I make from what I have" use find_makeable_cocktails.

How to install

Open the cocktail.glass website and ask your browser agent to use random_cocktail

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the random_cocktail tool on cocktail.glass with family: <string>. Return the structured result and cite the source page.

Input contract

  • family string Optional drink family — one of: Spirit-Forward, Sour, Highball, Fizz & Collins, Spritz, Champagne Cocktail, Tiki, Punch, Flip & Nog, Hot Drink, Shot. Other values fall back to the full catalogue. Omit for an unrestricted random pick.

Open the source definition