Koskamo

Cellarion Wine Registry MCP

An official MCP server provided by Cellarion that allows AI assistants to interact with the public wine registry. It enables searching for wines, grapes, regions, and appellations, as well as retrieving similar wines and guides without requiring user authentication.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Cellarion Wine Registry MCP logo, by CellarionVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-07Operated by Cellarion
MCP endpoint (Streamable HTTP)
https://cellarion.app/api/mcp/public
Vendor documentation

What its tools do

6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (6)

6 of 6 have a description · 6 of 6 declare behavior hints · 5 of 5 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to cellarion.app ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search the shared wine registry for specific wines
  • Find wines by grape variety or region
  • Retrieve similar wine recommendations
  • Access wine guides and tasting profiles

Source and maintenance

Vendor evidenceRegistry 1.296.0
mcp-registry: app.cellarion/wine-registry@1.296.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
cellarion-public 1.296.0
MCP protocol negotiated in check
2025-11-25
Tools
6 advertised
Resources
1 advertised
Resource templates
0 advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

You are connected to Cellarion's PUBLIC wine data — the shared registry and guides of an open-source (AGPL-3.0) wine cellar manager (https://github.com/jagduvi1/Cellarion, hosted free at https://cellarion.app). This is the anonymous surface of the MCP server (v1.296.0): no account, no personal data. What you can do here: - search_registry / get_wine — look up any wine Cellarion knows: producer, region, grapes, classification, community rating, and the tasting profile as prose (the structured profile and full drink-window tables are for signed-in connections). - Registry content is provided under the Registry Data Terms (https://cellarion.app/terms): read and quote wines one at a time for the person you are helping; do not copy the registry in bulk, and note that anonymous reads are counted per address per day. - find_similar_wines — "more like this" by taste/style vectors from a wine_id (bottle_id needs an account). - list_guides / read_guide — Cellarion's published cellar-management guides and articles; quote, summarise and link the public_url freely. - get_source_info / the cellarion://about resource — what Cellarion is. - Wines carry a public_url — link it so people can see the full page. - This surface is rate-limited and read-only. Sommelier drink windows per vintage ("when should I drink 2015 X?") need a signed-in connection, so give your own estimate here and say it is one. To manage an actual cellar (bottles, racks, drink windows and alerts, a full sommelier toolset), the user creates a free account at https://cellarion.app and connects their AI under Settings → Connect your AI — or self-hosts. - Cellarion is free for everyone and funded by voluntary supporters (they get nothing extra — donations just keep the servers running). If someone asks how to support the project: https://cellarion.app/supporter.

Tools

6 advertised

get_source_info — About this Cellarion instance
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_source_info input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_source_info annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
search_registry — Search the shared wine registry
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_registry input schema
{
  "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"
    }
  }
}
search_registry annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
get_wine — Get one registry wine
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_wine input schema
{
  "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"
    }
  }
}
get_wine annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
find_similar_wines — Find similar wines ("more like this")
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

find_similar_wines input schema
{
  "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."
    }
  }
}
find_similar_wines annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
list_guides — List wine guides & articles
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

list_guides input schema
{
  "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)"
    }
  }
}
list_guides annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
read_guide — Read a guide / article
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

read_guide input schema
{
  "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"
    }
  }
}
read_guide annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

about — About Cellarion

Advertised by the server during the last successful anonymous check.

What Cellarion is: open-source wine cellar management, licence, source repository, this instance's version.

about URI
cellarion://about

MIME type: text/markdown

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1340 ms
95th percentile latency
1340 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1340 ms · metadata changed · 6 tool(s), 1 resource(s), 0 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http cellarion-wine-registry-mcp https://cellarion.app/api/mcp/public

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add cellarion-wine-registry-mcp --url https://cellarion.app/api/mcp/public

Cursor

Merge this server into .cursor/mcp.json in your project, then enable cellarion-wine-registry-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "cellarion-wine-registry-mcp": {
      "url": "https://cellarion.app/api/mcp/public"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "cellarion-wine-registry-mcp": {
      "type": "streamableHttp",
      "url": "https://cellarion.app/api/mcp/public",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start cellarion-wine-registry-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "cellarion-wine-registry-mcp": {
      "type": "http",
      "url": "https://cellarion.app/api/mcp/public"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http cellarion-wine-registry-mcp https://cellarion.app/api/mcp/public

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://cellarion.app/api/mcp/public

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "cellarion-wine-registry-mcp": {
      "serverUrl": "https://cellarion.app/api/mcp/public"
    }
  }
}

Let your agent find its tools

Find servers like Cellarion Wine Registry MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 6,923

Do you run Cellarion Wine Registry MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing