Back to the catalog

io.github.MrBridgeHQ/mcp-server-vivino

Vivino wine data for AI assistants: search, explore, wine details and meal-aware recommendations

Open source Repository Open in the app JSON README (API)

About

Vivino wine data for AI assistants: search, explore, wine details and meal-aware recommendations

Details

Kind
MCP servers
Topic
No topic detected
Publisher
mrbridgehq
Origin
official
Category
ferramentas
Transport
sse
Version
1.0.0
Last push
2026-07-05T13:08:39Z
Repository state
ativo
License
MIT
Added
2026-08-29 03:02:06
Updated
2026-08-29 03:02:06
Origin id
io.github.MrBridgeHQ/mcp-server-vivino

README

# Vivino MCP Server

> AI wine recommendations via MCP: search Vivino, explore by rating, price and style, fetch full wine details and get meal-aware bottle suggestions in Claude or ChatGPT.

**[Try it on Apify Store](https://apify.com/mrbridge/vivino-mcp-server?fpr=mrbridge)** | Pay-per-event | Free tier available

## Features

- **4 MCP tools**: search, explore, wine details, recommendations
- Vivino ratings, prices, taste profiles and vintages
- Meal, budget and occasion-aware bottle recommendations
- Filter by rating, price, style, region and type
- **No Vivino account or API key required**, only your Apify token
- Stateless transport: every request is independent, no session to manage
- Works with **Claude Desktop, Claude Code, ChatGPT, Cursor** and any MCP-compatible client

## Quick Start

1. **[Open the Actor on Apify](https://apify.com/mrbridge/vivino-mcp-server?fpr=mrbridge)** and get your free API token
2. Connect your AI client using the MCP endpoint below
3. Ask for a wine in plain language

### Claude Desktop

Go to **Settings > MCP Servers > Add Custom Connector** and paste:

```
https://mrbridge--vivino-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN
```

## Example Prompts

- *"Find me a highly rated Chateauneuf-du-Pape under $50"*
- *"What red goes with grilled lamb on a $40 budget?"*
- *"Top-rated natural reds from the Loire under $30"*
- *"Compare these two Riojas: ratings, prices and taste profiles"*
- *"Recommend a bottle for a seafood dinner, around $25"*

## Available Tools

| Tool | Description |
|------|-------------|
| `search_wines` | Search Vivino for wines by name, winery, or keyword |
| `explore_wines` | Filter and explore wines by rating, price, style, region, and type |
| `get_wine_details` | Full details for a wine: rating, price, taste profile, and vintages |
| `recommend_wines` | Recommend bottles for a meal, budget, or occasion |

## Pricing

Pay-per-event: you only pay for the tools you actually use. The Apify free tier gives you **$5 free credits every month**, enough for hundreds of tool calls.

## Links

- **Apify Store**: [Vivino MCP Server](https://apify.com/mrbridge/vivino-mcp-server?fpr=mrbridge)
- **Full documentation**: [mr-bridge.com/solutions/vivino-mcp-server](https://mr-bridge.com/solutions/vivino-mcp-server)
- **All MrBridge MCP servers**: [mr-bridge.com/mcp-servers](https://mr-bridge.com/mcp-servers)
- **Open wine datasets**: [mr-bridge.com/datasets](https://mr-bridge.com/datasets)
- **Author**: [mrbridge on Apify](https://apify.com/mrbridge?fpr=mrbridge)

## Related Solutions

- [Vivino Wine Data Scraper](https://apify.com/mrbridge/vivino-wine-data-scraper?fpr=mrbridge): bulk ratings, prices and taste profiles from a wine list
- [Wine-Searcher Scraper](https://apify.com/mrbridge/wine-searcher-scraper-from-list?fpr=mrbridge): scores, prices and popularity, LWIN-aware
- [Millesima Wine Scraper](https://apify.com/mrbridge/millesima-wine-scraper?fpr=mrbridge): prices, vintages and critic ratings from 8 publications

---

*Built by [MrBridge](https://mr-bridge.com), we bridge Data and Intelligence.*

More