MCP server that fetches wine information from Vivino
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"vivino-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# vivino-mcp An MCP server that fetches wine information from [Vivino](https://www.vivino.com) via its unofficial JSON API. > ⚠️ Vivino has **no official public API**. This server calls internal endpoints > the website uses. It is intended for personal / educational use. Respect > Vivino's Terms of Service and keep request volume low (the server caches and > throttles by default). Endpoints may change without notice. ## Tools | Tool | Description | |------|-------------| | `search_wine(query, limit)` | Search wines by name (full catalog, via Vivino's Algolia index — finds wines with no marketplace listing too). | | `search_by_filters(wine_type, country, min_rating, price_min, price_max, limit)` | Discover/recommend wines by filters, with marketplace prices (via explore). | | `get_wine_details(vintage_id)` | Full details for a vintage incl. taste structure (tannin/acidity/sweetness/intensity) and flavor profile. | | `get_wine_reviews(wine_id, year, limit)` | User reviews for a wine. | | `list_wine_types()` | Supported wine types and their Vivino ids. | IDs flow naturally: a search result gives you `vintage_id` (for details) and `wine_id` (for reviews). `search_wine` / `search_by_filters` return `{total_matched, returned, note, results}`. `total_matched` is how many wines Vivino reports for the query; `results` is a ranked, paginated list capped at `limit` (not the full catalog). ## Install (for users) ### Claude Desktop — one-click Download `vivino-mcp.mcpb` from the [latest release](https://github.com/carrtesy/vivino-mcp/releases) and double-click it (or **Settings → Extensions → Install from file**). Requires [uv](https://docs.astral.sh/uv/) on your machine. ### Any MCP client — via uvx No clone needed; `uvx` fetches the package from PyPI automatically: ```json { "mcpServers": { "vivino": { "command": "uvx", "args": ["vivino-mcp"] } } } ``` Optional env: `VIVINO_CURRENCY` (default `USD`), `VIVINO_COUNTRY` (default `us`). ## De…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.