Cellar

Cellar — connector documentation

• MCP endpoint: https://cellar.connectorbay.com/mcp
• REST API: POST https://cellar.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://cellar.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://cellar.connectorbay.com/health · Tool schemas: https://cellar.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/cellar · agent@connectorbay.com

What Cellar is for

The reference questions that come up around wine and spirits — what does this grape actually taste like, what region is this style from, what wine goes with dinner, what's the difference between bourbon and scotch, what does "on the rocks" or "tannic" mean, what temperature should this be served at — answered from one general, hand-curated reference, without a scroll through mismatched blog posts.

What it does

Flavor profile, typical body (light/medium/full), typical regions and general food-pairing style for 20+ common wine grape varietals (wine_varietal_guide); the signature style and grape varietals of ten major wine regions — Bordeaux, Burgundy, Napa Valley, Tuscany, Rioja, Champagne, Barossa Valley, Mendoza, Marlborough, Douro Valley (wine_region_guide); general classic-pairing heuristics for common food categories — red meat, white fish, poultry, spicy food, cheese, dessert — phrased as guidance, not a strict rule (food_pairing_guide); general production method, flavor profile and common serving style for whiskey and its sub-types (bourbon, scotch, rye, Irish), vodka, gin, rum, tequila and brandy/cognac (spirit_category_guide); a glossary of ~14 bartending terms (muddle, neat vs. up vs. on the rocks, jigger, dry shake, proof, ABV, and more) plus the general composition of ten classic cocktails by name, described in plain language rather than exact proportions (cocktail_glossary); general serving-temperature guidance for red wine, white wine, sparkling wine, and spirits neat vs. on the rocks (serving_temperature_guide); glass-shape guidance and why the shape matters — aroma concentration, temperature retention, carbonation — for a red or white wine glass, champagne flute, rocks glass, highball and coupe (glassware_guide); a glossary of common tasting-note vocabulary (tannic, oaky, crisp, dry vs. sweet, body, finish, legs/tears, peaty, and more), grouped as wine-only, spirits-only or shared (tasting_note_vocabulary); and typical, general ABV (alcohol by volume) reference ranges for beer, wine, fortified wine and spirits (abv_reference_guide).

What it is not

Not a shopping guide, a drinks menu, or an app for finding or ordering anything — Cellar names no real commercial brand, product or producer anywhere in its data, and every tool is general, educational reference material rather than a recommendation for what to buy or drink. It is not health or medical guidance either: the ABV figures are typical, general ranges stated as plain facts, not a claim that any amount of alcohol is safe or unsafe. Cocktail entries describe general composition, never exact measurements or proof-pushing detail, so they read as reference, not as a bartending recipe card. Cellar is purely informational and educational — it does not encourage alcohol consumption, and it's meant for adults of legal drinking age in their own jurisdiction, used responsibly and legally.

Tools

Wine

wine_varietal_guide — A wine grape varietal's general flavor profile, typical body (light/medium/full), typical regions it's associated with, and its general food-pairing style. Use for "what does Malbec taste like", "is Riesling sweet", "what body is Zinfandel". Args: name.

wine_region_guide — A major wine region's general style and the grape varietals it's best known for. Use for "what's Rioja known for", "what grapes come from Burgundy". Args: name.

food_pairing_guide — General classic wine-pairing heuristics for a food category (red meat, white fish, poultry, spicy food, cheese, dessert) — phrased as general guidance, not a strict rule. Use for "what wine goes with spicy food", "what pairs with steak". Args: dish_or_ingredient.

Spirits & cocktails

spirit_category_guide — A spirit category's general production method, flavor profile, and common serving style — whiskey and its sub-types (bourbon, scotch, rye, Irish), vodka, gin, rum, tequila, and brandy/cognac. Use for "how is tequila made", "what's the difference between bourbon and rye". Args: name.

cocktail_glossary — Definitions of common bartending/cocktail terms (muddle, neat vs. up vs. on the rocks, jigger, dry shake, proof, ABV, garnish, and more), and the general composition of classic cocktails by name (e.g. "an Old Fashioned is built from a base spirit, sugar, bitters, and a twist") — never exact proportions or proof. Use for "what does 'up' mean", "what's a Manhattan made of". Args: term.

Serving

