# Winevybe MCP for AI Agents AI Agent Connect

> Winevybe. Automate sommelier intelligence by searching global wine catalogs, checking vineyard ratings, and managing your virtual cellar. Connect it to your AI agent to handle complex wine pairings and inventory tracking through simple conversation.

## Overview
- **Category:** inventory-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_hpnvdqgvESLeKVFhgLArKHusuYWUIWTNHKmKaCV4/ai-agent-connect
- **Tags:** sommelier-intelligence, wine-catalog, cellar-management, tasting-notes, pairing-recommendations, inventory-tracking

## Description

Stop jumping between dozens of tasting sites and spreadsheets just to find the right bottle or update your collection. This Connector connects your AI agent to a deep database of wine intelligence, letting you act like a pro sommelier without the manual research. You can ask your agent to find specific bottles, pull up detailed tasting notes, or check if a particular vintage was a standout year for a specific region. If you need to know what goes well with a heavy red, you just ask and get specific meal pairings instantly. It also handles the heavy lifting of inventory management. You can tell your agent to add a new purchase to your virtual cellar or ask for a status update on your current stock. This Connector is available in the Vinkius catalog, making it easy to plug into your existing workflow. It turns your AI into a dedicated cellar manager that knows the history of major producers and the nuances of different appellations, so you can focus on the drinking instead of the data entry.

## Tools

### add_wine_to_cellar
Adds a purchased bottle into a user's virtual cellar tracker. This keeps your inventory updated automatically.

### get_pairings
Provides food pairing recommendations for a specific wine. Use this to build menus or dinner plans.

### compare_wines
Generates a side-by-side contrast of two different bottles. This helps you decide between two similar options.

### get_region_info
Retrieves details about wine-making appellations and regions. This provides geographical and production context.

### get_reviews
Fetches community tasting reviews and ratings for a specific wine. Use this to see what other drinkers think.

### get_user_cellar
Shows the current inventory of an authenticated user's wine cellar. This helps you see what you have on hand.

### get_vintage_scores
Provides an overview of harvest qualities for a specific year and region. Use it to check if a year was good.

### get_wine_detail
Retrieves deep tasting notes and technical stats for a specific bottle. This gives you the full profile of a wine.

### get_winery_info
Pulls profiles and history for specific vineyards and producers. This provides context on the maker.

### search_wines
Searches the Winevybe database for specific bottles or labels. Use this to find new additions to your list.

## Prompt Examples

**Prompt:** 
```
What are some good pairings for a heavy Cabernet Sauvignon?
```

**Response:** 
```
For a heavy Cabernet Sauvignon, here are some excellent pairings:

*   **Red Meats:** Grilled ribeye, lamb chops, or venison.
*   **Cheese:** Aged cheddar, gouda, or any hard, sharp cheese.
*   **Savory Dishes:** Beef bourguignon or hearty stews.

Would you like to see specific tasting notes for a particular bottle?
```

**Prompt:** 
```
Compare the 2018 and 2019 vintages for Bordeaux.
```

**Response:** 
```
| Vintage | Harvest Quality | Notes |
| :--- | :--- | :--- |
| **2018** | Excellent | High yields with balanced tannins. |
| **2019** | Very Good | Slightly cooler temperatures led to more concentrated fruit. |

The 2018 is a safer bet for fruit-forward profiles, while the 2019 offers more structure.
```

**Prompt:** 
```
Check my cellar and tell me what I have left of the Pinot Noirs.
```

**Response:** 
```
Checking your cellar inventory now... 

You have **4 bottles** of Pinot Noir remaining:
*   Louis Roederer Brut 2014 (Wait, this is a sparkling!) 
*   **Pinot Noir from Sonoma** (2 bottles)
*   **Burgundy Pinot Noir** (2 bottles)

Would you like me to find some pairing ideas for the Sonoma bottles?
```

## Capabilities

### Search global wine catalogs
Find specific bottles and labels across a wide range of producers.

### Track virtual cellar inventory
Update bottle quantities and view your personal collection in real time.

### Get food pairing suggestions
Receive specific meal and wine combinations based on flavor profiles.

### Analyze vintage quality
Check harvest conditions and scores for specific years and regions.

### Compare bottle prices and ratings
View side-by-side contrasts of different wines to analyze value.

### Retrieve vineyard profiles
Access the history and production details of major worldwide vineyards.

## Use Cases

### Creating a restaurant wine list
A manager needs to find the best red wine for a steak menu. They ask the agent for pairings and get specific results using get_pairings.

### Updating a private collection
A collector buys a new bottle and wants to log it. They tell the agent to add the bottle to their list using add_wine_to_cellar.

### Researching a specific vintage
A reviewer wants to know why a 2015 Bordeaux was so high-scoring. They use get_vintage_scores to see the harvest data.

### Comparing two Napa Cabs
A shopper is torn between two different labels. They ask the agent to compare_wines to see the difference in ratings and price.

## Benefits

- Stop manually searching tasting sites because search_wines lets your agent find bottles instantly.
- Keep your inventory accurate by using add_wine_to_cellar to update your list after every purchase.
- Save time on menu planning with get_pairings to find the best food and wine matches.
- Make smarter buying decisions by using compare_wines to see price versus community ratings.
- Get deep context on your favorites by pulling vineyard history with get_winery_info.
- Audit your collection's quality by checking harvest conditions with get_vintage_scores.

## How It Works

The bottom line is you get a dedicated sommelier and inventory manager inside your chat interface.

1. Subscribe to the Winevybe MCP and get your API key.
2. Paste your key into your AI client's configuration settings.
3. Ask your agent to search for wines, check pairings, or update your cellar.

## Frequently Asked Questions

**Can Winevybe help me organize my wine collection?**
Yes. It lets you manage a virtual cellar where you can track your current inventory, add new purchases, and see what you have on hand through your AI agent.

**How does Winevybe find wine pairings?**
It pulls data from a deep wine database to provide specific food and wine matches based on flavor profiles and sommelier intelligence.

**Can I use Winevybe to see if a wine is a good value?**
Absolutely. You can ask the agent to compare two different bottles side-by-side to see how their prices stack up against community ratings.

**Does Winevybe help with restaurant menu planning?**
It is a great tool for hospitality managers. You can quickly pull pairing ideas and wine characteristics to build out menus without manual research.

**Can I add new bottles to my list using Winevybe?**
Yes, you can tell your AI agent to add a purchased bottle to your virtual cellar, and it will update your tracker automatically.

**How does Winevybe provide info on different wine regions?**
It retrieves specific details about wine-making appellations, including regional history and production profiles.

**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.