---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/wine-collector
---
# Wine Collector

Look up any wine to see ratings, prices, tasting notes, and where to buy. Search by name, grape, region, or style. Compare prices across merchants, explore wine regions, and discover top-rated bottles for any occasion. Works globally with localized pricing.

- **Version:** 0.03
- **Categories:** data, search
- **Workflow:** search_wines → wine_details → search_wines → tasting_profile → search_wines → food_pairing → search_wines → similar_wines → search_wines → price_compare → search_wines → marketplace_deals → top_rated → price_compare → region_explorer → wine_details → similar_wines → price_compare → food_pairing → marketplace_deals

## Skills (9)

### Search Wines (`search_wines`)

Search for wines by name, grape variety, region, or style. Returns matching wines with ratings, prices, and wine IDs for detailed lookup.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Wine name, grape variety, or keyword to search for (e.g. "Chateau Margaux 2015", "Pinot Noir", "Barolo") |
| `wine_type` | string | No | Filter by wine type (red, white, sparkling, rose, dessert, fortified) |
| `min_rating` | number | No | Minimum average rating (1.0-5.0, default 1.0) |
| `max_price` | number | No | Maximum price in local currency |
| `min_price` | number | No | Minimum price in local currency |
| `country` | string | No | Filter by wine origin country code (e.g. "fr", "us", "it", "es", "au") |
| `sort_by` | string | No | How to sort results (ratings_count, ratings_average, price) [default: "ratings_count"] |
| `limit` | number | No | Number of results to return (1-25, default 10) [default: 10] |
| `page` | number | No | Page number for pagination (default 1) [default: 1] |
| `market` | string | No | Country code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in" [default: "us"] |
| `currency` | string | No | Currency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR" [default: "USD"] |

**Returns:** List of matching wines with names, ratings, localized prices, regions, wineries, images, and wine IDs for detailed lookup

**Examples:**

*Search for Bordeaux wines:*

```json
{
  "query": "Bordeaux"
}
```

*Find highly-rated Pinot Noir under $50:*

```json
{
  "query": "Pinot Noir",
  "min_rating": 4,
  "max_price": 50,
  "wine_type": "red"
}
```

*Search for Italian sparkling wines:*

```json
{
  "query": "Prosecco",
  "wine_type": "sparkling",
  "country": "it"
}
```

### Wine Details (`wine_details`)

Get full details for a specific wine including ratings, reviews, pricing, and tasting notes. Requires a wine_id from search_wines results.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `wine_id` | number | Yes | Vivino wine ID — obtained from search_wines results |
| `review_count` | number | No | Number of user reviews to include (1-10, default 5) [default: 5] |

**Returns:** Complete wine profile with ratings, user reviews, tasting notes, and flavor breakdown

**Examples:**

*Get full details for a wine by ID:*

```json
{
  "wine_id": 1520
}
```

*Get wine details with more reviews:*

```json
{
  "wine_id": 1520,
  "review_count": 10
}
```

### Top Rated Wines (`top_rated`)

Discover the highest-rated wines by type, grape, region, or price range. Great for finding quality bottles for any occasion or budget.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `wine_type` | string | No | Wine type to explore (red, white, sparkling, rose, dessert, fortified) |
| `grape` | string | No | Filter by grape variety (e.g. "Cabernet Sauvignon", "Chardonnay", "Riesling") |
| `country` | string | No | Filter by wine origin country code (e.g. "fr", "us", "it", "es", "au", "nz") |
| `min_price` | number | No | Minimum price in local currency |
| `max_price` | number | No | Maximum price in local currency |
| `min_rating` | number | No | Minimum rating threshold (default 4.0) [default: 4] |
| `limit` | number | No | Number of results (1-25, default 10) [default: 10] |
| `market` | string | No | Country code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in" [default: "us"] |
| `currency` | string | No | Currency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR" [default: "USD"] |

