openwinemap.com

{
  "name": "search_appellations",
  "kind": "answer",
  "impl": "imperative",
  "description": "Find European wine appellations (PDO/PGI, AOC, DOC, DO, …) by name, including romanised forms of Greek and Bulgarian names. Returns slug, official name, country, region (and regions, when the appellation spans several), classification and the page URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Appellation name or part of it, e.g. \"Priorat\", \"Chablis\", \"naoussa\"."
      },
      "country": {
        "type": "string",
        "pattern": "^[a-z]{2}$",
        "description": "Optional ISO 3166-1 alpha-2 code, lower-case (fr, es, it, pt, de, at, gr, gb, …)."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "description": "Maximum results (default 20)."
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/"
}

{
  "name": "filter_appellations",
  "kind": "answer",
  "impl": "imperative",
  "description": "List wine appellations matching structured criteria: country, region, wine style, grape variety, legal scheme or traditional term. All criteria are optional and combined with AND. list_facets returns the accepted values.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "country": {
        "type": "string",
        "pattern": "^[a-z]{2}$",
        "description": "ISO 3166-1 alpha-2 code, lower-case."
      },
      "region": {
        "type": "string",
        "maxLength": 100,
        "description": "Wine region as shown on the map, e.g. \"Bourgogne\", \"Catalunya\", \"Mosel\"."
      },
      "style": {
        "type": "string",
        "maxLength": 100,
        "description": "Wine style slug or label, e.g. \"red\", \"white\", \"rose\", \"sparkling\", \"sweet\", \"fortified\", \"vin-jaune\"."
      },
      "grape": {
        "type": "string",
        "maxLength": 100,
        "description": "Grape variety name or slug, e.g. \"Garnacha\", \"pinot-noir\". Synonyms of the same VIVC variety are included."
      },
      "main_grape_only": {
        "type": "boolean",
        "description": "Only match the grape among the principal varieties (default false)."
      },
      "scheme": {
        "type": "string",
        "maxLength": 50,
        "description": "Legal scheme (pdo, pgi, spirit-gi, uk-pdo, uk-pgi, none) or traditional term (aoc, docg, doc, igt, doca, doq, dac, …; \"it:doc\" to name one country's)."
      },
      "include_sub_denominations": {
        "type": "boolean",
        "description": "Include sub-denominations (DGCs, subzonas, sottozone, crus); default false."
      },
      "include_spirits": {
        "type": "boolean",
        "description": "Include spirit-drink and cider GIs; default false."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 200,
        "description": "Maximum results (default 50)."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_appellation",
  "kind": "answer",
  "impl": "imperative",
  "description": "Full record of one wine appellation by slug: grape varieties (principal / accessory), wine styles, terroir facts with their provenance, source documents and the attribution to give when quoting it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "pattern": "^[a-z0-9-]{1,120}$",
        "description": "Appellation slug, as returned by search_appellations."
      }
    },
    "required": [
      "slug"
    ]
  },
  "page": "/"
}

{
  "name": "list_facets",
  "kind": "answer",
  "impl": "imperative",
  "description": "The values filter_appellations accepts, with appellation counts: countries, wine regions, wine styles, and legal schemes / traditional terms. Counts cover wine appellations, not sub-denominations or spirits.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "show_appellation",
  "kind": "act",
  "impl": "imperative",
  "description": "Open an appellation on the map: shows its detail panel and frames its area. Use after search_appellations when the user wants to see it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "pattern": "^[a-z0-9-]{1,120}$",
        "description": "Appellation slug, as returned by search_appellations."
      }
    },
    "required": [
      "slug"
    ]
  },
  "page": "/"
}