wine.beyond/beyond-wine

Official11 toolsLive

by beyond

Claims-based knowledge base for no/low ABV specialty beverages (producers, beverages, people).

wine.beyond/beyond-wine MCP Server

The wine.beyond/beyond-wine Model Context Protocol (MCP) server is a claims-based knowledge base focused on no/low ABV specialty beverages. Its scope includes producers, beverages, and people, providing structured context related to this domain. The server exposes 11 tools for interacting with that knowledge base.

🛠️ Key Features

Claims-based knowledge base
Coverage for producers, beverages, and people
No/low ABV specialty beverages focus

🚀 Use Cases

Retrieve context about no/low ABV specialty beverage producers
Look up related beverage details within the knowledge base
Reference people connected to the domain

⚡ Developer Benefits

Provides 11 tools via MCP for knowledge-base interactions
Domain-specific context for no/low ABV beverage information

⚠️ Limitations

Described scope is limited to a claims-based knowledge base for no/low ABV specialty beverages (producers, beverages, people)

Captured live from the server via tools/list.

search_claims

Find published Beyond Wine claims by entity type, entity slug, claim type, or reliability class.

Parameters6

entity_type	string	optional
entity_slug	string	optional
claim_type	string	optional
reliability_class	string	optional
page	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "producer",
        "beverage",
        "person",
        "restaurant"
      ]
    },
    "entity_slug": {
      "type": "string",
      "minLength": 1
    },
    "claim_type": {
      "type": "string",
      "minLength": 1
    },
    "reliability_class": {
      "type": "string",
      "enum": [
        "primary",
        "secondary",
        "tertiary",
        "editorial"
      ]
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_claim

Retrieve a single Beyond Wine claim by claim UID, including provenance and version history.

Parameters1

claim_uid

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "claim_uid": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "claim_uid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_producers

Use this when the user asks to list, find, or filter producers by name, country, city, ingredient, or technique. Good matches include 'list producers from France' and 'find producers using sencha tea'.

Parameters8

q	string	optional
country	string	optional
region	string	optional
city	string	optional
ingredient	string	optional
technique	string	optional
page	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1
    },
    "country": {
      "type": "string",
      "minLength": 1
    },
    "region": {
      "type": "string",
      "minLength": 1
    },
    "city": {
      "type": "string",
      "minLength": 1
    },
    "ingredient": {
      "type": "string",
      "minLength": 1
    },
    "technique": {
      "type": "string",
      "minLength": 1
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_producer

Use this when the user asks about a specific producer, such as 'Who is Muri?', 'Tell me about Domaine des Grottes', or 'Fetch the producer profile for Kolonne Null'. The profile includes the producer's full published beverage lineup under data.beverages.

Parameters2

slug	string	required
condensed	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1
    },
    "condensed": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_beverages

Use this when the user asks to list, find, or filter beverages by name, producer, or category. The `q` text matches beverage names, aliases, AND producer names; use `producer` to list a producer's full lineup. Good matches include 'list sparkling beverages', 'find beverages named Pet Nat', and 'list all MURI beverages'.

Parameters5

q	string	optional
category	string	optional
producer	string	optional
page	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1
    },
    "category": {
      "type": "string",
      "minLength": 1
    },
    "producer": {
      "type": "string",
      "minLength": 1
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_beverage

Use this when the user asks about a specific beverage, such as 'Tell me about Pet Nat 0.0' or 'Fetch the beverage profile for Leitz Zero'.

Parameters2

slug	string	required
condensed	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1
    },
    "condensed": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_entity

Retrieve a published entity profile from the Beyond Wine knowledge base, with structured data and attached claims. Profiled entities (producers, beverages, people, restaurants) are independent businesses documented by Beyond Wine, not brands of it.

Parameters3

entity_type	string	required
slug	string	required
condensed	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "producer",
        "beverage",
        "person",
        "restaurant",
        "ingredient",
        "technique",
        "prepared_ingredient"
      ]
    },
    "slug": {
      "type": "string",
      "minLength": 1
    },
    "condensed": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "entity_type",
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_entities

List published entity profiles in the Beyond Wine knowledge base by type.

Parameters3

entity_type	string	required
page	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "producer",
        "beverage",
        "person",
        "restaurant",
        "ingredient",
        "technique",
        "prepared_ingredient"
      ]
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "entity_type"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_context

Retrieve a token-bounded context bundle for a Beyond Wine topic, including entity summary and optional claims or graph data.

Parameters3

topic	string	required
max_tokens	integer	optional
include	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 1
    },
    "max_tokens": {
      "default": 4000,
      "type": "integer",
      "minimum": 100,
      "maximum": 8000
    },
    "include": {
      "default": [
        "entity",
        "claims"
      ],
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "entity",
          "claims",
          "graph"
        ]
      }
    }
  },
  "required": [
    "topic"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_graph

Retrieve direct relationship neighbors for an entity profiled in the Beyond Wine knowledge base.

Parameters2

entity_type	string	required
slug	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "producer",
        "beverage",
        "person",
        "restaurant",
        "prepared_ingredient"
      ]
    },
    "slug": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "entity_type",
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ontology

Retrieve the Beyond Wine ontology, entity types, relationship types, and semantic scales.

Parameters1

format

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "format": {
      "default": "json",
      "type": "string",
      "enum": [
        "json",
        "json-schema"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (11)

search_claimsget_claimsearch_producersget_producersearch_beveragesget_beverageget_entitylist_entities

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://beyond.wine/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "beyond-wine": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://beyond.wine/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

wine.beyond/beyond-wine MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_claims

get_claim

search_producers

get_producer

search_beverages

get_beverage

get_entity

list_entities

get_context

get_graph

get_ontology

Install

Remote endpoint

Related servers