{
  "name": "arvi-catalog-mcp",
  "title": "ARVI Wine Catalog",
  "description": "Read-only Model Context Protocol server for the catalog of ARVI SA (arvi.ch), Swiss merchant of fine and rare wines. Search, facets, vintage verticals, similar-product suggestions and product details, in en/fr/de. No authentication.",
  "version": "1.9.2",
  "protocolVersions": [
    "2025-06-18",
    "2025-03-26",
    "2024-11-05"
  ],
  "transports": [
    {
      "type": "streamable-http",
      "url": "https://mcp.arvi.ch/"
    }
  ],
  "authentication": {
    "type": "none"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "tools": [
    {
      "name": "search_shop_catalog",
      "title": "Search the ARVI wine catalog",
      "description": "Search ARVI SA\u0027s catalog of fine and rare wines and spirits. Free-text query plus optional filters (price range, producer, vintage, category, availability). Returns paginated products with prices in CHF and a \u0027link\u0027 URL where the product can be viewed and purchased on arvi.ch. All results are ARVI\u0027s own physical stock, stored in climate-controlled cellars; in-stock items deliver within 48 hours anywhere in Switzerland.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Free-text search over title, producer, category and description, e.g. \u0027Barolo 2019\u0027 or \u0027Sauternes\u0027."
          },
          "locale": {
            "type": "string",
            "description": "Catalog language code, e.g. \u0027en\u0027. Defaults to \u0027en\u0027."
          },
          "min_price": {
            "type": "number",
            "description": "Minimum price (CHF)."
          },
          "max_price": {
            "type": "number",
            "description": "Maximum price (CHF)."
          },
          "producer": {
            "type": "string",
            "description": "Filter by producer / brand, e.g. \u0027Gaja\u0027."
          },
          "vintage": {
            "type": "integer",
            "description": "Filter by vintage year, e.g. 2019."
          },
          "category": {
            "type": "string",
            "description": "Filter by category, region or country substring, e.g. \u0027Wine\u0027, \u0027Accessories\u0027, \u0027Piemonte\u0027, \u0027Bordeaux\u0027, \u0027Italy\u0027. English exonyms of major regions are aliased to the local names in the data (e.g. \u0027Piedmont\u0027 matches \u0027Piemonte\u0027). Coverage of region/country depends on feed data."
          },
          "in_stock_only": {
            "type": "boolean",
            "description": "Only products currently available. Default true."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "description": "Max results per page. Default 10."
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "description": "Pagination offset. Default 0."
          }
        },
        "required": []
      }
    },
    {
      "name": "get_catalog_facets",
      "title": "Catalog overview (facets)",
      "description": "Aggregated view of the ARVI catalog: top producers, countries, regions and categories, vintage range and distribution by decade, price bands (CHF) and bottle formats, all with product counts. Call this first to learn what exists before searching.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "locale": {
            "type": "string",
            "description": "Catalog language code. Defaults to \u0027en\u0027."
          },
          "in_stock_only": {
            "type": "boolean",
            "description": "Compute facets over available products only. Default true."
          }
        },
        "required": []
      }
    },
    {
      "name": "get_wine_vintages",
      "title": "Vintages \u0026 formats of one wine",
      "description": "The full vertical for a single wine: every vintage and bottle format ARVI lists for it, each with price and availability (out-of-stock entries included for completeness). Identify the wine by product id or by name.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "A product id of any vintage/format of the wine."
          },
          "query": {
            "type": "string",
            "description": "Wine name, e.g. \u0027Sassicaia\u0027 (used if no id is given)."
          },
          "locale": {
            "type": "string",
            "description": "Catalog language code. Defaults to \u0027en\u0027."
          }
        },
        "required": []
      }
    },
    {
      "name": "find_similar_products",
      "title": "Alternatives to a product",
      "description": "Alternatives for a given product id: other available vintages/formats of the same wine, other wines by the same producer, and comparable in-stock wines from the same region/category in a similar price range. Use it when the requested bottle is out of stock or to propose options.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Reference product id."
          },
          "locale": {
            "type": "string",
            "description": "Catalog language code. Defaults to \u0027en\u0027."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "description": "Max results per section. Default 8."
          }
        },
        "required": [
          "id"
        ]
      }
    },
    {
      "name": "get_product_details",
      "title": "Get one product",
      "description": "Full details for a single product by its catalog id (as returned by search_shop_catalog), including description and purchase link.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Product id from search results."
          },
          "locale": {
            "type": "string",
            "description": "Catalog language code. Optional."
          }
        },
        "required": [
          "id"
        ]
      }
    },
    {
      "name": "get_shop_info",
      "title": "About the shop",
      "description": "Static information about ARVI SA (currency, contact, how to purchase) plus live catalog statistics.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": []
      }
    }
  ],
  "associatedDomains": [
    "https://arvi.ch",
    "https://www.arvi.ch"
  ],
  "provider": {
    "name": "ARVI SA",
    "website": "https://arvi.ch",
    "phone": "\u002B41 91 649 68 88"
  },
  "products": 104536
}