add_to_cart
ChatGPTAdd a product to the authenticated user's personal cart by SKU, or set its exact quantity. mode "add" (default) appends quantity (default 1) to the existing line; mode "set" makes the line exactly quantity (0 removes it). Creates a personal cart when there is none; business carts are never changed, and prices are personal. Confirm the exact product and quantity with the user BEFORE calling — never add on a guess. Returns the updated cart summary. This cannot buy anything: checkout and payment happen on elko.is. The result includes cart_url — share it so the user can review the cart and check out.
add_to_wishlist
ChatGPTSave a product to the authenticated user's wishlist by SKU. Idempotent — saving an already-saved SKU is not an error. NB the wishlist holds at most 100 items and silently drops the OLDEST beyond that. Returns the updated wishlist (with wishlist_url).
cancel_restock_alert
ChatGPTCancel the authenticated user's restock alert for a SKU. 404 in the result means no active alert existed. Works even if the product has since been delisted.
category_details
ChatGPTFetch the ELKO category catalog (Icelandic). Returns id, name, absolute URL, hierarchy path (root > ... > leaf), parent_id, and product_count. Single channel. Full catalog is ~300 rows; pass category_ids to narrow. Includes empty/parent categories for full hierarchy. Cached server-side for 30 minutes.
display_products
ChatGPTDISPLAY one or more products to the user as cards in the chat — a detail card for a single SKU, a scrollable grid for several. Pass the SKUs you have chosen to present (1-20). Cards keep the order of product_skus, so pass SKUs in the order you want them shown (related items adjacent). This is the ONLY tool that shows products visually; search_products and product_details return data only. Call it whenever you recommend or present specific products — showing them visually is expected, not optional, and describing them in text alone is incomplete (skip only when you are merely answering a factual question, not putting a product in front of the user). Each card already shows top product features automatically; you may optionally attach a labels entry per SKU (a short badge and/or one-line note, Icelandic) to override that for specific cards.
my_cart
ChatGPTReturn a summary of the authenticated user's personal cart in the current channel: channel, currency, email, lines (sku/quantity/totalPrice), quantity, subTotalPrice, shippingPrice, totalPrice. Business carts are never included, and prices are personal even when a business is selected on elko.is. Returns {checkout: null} when the user has no personal cart. Price calculation may remove cart lines that can no longer be priced. The result includes cart_url — share it when the user wants to review the cart or check out.
my_orders
ChatGPTReturn the authenticated user's 20 most recent ONLINE orders, newest first: url, number, created, total, currency and lines (sku/productName/quantity/totalPrice). Each url is the order's page on elko.is — share it when the user wants to see the order. The page only works for the user signed in on the site; anyone else gets a 404, so if the user reports a 404, tell them to log in on elko.is first. Use this for "what did I buy" and to confirm an order went through. Only covers orders placed on elko.is or dutyfree.elko.is. Anything bought in an ELKO shop is NOT here, so if the user is looking for a purchase you cannot find, say it may have been an in-store purchase rather than telling them it does not exist. Read-only: it cannot place, change or cancel an order, and it knows nothing about delivery progress — send "where is my order" and any change to ELKO customer service. The result includes receipts_url — the receipts page on the site, which also covers in-store purchases.
my_restock_alerts
ChatGPTReturn the back-in-stock alerts the authenticated user is subscribed to (sku and name per alert), oldest first. An empty list means no active alerts. Read-only; use notify_when_back_in_stock / cancel_restock_alert (when available) to change them.
my_wishlist
ChatGPTReturn the authenticated user's wishlist in the current channel, newest first: sku, name, price (ISK) and inStock per item. An empty list means nothing saved. Read-only; use add_to_wishlist / remove_from_wishlist (when available) to change it. The result includes wishlist_url — share it when the user wants to see the wishlist on the site.
notify_when_back_in_stock
ChatGPTSubscribe the authenticated user to a one-time email when the SKU is back in stock. Only possible while the product is OUT of stock and not end-of-life — check availability with product_details first; an in-stock SKU returns a 400 telling you to add it to the cart instead. Idempotent: re-subscribing re-arms the alert and removes duplicate subscriptions for this user and SKU.
price_history
ChatGPTFetch the price history (the storefront "Verðsaga") for one product SKU, or up to 20 SKUs in a SINGLE call, in ISK. Use this to answer "is it on sale", "has the price dropped", "what is the lowest it has been", or to compare several products at once. Pass skus (an array, up to 20) to fetch many in one call — prefer this over calling the tool repeatedly. Pass sku for a single product. Returns the price-change history — only the dates the price actually changed (consecutive same-price days are collapsed, not daily noise) — plus a summary: current, lowest, highest, is_on_sale, price_unchanged_since, and the date window. current is the latest snapshot, so its date can be later than the last change point when the price has held; price_unchanged_since is the date the current price took effect. Each recorded price is the value at the END of that day (one snapshot per day, not intraday). A single-SKU call returns sku + history at the top level; a multi-SKU call returns results_by_sku (keyed by SKU) plus not_found. The disclaimer field is the exact wording shown on the site, in ICELANDIC — present it with the price history; translate it for non-Icelandic users.
product_details
ChatGPTFetch detailed product information for one or more products by their SKUs. Returns structured data including pricing (ISK), availability, attributes, and descriptions. Maximum 30 SKUs per request. Product data is in Icelandic. Availability includes PER-STORE stock (inventory_status keyed by store name, plus may_be_on_display_in_these_stores) — use this tool to answer "is it in stock in <store>" or "can I pick it up today". Each result carries lifecycle_status: "discontinued" means no NEW stock will arrive — never suggest waiting for a restock. Remaining units can still be bought and may move between the warehouse and stores, so check availability.inventory_status before calling one unavailable; an out-of-stock "active" product may be restocked. This returns DATA for your reasoning or comparison and shows nothing to the user — to display products as cards, call display_products with the SKUs. Each result also includes variant_siblings — the product's OTHER variants ({sku, name, available}); each variant's NAME carries its distinguishing colour/size, and available means offered in the channel. Use it to answer 'which colours/sizes' or 'which variants are available'; for a specific variant's full price/stock, call product_details on that sibling's SKU.
remove_from_cart
ChatGPTRemove a product line from the authenticated user's personal cart by SKU; business carts are never changed. Returns the updated cart summary (with cart_url); 404 in the result means the SKU was not in the personal cart. Confirm with the user before removing.
remove_from_wishlist
ChatGPTRemove a product from the authenticated user's wishlist by SKU. Returns the updated wishlist (with wishlist_url); 404 in the result means the SKU was not on it.
search_products
ChatGPTSearch the ELKO product catalog in natural language and get ranked product matches back as DATA (Icelandic catalog). Combines keyword and semantic (vector) search via Algolia NeuralSearch, so vague or descriptive intent works, not just exact keywords. Use it to FIND candidate products, then product_details for full specs/availability, and display_products to DISPLAY your picks to the user as cards (search itself shows nothing). Results are DEDUPLICATED — one representative variant per product (the best match), not every variant. A product can have several variants (e.g. colours/sizes), each with its own SKU; to see a product's other variants (their distinguishing attributes and availability) call product_details and read variant_siblings. Provide a short query (product type / brand / headline specs — MUST be in Icelandic, see the query field) and an optional customer_wishes (the user's soft preferences or use case, also in Icelandic); both are searched together. Optional filters: priceRange (ISK), categories (leaf names or full paths from response.facets.categories), brands, and a generic attributes map for any other facet (discover keys/values from response.facets); prefer the first-class fields over attributes. Results are ordered by RELEVANCE, not price. For cheapest / most expensive, set sort AND a categories filter — without a category, matching accessories (cases, hoses, cables) skew the order; once narrowed, the first result is the true cheapest/most-expensive and response.price_range gives the reliable {min,max}. Each row is compact (sku, name, price in ISK, in_stock, lifecycle_status, url, relevance), so one call can return many rows: items (default 30, max 100). Out-of-stock products are included; lifecycle_status "discontinued" marks products that will NOT be restocked (in-stock ones are last units). response.facets (top categories/attributes) helps refine a follow-up; page (0-based, bounded by total_pages) paginates. Evaluate results before trusting them — treat a product as a match only when the data explicitly satisfies the user's request; do not infer compatibility. Example input: {"query":"þvottavél 9 kg","customer_wishes":"Framhlaðin, hljóðlát er kostur.","items":30}.