alcostore.pl

{
  "name": "search_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the alcostore alcohol catalog by free-text query. Returns matching products with prices, availability and slugs usable with the view_product and add_to_cart tools. Works for signed-in and anonymous users. alcostore sells alcoholic beverages — all products are restricted to adults (18+). Requires a delivery address; if this tool returns address_required, call set_delivery_address. Availability and prices depend on the delivery address.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search phrase, e.g. \"jogurt naturalny\"."
      },
      "limit": {
        "type": "number",
        "description": "Maximum number of results (default 10, max 50)."
      },
      "offset": {
        "type": "number",
        "description": "Number of results to skip — use for pagination, e.g. offset=10 with limit=10 for the second page (default 0)."
      }
    },
    "required": [
      "query"
    ]
  }
}

{
  "name": "list_categories",
  "kind": "answer",
  "impl": "imperative",
  "description": "List alcostore product categories. Without parentKey returns the top-level categories; with parentKey returns its direct subcategories. Use list_category_products to browse the products of a category. Category keys can be browsed on the site at /kategorie/{key}. Requires a delivery address; if this tool returns address_required, call set_delivery_address. Availability and prices depend on the delivery address.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "parentKey": {
        "type": "string",
        "description": "Optional category key whose direct subcategories should be listed, e.g. \"nabial\"."
      }
    }
  }
}

{
  "name": "list_category_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the products of a alcostore category with pagination. Use list_categories to discover category keys. Returns products with prices, availability and slugs usable with the view_product and add_to_cart tools. Requires a delivery address; if this tool returns address_required, call set_delivery_address. Availability and prices depend on the delivery address.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "categoryKey": {
        "type": "string",
        "description": "Category key, e.g. \"nabial\" — from list_categories results."
      },
      "limit": {
        "type": "number",
        "description": "Maximum number of results (default 10, max 50)."
      },
      "offset": {
        "type": "number",
        "description": "Number of products to skip — use for pagination, e.g. offset=10 with limit=10 for the second page (default 0)."
      }
    },
    "required": [
      "categoryKey"
    ]
  }
}

{
  "name": "view_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Fetch full details of a alcostore product by its slug (e.g. from search_products or category listings): price, promotion, availability, ingredients, allergens and other attributes. Requires a delivery address; if this tool returns address_required, call set_delivery_address. Availability and prices depend on the delivery address.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "Product slug in the form {SKU}-{name-kebab-case}, e.g. \"A0023673-zott-jogurt-naturalny\"."
      }
    },
    "required": [
      "slug"
    ]
  }
}

{
  "name": "view_cart",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the user's current alcostore shopping cart: line items with quantities and prices, plus the cart total. Requires a delivery address; if this tool returns address_required, call set_delivery_address. Availability and prices depend on the delivery address.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "add_to_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Add a product to the user's alcostore cart by SKU. Works for signed-in and anonymous users; the cart is created automatically on first add. Alcohol can only be sold to adults (18+). The user must be of legal age; ID is verified at delivery. Requires a delivery address; if this tool returns address_required, call set_delivery_address. Availability and prices depend on the delivery address.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sku": {
        "type": "string",
        "description": "Product SKU, e.g. \"A0023673\" (from search_products or view_product)."
      },
      "quantity": {
        "type": "number",
        "description": "How many units to add. Positive integer, default 1, max 50."
      }
    },
    "required": [
      "sku"
    ]
  }
}

{
  "name": "set_delivery_address",
  "kind": "act",
  "impl": "imperative",
  "description": "Set or change the delivery address. If no address is set yet, opens the address dialog for the user to confirm one (it cannot be set autonomously); if an address is already set, reports that and makes no change. A delivery address is required before the other tools work.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}