supermcp.web.app

Shopping list to be DELIVERED → call optimize_delivery exactly once with all items and the delivery address. Never price each line separately. Israeli online supermarket storefronts: catalogue, price and promotion data from the same regulated feeds as the shelf prices, plus each storefront's delivery terms. Online prices are NOT shelf prices — a chain's website runs its own price book, so quote what this server returns rather than a branch price. Call optimize_delivery with items[{query|gtin|product_id, pack_qty|amount+unit}] and address (free-text, e.g. 'מנדלסון 1, תל אביב') or city. If status is needs_confirmation, answer every required question and call again with only {continuation, answers}. THE HEADLINE NUMBER IS deliveredTotal, not the item subtotal: a ₪29 delivery fee outweighs most price differences between chains, so a storefront with dearer items can still win. Read each plan's itemsSubtotal, deliveryFee, deliveredTotal and deliveryTerms.confidence. Compare storefronts on deliveredComparableTotal, never on deliveredTotal: totalScope is priced_lines_only, so a storefront that stocks four of your twelve items reports a small deliveredTotal precisely because it cannot fill the basket. pricedLines out of requestedLines says how much of the list a plan actually covers, and imputedLines how many the comparable figure had to price at a market reference. Say so when coverage is partial. deliveryTerms.confidence=verified means we checked the retailer's own published terms on deliveryTerms.verifiedAt; reported means a cited secondary source. When it is unknown the fee is null and the ranking used assumedDeliveryFee, which is NOT a price and must not be repeated as one. When deliveryFeeIsFloor is true the fee is a published lower bound (a marketplace sets the real figure at checkout from the distance), so say 'from ₪X' and treat deliveredTotal as a minimum. meetsMinimum=false means the order CANNOT be placed as it stands: report amountToMinimum, the shekels of extra goods needed. Such a plan still appears in plans, after every orderable one, because a storefront held back only by its minimum is the shopper's call to make. Show it as an option that needs a top-up of that many shekels, never as one they can order now. cheapestDelivered ranks on a total that prices missing lines at a market reference, so it can win by not stocking things; bestSingleOrder is the most of the list obtainable in ONE order. When they differ, say so and let the shopper choose. Those three recommendation fields carry the totals only; look the storefront up in plans by serviceSlug for its priced lines. nextFeeBreak names a cheaper fee tier the shopper could reach: gap is the extra spend, saving is what it takes off the fee, and worthTopUp=true means spending it leaves them better off overall. Volunteer that unprompted. Storefronts that do not serve the address are returned in unavailableStores with a reason, not silently dropped. Conditional prices are flagged exactly as on the shelf: clubOnly needs the chain loyalty card, couponOnly needs a clipped coupon. Set preference=cheapest to take the lowest delivered figure outright; leave it balanced (default) to prefer a storefront whose terms we verified when the money is close. Set slot_type=pickup for click-and-collect, which is cheaper where offered but means the shopper travels. Use list_delivery_options to answer 'who delivers to me' without pricing a basket, and get_delivery_terms for one storefront's fee schedule, minimum and slots. Use search_products / get_promotions for single lines only. This is the SuperMCP server: Israeli online supermarket delivery and click-and-collect. protocol=delivery-optimize-v1; build=6c4d6af0