# Winevybe MCP

> Winevybe lets your AI agent act as an expert sommelier for everything from cellar inventory to global wine pairing ideas. Search massive catalogs, audit vintage scores, and manage your private collection—all through conversation.

## Overview
- **Category:** inventory-management
- **Price:** Free
- **Tags:** sommelier-intelligence, wine-catalog, cellar-management, tasting-notes, pairing-recommendations, inventory-tracking

## Description

Use this MCP when you need deep wine knowledge without opening a dozen browser tabs. You can ask your agent to pull detailed tasting notes on a specific bottle; track what's currently in your virtual cellar; or find the perfect food pairings for a rare vintage.

For example, instead of checking three different sites for regional history and pricing comparisons, you simply ask about it. The system cross-references vineyard profiles, checks global market data, and even compares two bottles side-by-side to help you decide. This is ideal for private collectors or hospitality managers who need instant expertise.

The platform handles the sensitive API keys through a zero-trust proxy; your credentials pass in transit but never sit on disk. You connect once from any MCP-compatible client, and the system manages all that complexity so you can focus only on what matters: the perfect pour.

## Tools

### add_wine_to_cellar
Adds a newly purchased bottle record into your virtual cellar tracker.

### compare_wines
Creates a side-by-side comparison of two specified wine bottles.

### get_pairings
Provides recommended food pairings for any given wine profile.

### get_region_info
Retrieves detailed information about specific wine-making appellations or regions.

### get_reviews
Fetches community tasting reviews and aggregated ratings for a bottle.

### get_user_cellar
Displays the current inventory list of wines stored in your personal cellar account.

### get_vintage_scores
Retrieves an overview score and analysis of a wine region's harvest quality for a specific year.

### get_wine_detail
Pulls profound tasting notes, stats, and profile details on one particular wine.

### get_winery_info
Gathers background profiles and history for specific producers or vineyards.

### search_wines
Searches the entire wine database using criteria like varietal, region, or price range.

## Prompt Examples

**Prompt:** 
```
Search for details on the Screaming Eagle Cabernet Sauvignon.
```

**Response:** 
```
I've fetched the profile details for 'Screaming Eagle Cabernet Sauvignon' (Wine ID: 39502). It is highly rated (98/100) and displays deep blackberry notes with incredibly refined tannins. Would you like to check pairing ideas?
```

**Prompt:** 
```
Compare wine 4902 and wine 5910.
```

**Response:** 
```
Running the comparison workflow... Wine 4902 is a Bordeaux Blend averaging $120, while wine 5910 is a Napa Valley Meritage averaging $145. Both rank highly on fruit structure, but 4902 offers a slightly higher rating relative to price.
```

**Prompt:** 
```
Check my virtual cellar inventory.
```

**Response:** 
```
Accessing your cellar (User ID: currentUser)... You currently hold 14 active bottles, spanning 3 primary varietals. Recent additions include the 'Louis Roederer Brut 2014'. Which section should we audit?
```

## Capabilities

### Search Wine Catalog
Find specific bottles or types of wine across global databases.

### Audit Cellar Inventory
List and manage the quantities and details of wines stored in your virtual cellar.

### Get Pairings
Receive food pairing recommendations based on a wine's specific profile.

### Compare Wines
Generate a side-by-side contrast of two distinct bottles to aid decision-making.

### Research Regions and Vintages
Retrieve history, details, and quality scores for specific wine regions or years.

## Use Cases

### Planning a high-end dinner menu
The agent needs recommendations for wines that pair with salmon and risotto. The user asks, 'What's good for fish?' The agent calls `get_pairings`, returns suggestions, and then uses `search_wines` to show the current price range of those options.

### Reviewing a recent auction purchase
A collector just bought a bottle. They ask their agent about it. The agent first calls `get_wine_detail` for notes, then uses `get_reviews` to check community reception, and finally runs `add_wine_to_cellar` so the item is tracked.

### Writing a piece on Bordeaux history
The journalist needs background context. They ask about the region. The agent calls `get_region_info` for appellation details, then uses `get_winery_info` to profile major local producers, and finally checks historical quality with `get_vintage_scores`.

### Comparing two competing options
The sommelier needs to decide between a Napa Meritage and a Bordeaux Blend. The agent runs `compare_wines` using the IDs, immediately highlighting differences in price and structure relative to each other.

## Benefits

- Manage your collection easily. Use `get_user_cellar` to view your entire inventory, or `add_wine_to_cellar` when you acquire a new bottle.
- Never guess at pairing again. Ask for food suggestions using `get_pairings` and get immediate recommendations based on the wine's profile.
- Deep dive into quality. Use `get_vintage_scores` to check if the climate conditions of a specific year yielded good harvests in that region.
- Compare bottles quickly. Running `compare_wines` generates an instant, structured contrast between two different selections for your table.
- Get full context on producers. Check vineyard history and details using `get_winery_info` to add depth when writing or speaking about a wine.

## How It Works

The bottom line is you talk to your AI agent like a sommelier, and it handles all the complicated database lookups behind the scenes.

1. Subscribe to the Winevybe MCP and input your developer API key into the Vinkius platform.
2. Connect your preferred AI client (Claude, Cursor, etc.) to the catalog via its native integration.
3. Ask a complex question in natural language; the agent automatically calls multiple tools to gather data and synthesizes an answer.

## Frequently Asked Questions

**How do I use the get_pairings tool?**
You just ask your agent for pairings. Provide the name or details of the wine you're interested in, and the system uses `get_pairings` to give food recommendations.

**What if I want to check my inventory with get_user_cellar?**
Ask your agent to 'check my cellar'. It calls `get_user_cellar`, listing every bottle you've logged. You can then ask it to audit specific varietals within that list.

**Can I compare two wines using the compare_wines tool?**
Yes, you give your agent the IDs or names of the two bottles, and `compare_wines` runs a side-by-side comparison, highlighting differences in structure, price, and rating.

**How do I get details on a specific wine using get_wine_detail?**
Tell your agent the name of the wine. It calls `get_wine_detail` to pull comprehensive stats, tasting notes, and full profile data for you.

**Does Winevybe track vintage quality using get_vintage_scores?**
Absolutely. Ask it about a specific region and year, and `get_vintage_scores` gives an analysis of the harvest quality for that time period.

**How does get_region_info help me understand a wine's origin?**
It provides detailed information about the specific appellation where the wine was made. You get data on local terroir, history, and required growing conditions for that region.

**What kind of profile does get_winery_info give me?**
This tool gathers background details on a specific producer or estate. You can learn about their history, signature varietals, and general reputation in the global wine market.

**If I only know a wine by name, how do I find its details using search_wines?**
Running search_wines locates the exact bottle in the database based on keywords. It returns core metadata, including the Wine ID and basic tasting notes, allowing you to proceed with further analysis.

**Can my AI automatically pull tasting notes and pairings out of a single bottle search?**
Yes! Use the `get_wine_detail` and `get_pairings` tools. Your agent will respond with complete metadata regarding aromas, tannin complexity, and best foods to match with the queried bottle.

**How do I easily update the inventory inside my virtual cellar?**
Simply ask the agent to run the `add_wine_to_cellar` action providing the Wine ID and Quantity. It will modify your inventory database safely without manually clicking through menus.

**Are there any destructive capabilities regarding regional scores or public metrics?**
No. The core set of tools dealing with global data limits itself strictly to querying records like `get_vintage_scores`. All write operations are firmly locked to your private user cellar.