**Returns:** Highest-rated wines matching the filters, sorted by average rating with localized prices and regions

**Examples:**

*Top red wines under $30:*

```json
{
  "wine_type": "red",
  "max_price": 30
}
```

*Best-rated Champagne:*

```json
{
  "wine_type": "sparkling",
  "country": "fr",
  "min_rating": 4.3
}
```

*Top wines in Japan market priced in yen:*

```json
{
  "grape": "Pinot Noir",
  "market": "jp",
  "currency": "JPY"
}
```

### Price Compare (`price_compare`)

Compare prices for a specific wine across Vivino merchants. Optionally include global marketplace listings from eBay, Mercado Libre, Rakuten, and more for wider coverage.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Wine name to search and compare prices for (e.g. "Opus One 2019", "Cloudy Bay Sauvignon Blanc") |
| `include_marketplaces` | boolean | No | Also search eBay, Mercado Libre, Rakuten, Facebook Marketplace, and other global platforms for additional listings (default false) [default: false] |
| `market` | string | No | Country code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in" [default: "us"] |
| `currency` | string | No | Currency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR" [default: "USD"] |

**Returns:** Price comparison across Vivino merchants (and optionally global marketplaces) with min/max/average prices and purchase links

**Examples:**

*Compare prices for Opus One:*

```json
{
  "query": "Opus One 2019"
}
```

*Find UK prices for a Champagne:*

```json
{
  "query": "Veuve Clicquot Brut",
  "market": "gb",
  "currency": "GBP"
}
```

*Compare prices including eBay and global marketplaces:*

```json
{
  "query": "Penfolds Grange 2018",
  "include_marketplaces": true
}
```

### Tasting Profile (`tasting_profile`)

Get the detailed tasting profile for a wine — acidity, tannin, sweetness, body, and dominant flavor notes. Requires a wine_id from search results.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `wine_id` | number | Yes | Vivino wine ID — obtained from search_wines results |

**Returns:** Detailed tasting structure (acidity, tannin, sweetness, body) and dominant flavor notes grouped by category

**Examples:**

*Get the tasting profile of a wine:*

```json
{
  "wine_id": 1520
}
```

*Check flavor notes for a different wine:*

```json
{
  "wine_id": 4251
}
```

### Region Explorer (`region_explorer`)

Explore wines from a specific region or country. Browse what a region is known for and find its top bottles.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `country` | string | Yes | Wine origin country code (e.g. "fr", "us", "it", "es", "ar", "cl", "au", "nz", "za", "de", "pt", "at", "gr") |
| `wine_type` | string | No | Filter by wine type (red, white, sparkling, rose, dessert, fortified) |
| `sort_by` | string | No | Sort results by (ratings_count, ratings_average, price) [default: "ratings_average"] |
| `min_rating` | number | No | Minimum rating (default 3.5) [default: 3.5] |
| `max_price` | number | No | Maximum price in local currency |
| `limit` | number | No | Number of results (1-25, default 15) [default: 15] |
| `market` | string | No | Country code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in" [default: "us"] |
| `currency` | string | No | Currency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR" [default: "USD"] |

**Returns:** Wines from the specified region with ratings, localized prices, wineries, and grape information

**Examples:**

*Explore top French wines:*

```json
{
  "country": "fr"
}
```

*Find affordable Italian reds in euros:*

```json
{
  "country": "it",
  "wine_type": "red",
  "max_price": 25,
  "market": "de",
  "currency": "EUR"
}
```

*Best wines from New Zealand:*

```json
{
  "country": "nz",
  "sort_by": "ratings_average",
  "min_rating": 4
}
```

### Marketplace Deals (`marketplace_deals`)

