# Wine-Searcher MCP

> Wine-Searcher connects global wine pricing, critic scores, grape varieties, regions, and producer data from over 100,000 merchants worldwide. It gives your agent real-time market intelligence for any bottle or appellation, letting you instantly check value, origin, and composition without leaving the chat.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** price-comparison, market-intelligence, critic-scores, wine-data, retail-pricing, global-market

## Description

Need to vet a wine's worth? This MCP connects directly to Wine-Searcher—the biggest global source for liquid market data. You can ask anything about wine: its price range across major retailers, what critics think of it, or exactly where its grapes came from. Instead of checking dozens of individual merchant sites or relying on general knowledge bases, your agent pulls real-time data, showing you the average and min/max pricing right now. The system builds a cryptographically signed audit trail for every single price point retrieved, meaning you always know exactly what data is flowing through and when. This level of transparency is critical when dealing with market valuation. Whether you're tracking vintage fluctuations or sourcing grapes from a new region, this MCP aggregates the necessary information so you don't have to stitch together multiple spreadsheets just to get an educated guess.

## Tools

### wine_check
Performs a primary lookup on any wine, returning global average/min/max pricing, critic scores, and composition data.

### market_price
Compares real-time pricing for a wine across 100,000+ global merchants to find the best deal.

### search_wines
Searches the entire database to find wines by name or general criteria, listing scores and merchant availability.

### grape_info
Provides expert details on any grape variety, covering its origins and recommended food pairings.

### region_info
Delves into the geography of a wine region, explaining its climate, soil type, and appellation rules.

### producer_info
Gives you detailed profiles on specific wineries or producers, listing their key wines and available vintages.

## Prompt Examples

**Prompt:** 
```
What's the average price for Opus One 2021?
```

**Response:** 
```
🍷 **Opus One 2021 — Napa Valley**

💰 **Global pricing**:
- Average: **$425**
- Range: $380 — $520
- Merchants listing: 847 worldwide

⭐ **Critic scores**:
- Wine Advocate: 97/100
- Wine Spectator: 96/100
- James Suckling: 98/100

🍇 **Blend**: Cabernet Sauvignon (79%), Merlot (7%), Cabernet Franc (6%), Petit Verdot (5%), Malbec (3%)
📍 **Appellation**: Oakville, Napa Valley
🥂 **ABV**: 14.5%
```

**Prompt:** 
```
Find merchants near London selling Dom Pérignon 2012.
```

**Response:** 
```
Searching Merchant listings ('search_wine_prices')...
Showing top 3 merchants for **Dom Pérignon Brut 2012** near London (UK):

1. **Berry Bros. & Rudd** (Mayfair) — £175.00 (In Stock: 12+)
   [Buy link/URL]
2. **Hedonism Wines** (Mayfair) — £182.50 (In Stock: 8)
   [Buy link/URL]
3. **Farr Vintners** (Battersea) — £168.00 (In Bond/Case only)
   [Buy link/URL]
```

**Prompt:** 
```
What can you tell me about the Pomerol wine region?
```

**Response:** 
```
Looking up details ('get_region_info')...
**Pomerol (Bordeaux, France)**
- **Focus**: Red wines, primarily Merlot mixed with Cabernet Franc.
- **Terroir**: Smallest major Bordeaux appellation (800ha). Famous for its 'crasse de fer' (iron-rich clay and gravel) imparting truffle notes.
- **Top Producers**: Petrus, Le Pin, Château Lafleur, Vieux Château Certan.
- **Vintages**: 2015, 2016, 2018, 2019, 2020 are exceptional.
```

## Capabilities

### Check Wine Details
Get instant global pricing, critic scores, and basic compositional data for any specific wine bottle.

### Compare Market Pricing
See real-time purchase prices from hundreds of global merchants, including direct buy links and store locations.

### Search Wine Inventory
Perform a deep search across the entire database to find specific wines by name or general criteria.

### Detail Grape Varieties
Access expert profiles on grape types, including their origins and best food pairings.

### Research Wine Regions
Deep-dive into specific wine regions to understand local climate, soil composition, and appellation rules.

