Cellarion Wine Registry
Public wine registry and guides: search wines, grapes, regions, appellations. No account.
| Endpoint | https://cellarion.app/api/mcp/public (streamable-http) |
|---|---|
| Registry version | 1.82.4 |
| Now | 6 tools · grade A (98) · pin ts_b9b4912dc86b663a3fcf76e6ef38299f · protocol 2025-06-18 |
| First / last listed | 2026-11-01 00:45 UTC / 2026-11-01 00:45 UTC |
| Grade over time | 2026-11-01: A (98), 6 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_source_info search_registry get_wine find_similar_wines list_guides read_guide
get_source_info | 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. params: none |
search_registry | 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 params: query* |
get_wine | 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 caller params: wine_id* |
find_similar_wines | 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 r params: wine_id, bottle_id, limit |
list_guides | 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. params: tag, limit, offset |
read_guide | 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. params: slug* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.