Search global marketplaces for wine listings — eBay, Facebook Marketplace, Mercado Libre, Rakuten, Craigslist, Gumtree, and Carousell. Great for finding rare vintages, collectible bottles, auction deals, and wines not available through traditional retail.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Wine name or description to search for (e.g. "Penfolds Grange 2010", "vintage Burgundy", "rare Bordeaux") |
| `vintage` | string | No | Optional vintage year to narrow results (e.g. "2015", "2018") |
| `sources` | array | No | Specific marketplace sources to search (default: all wine-relevant platforms) |
| `condition` | string | No | Listing condition filter (any, new, used) [default: "any"] |
| `listing_classes` | array | No | Filter by listing type |
| `limit` | number | No | Maximum listings to return (1-25, default 15) [default: 15] |
| `market` | string | No | Country code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in" [default: "us"] |
| `currency` | string | No | Currency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR" [default: "USD"] |

**Returns:** Global marketplace listings for wine with titles, prices, sources, conditions, listing types, and direct links

**Examples:**

*Find Penfolds Grange on eBay:*

```json
{
  "query": "Penfolds Grange",
  "sources": [
    "ebay"
  ]
}
```

*Search for vintage Burgundy globally:*

```json
{
  "query": "Domaine de la Romanée-Conti",
  "vintage": "2015"
}
```

*Find wine deals in Japan on Rakuten:*

```json
{
  "query": "Opus One",
  "sources": [
    "rakuten"
  ],
  "market": "jp"
}
```

*Browse wine auctions only:*

```json
{
  "query": "rare Bordeaux",
  "listing_classes": [
    "auction"
  ]
}
```

### Food Pairing (`food_pairing`)

Get food pairing recommendations for any wine based on its tasting profile — acidity, tannin, sweetness, body, and dominant flavors. Accepts a wine_id or wine name. Returns categorized pairing suggestions with reasoning.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `wine_id` | number | No | Vivino wine ID — obtained from search_wines results |
| `query` | string | No | Wine name to look up (alternative to wine_id, e.g. "Barolo", "Sancerre", "Malbec") |
| `market` | string | No | Country code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in" [default: "us"] |
| `currency` | string | No | Currency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR" [default: "USD"] |

**Returns:** Food pairing recommendations organized by category with specific dishes and sommelier-style reasoning based on the wine's tasting profile

**Examples:**

*What food goes with this wine?:*

```json
{
  "wine_id": 1520
}
```

*Food pairings for Barolo by name:*

```json
{
  "query": "Barolo"
}
```

*Pairing suggestions for Champagne:*

```json
{
  "query": "Veuve Clicquot Brut"
}
```

### Similar Wines (`similar_wines`)

Find wines similar to a reference wine — matched by grape variety, region, price range, and rating. Great for discovering alternatives when your favorite bottle is unavailable or finding comparable wines at different price points.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `wine_id` | number | No | Vivino wine ID of the reference wine — obtained from search_wines results |
| `query` | string | No | Wine name to find alternatives for (alternative to wine_id, e.g. "Opus One", "Silver Oak Cabernet") |
| `max_price_delta` | number | No | Maximum price difference from the reference wine in local currency (e.g. 20 means ±$20) |
| `limit` | number | No | Number of similar wines to return (1-25, default 10) [default: 10] |
| `market` | string | No | Country code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in" [default: "us"] |
| `currency` | string | No | Currency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR" [default: "USD"] |

**Returns:** Similar wines ranked by match quality with grape variety, region, price, and rating similarity scores

**Examples:**

*Find wines similar to Opus One:*

```json
{
  "query": "Opus One"
}
```

*Cheaper alternatives within $15:*

```json
{
  "query": "Caymus Cabernet Sauvignon",
  "max_price_delta": 15
}
```

*Similar wines in the UK market:*

```json
{
  "query": "Cloudy Bay Sauvignon Blanc",
  "market": "gb",
  "currency": "GBP"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call wine-collector search_wines --query Bordeaux

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"wine-collector","skill":"search_wines","input":{"query":"Bordeaux"}}' \
     https://api.toolrouter.com/v1/tools/call
```

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs