Wine Collector
Wine prices, ratings, and tasting profiles
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.
Search Wines
Search for wines by name, grape variety, region, or style. Returns matching wines with ratings, prices, and wine IDs for detailed lookup.
Returns: List of matching wines with names, ratings, localized prices, regions, wineries, images, and wine IDs for detailed lookup
Parameters
query *stringWine name, grape variety, or keyword to search for (e.g. "Chateau Margaux 2015", "Pinot Noir", "Barolo")
wine_typestringFilter by wine type
min_ratingnumberMinimum average rating (1.0-5.0, default 1.0)
max_pricenumberMaximum price in local currency
min_pricenumberMinimum price in local currency
countrystringFilter by wine origin country code (e.g. "fr", "us", "it", "es", "au")
sort_bystringHow to sort results
limitnumberNumber of results to return (1-25, default 10)
pagenumberPage number for pagination (default 1)
marketstringCountry code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in"
currencystringCurrency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR"
Example
Search for Bordeaux wines
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "wine-collector",
"skill": "search_wines",
"input": {
"query": "Bordeaux"
}
}' \
https://api.toolrouter.com/v1/tools/callWine Details
Get full details for a specific wine including ratings, reviews, pricing, and tasting notes. Requires a wine_id from search_wines results.
Returns: Complete wine profile with ratings, user reviews, tasting notes, and flavor breakdown
Parameters
wine_id *numberVivino wine ID — obtained from search_wines results
review_countnumberNumber of user reviews to include (1-10, default 5)
Example
Get full details for a wine by ID
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "wine-collector",
"skill": "wine_details",
"input": {
"wine_id": 1520
}
}' \
https://api.toolrouter.com/v1/tools/callTop Rated Wines
Discover the highest-rated wines by type, grape, region, or price range. Great for finding quality bottles for any occasion or budget.
Returns: Highest-rated wines matching the filters, sorted by average rating with localized prices and regions
Parameters
wine_typestringWine type to explore
grapestringFilter by grape variety (e.g. "Cabernet Sauvignon", "Chardonnay", "Riesling")
countrystringFilter by wine origin country code (e.g. "fr", "us", "it", "es", "au", "nz")
min_pricenumberMinimum price in local currency
max_pricenumberMaximum price in local currency
min_ratingnumberMinimum rating threshold (default 4.0)
limitnumberNumber of results (1-25, default 10)
marketstringCountry code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in"
currencystringCurrency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR"
Example
Top red wines under $30
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "wine-collector",
"skill": "top_rated",
"input": {
"wine_type": "red",
"max_price": 30
}
}' \
https://api.toolrouter.com/v1/tools/callPrice Compare
Compare prices for a specific wine across merchants to find the best deal. Shows price range, merchant names, and direct purchase links.
Returns: Price comparison across merchants with min/max/average prices, merchant names, and purchase links in local currency
Parameters
query *stringWine name to search and compare prices for (e.g. "Opus One 2019", "Cloudy Bay Sauvignon Blanc")
marketstringCountry code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in"
currencystringCurrency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR"
Example
Compare prices for Opus One
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "wine-collector",
"skill": "price_compare",
"input": {
"query": "Opus One 2019"
}
}' \
https://api.toolrouter.com/v1/tools/callTasting Profile
Get the detailed tasting profile for a wine — acidity, tannin, sweetness, body, and dominant flavor notes. Requires a wine_id from search results.
Returns: Detailed tasting structure (acidity, tannin, sweetness, body) and dominant flavor notes grouped by category
Parameters
wine_id *numberVivino wine ID — obtained from search_wines results
Example
Get the tasting profile of a wine
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "wine-collector",
"skill": "tasting_profile",
"input": {
"wine_id": 1520
}
}' \
https://api.toolrouter.com/v1/tools/callRegion Explorer
Explore wines from a specific region or country. Browse what a region is known for and find its top bottles.
Returns: Wines from the specified region with ratings, localized prices, wineries, and grape information
Parameters
country *stringWine origin country code (e.g. "fr", "us", "it", "es", "ar", "cl", "au", "nz", "za", "de", "pt", "at", "gr")
wine_typestringFilter by wine type
sort_bystringSort results by
min_ratingnumberMinimum rating (default 3.5)
max_pricenumberMaximum price in local currency
limitnumberNumber of results (1-25, default 15)
marketstringCountry code for localized prices (default "us"). E.g. "gb", "fr", "de", "jp", "au", "sg", "hk", "kr", "br", "za", "ae", "in"
currencystringCurrency code for prices (default "USD"). E.g. "GBP", "EUR", "JPY", "AUD", "SGD", "HKD", "KRW", "BRL", "ZAR", "AED", "INR"
Example
Explore top French wines
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "wine-collector",
"skill": "region_explorer",
"input": {
"country": "fr"
}
}' \
https://api.toolrouter.com/v1/tools/callQuick Start
MCP (Claude Code)
claude mcp add --transport stdio \
--env TOOLROUTER_API_KEY=YOUR_API_KEY \
toolrouter -- npx -y toolrouter-mcpREST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{"tool":"wine-collector","skill":"search_wines","input":{}}' \
https://api.toolrouter.com/v1/tools/call