
Public wine registry and guides: search wines, grapes, regions, appellations. No account.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Given a registry wine_id (or, on an authenticated connection, one of the user's bottle_ids), returns wines with the closest taste/style profile from the shared registry, using vector similarity over wine embeddings. Call for "more like this", "what else is like my favourite Barolo", or to seed purchase ideas from a wine the user loves. Only wines that have been embedded are searchable — an empty result does not mean nothing similar exists. Ids must be 24-hex Mongo ids from search_registry or search_bottles — a name or slug is not an id. Returns at most 10.
How many to return (1-10, default 8; larger values are capped, not rejected)
Registry wine id (24-hex) from search_registry or a bottle's wine
Alternatively: one of the user's bottle ids (24-hex). Needs an authenticated connection — not available on the public endpoint.
Tool list last changed Oct 25, 2026.
Given a registry wine_id (or, on an authenticated connection, one of the user's bottle_ids), returns wines with the closest taste/style profile from the shared registry, using vector similarity over wine embeddings. Call for "more like this", "what else is like my favourite Barolo", or to seed purchase ideas from a wine the user loves. Only wines that have been embedded are searchable — an empty result does not mean nothing similar exists. Ids must be 24-hex Mongo ids from search_registry or search_bottles — a name or slug is not an id. Returns at most 10.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many to return (1-10, default 8; larger values are capped, not rejected) |
| wine_id | string | Registry wine id (24-hex) from search_registry or a bottle's wine |
| bottle_id | string | Alternatively: one of the user's bottle ids (24-hex). Needs an authenticated connection — not available on the public endpoint. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "How many to return (1-10, default 8; larger values are capped, not rejected)"
},
"wine_id": {
"type": "string",
"description": "Registry wine id (24-hex) from search_registry or a bottle's wine"
},
"bottle_id": {
"type": "string",
"description": "Alternatively: one of the user's bottle ids (24-hex). Needs an authenticated connection — not available on the public endpoint."
}
}
}Returns what Cellarion is, the version this instance is running, the open-source repository, and the license. Call this when the user asks what Cellarion is, which version they are on, whether it is open source, where to find / contribute to the code — or how to support the project.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Full registry record for one wine: producer, region, appellation, classification, grapes, community rating, the AI tasting profile when the wine has been enriched, and the registry image (url + credit) when one is published — null means the wine has no public picture yet; to see the picture yourself, call get_photo with the wine_id. Vintage-neutral (bottles carry the vintage). For signed-in callers, pending_correction says whether a correction suggestion is awaiting review on this wine (one is allowed per wine, across all users), which fields it covers and whether it is the caller's own — check it before composing suggest_wine_correction. Call after search_registry when the user wants depth on a specific wine.
| Argument | Type | Description |
|---|---|---|
| wine_id* | string | Registry wine id from search_registry or a bottle's wine |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wine_id"
],
"properties": {
"wine_id": {
"type": "string",
"description": "Registry wine id from search_registry or a bottle's wine"
}
}
}Cellarion's published guides and blog articles (cellar management, drink windows, storage, buying) — title, slug, excerpt and tags. Call when the user wants a how-to or background reading; follow with read_guide for the full text.
| Argument | Type | Description |
|---|---|---|
| tag | string | Filter by tag |
| limit | integer | How many to return (1-20, default 10; larger values are capped, not rejected) |
| offset | integer | Skip this many (default 0) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tag": {
"type": "string",
"maxLength": 40,
"description": "Filter by tag"
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "How many to return (1-20, default 10; larger values are capped, not rejected)"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Skip this many (default 0)"
}
}
}The full text of one published Cellarion guide or blog article, by slug (from list_guides). Public website content — quote or summarise freely, and link the public_url when pointing the user to it.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Article slug from list_guides |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Article slug from list_guides"
}
}
}Searches Cellarion's shared wine database (vintage-neutral wines, community data) by name, producer, region or grape. Returns up to 10 matches. Call to identify a wine the user mentions, before recommending, or to check whether a wine exists in the registry. This searches ALL known wines — use search_bottles for what the user owns. A signed-in user's own drinks that are not wine (beer, cider, soft drinks — hidden from the shared registry) are listed first with only_in_your_cellar: true, so they can add more of them.
| Argument | Type | Description |
|---|---|---|
| query* | string | Wine name, producer, appellation or grape |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "Wine name, producer, appellation or grape"
}
}
}