serving_temperature_guide — General serving-temperature guidance for red wine, white wine, sparkling wine, and spirits neat vs. on the rocks. Use for "what temperature should red wine be served at", "should champagne be cold". Args: beverage_type.

glassware_guide — General glass-shape guidance — red wine glass, white wine glass, champagne flute, rocks/old-fashioned glass, highball glass, coupe glass — and why the shape matters (aroma concentration, temperature retention, carbonation). Use for "why is a wine glass shaped that way", "what glass for a Negroni". Args: beverage_type.

Reference

tasting_note_vocabulary — A glossary of common tasting-note descriptor vocabulary (tannic, oaky, crisp, dry vs. sweet, body, finish, legs/tears, peaty, and more), grouped as wine-only, spirits-only, or shared. Use for "what does 'tannic' mean", "what's the difference between 'legs' and 'finish'". Args: category.

abv_reference_guide — Typical, general alcohol-by-volume (ABV) ranges by beverage category (beer, wine, fortified wine, spirits) — purely factual reference, not a health claim in either direction. Use for "what's the typical ABV of wine", "how much stronger is a fortified wine than table wine". Args: beverage_category.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/cellar/support

Cellar — Privacy Policy

Effective 24 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Cellar is. Cellar is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a fully local wine & spirits reference: grape varietal and region guides, food-pairing heuristics, spirit-category profiles, a cocktail/bartending glossary, serving-temperature and glassware guidance, tasting-note vocabulary, and typical ABV reference ranges. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup.

What we receive. The arguments of each tool call — a grape varietal, a region, a food category, a spirit category, a bartending term or cocktail name, a beverage or glassware type, or an ABV category — the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Everything is answered from bundled, hand-curated reference files and nothing is stored. No request is forwarded to any third party — there is no upstream call at all, live or otherwise — and no query is logged in request bodies, recorded, or used to train anything.

What we do not receive or store. We do not receive your conversation with the assistant or your name, and we do not build a profile from your queries: each request is answered independently and nothing carries over between requests. We do not ask, infer, or store anything about your age, location-specific drinking laws, or drinking habits. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. None — the entire dataset is bundled with the server and answered locally. Hosting: Vercel (United States regions).

Legal bases and your rights. Our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children and responsible use. Cellar is a general-education reference tool, not designed or intended to encourage alcohol consumption by anyone. It is meant for adults of legal drinking age in their own jurisdiction; we do not verify age and rely on the operator of the AI assistant and the person using it to use the Service responsibly and lawfully.

Changes. We will post changes here with a new effective date.

Cellar — Terms of Service

Effective 24 September 2026. These terms govern use of the Cellar connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Cellar returns a fully local wine & spirits reference — grape varietal and region guides, food-pairing heuristics, spirit-category profiles, a cocktail/bartending glossary, serving-temperature and glassware guidance, tasting-note vocabulary, and typical ABV reference ranges — from bundled, hand-curated editorial content. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Informational and educational only — not drinking, health, or purchasing advice. Cellar is a general reference tool. It names no real commercial brand, product or producer, gives no health or medical guidance about alcohol, and nothing in the Service is a recommendation to buy, mix, or consume any beverage. ABV figures are typical, general ranges, not a claim that any amount of alcohol is safe or unsafe. Classic-cocktail entries describe general composition only, not a precise recipe.
3. Legal drinking age. The Service is intended for adults who are of legal drinking age in their own jurisdiction, used responsibly and in compliance with local law. We do not verify age or identity and rely on the AI assistant's operator and the person using it to ensure appropriate, lawful use.
4. Reference content, not exhaustive. The varietals, regions, spirit categories and other entries reflect commonly documented, general characteristics written in our own words; individual producers, bottles and personal taste vary, and plenty of real examples fall outside these general descriptions.
5. Acceptable use. Automated use within the published rate limits is welcome.
6. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
7. Data. Our Privacy Policy describes what we process. In short: your query is answered from bundled reference files, and nothing is stored.
8. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
9. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service. Our total liability is limited to US $100.
10. Governing law. California law; venue in San Mateo County, California.
11. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/cellar

Cellar support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://cellar.connectorbay.com/mcp
• REST API: https://cellar.connectorbay.com/openapi.json
• Live status: https://cellar.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Cellar never asks for them.