### Profile Producers/Wineries
Get detailed background on a winery or producer, listing their key wines, price brackets, and available vintages.

## Use Cases

### Verifying an Investment Purchase
A collector receives an older bottle. Instead of calling three separate auction sites, the agent runs `wine_check` for basic scores and then uses `market_price` to see if similar vintages are currently selling at a higher or lower value than expected.

### Guiding a Client's Pairing
A sommelier needs pairing ideas. They run `grape_info` on the client’s wine, which explains its dominant grape and best food pairings; they then use `producer_info` to check if other wines from that same producer offer complementary profiles.

### Market Sourcing for a New Line
An importer is vetting new suppliers. They use `region_info` to learn about the local climate and soil of a potential source, then use `search_wines` to find representative samples to compare against established market standards.

### Quick Competitive Analysis
A retailer needs fast pricing data. They run `wine_check` on five competitor wines and immediately follow up with `market_price` to get the top three merchants selling each one, allowing for rapid inventory adjustments.

## Benefits

- Stop guessing on price. Use `market_price` to compare real-time costs from hundreds of global merchants, ensuring you get the actual best deal available today.
- Understand the 'why' behind the cost. Running `region_info` or `grape_info` gives you the necessary deep knowledge about terroir and composition that justifies a wine’s premium price tag.
- Vet any vintage quickly. The primary `wine_check` tool delivers immediate critic scores, alcohol content, and global pricing ranges for instant due diligence.
- Source reliable data sets. Because Vinkius runs this MCP in an isolated sandbox with 34+ security rules, you can trust that the financial information pulled is tamper-proof by design.
- Track brand history. Use `producer_info` to quickly build a dossier on a winery's portfolio, checking multiple key wines and available vintage years against each other.

## How It Works

The bottom line is you get a complete, structured report on any bottle, covering its history, composition, and current market value in one go.

1. Start by asking the agent to check a specific wine name. This initial query gets you the core details, including basic scores and global price ranges.
2. Next, ask for merchant availability using the market comparison tool. This narrows down your options to find the best current deal or local stock information.
3. Finally, if necessary, drill into the origin by requesting the region info or grape profile to understand why that wine costs what it does.

## Frequently Asked Questions

**How do I find out if a wine is expensive or cheap using `wine_check`?**
The `wine_check` tool provides global minimum, maximum, and average pricing. Comparing these three metrics gives you an immediate sense of the market range for that specific bottle.

**Can I use `market_price` to find local sellers near me?**
Yes, the tool pulls real-time data from merchants globally and can pinpoint stores with current stock levels and direct purchase URLs in your area or specified region.

**Is there a tool for learning about grapes? How does `grape_info` work?**
`grape_info` is dedicated to education. It pulls detailed profiles on grape varieties, covering where they originated and what food pairings traditionally match them.

**If I only know the region (e.g., Napa Valley), how do I start? Should I use `region_info` first?**
Starting with `region_info` is smart. It provides the foundational knowledge—the climate and soil—which then helps you narrow down which specific producers or grape varieties to search for next.

**If I want to compare multiple wineries, how does `producer_info` help?**
It gives you a detailed profile on any winery. You can use it to research brands and compare key wines, score ranges, and available vintages without needing a specific wine title first.

**What if I only know the general type of wine? How does `search_wines` help me find it?**
You can search the entire database using keywords or descriptions, even without a name. It returns matching wines with pricing, critic scores, and merchant availability so you can explore options.

**Does `wine_check` give me all the necessary global price data?**
Yes, it provides comprehensive details including the global average, minimum, and maximum pricing. It also includes essential specs like alcohol content, grape blend, region, and full critic scores.

**Can I use `market_price` to find out about availability for very old vintages?**
Yes, it pulls real-time pricing from over 100,000 merchants regardless of vintage age. It lists specific shop names, locations, and direct purchase links for immediate comparison.

**Is Wine-Searcher API free?**
Wine-Searcher offers a free trial (100 calls/day). After the trial, paid plans are available based on daily call volume.