MCP Radar
Servidor MCP

SuperMCP

io.github.nitaiaharoni1/super-mcp
Comercio y retail Público y accesible MCP 2026-07-28

Qué hace este MCP

Searches Israeli supermarket products, compares delivered basket prices, evaluates promotions and fees, and optimizes split orders.

Capacidades

Herramientas

8 herramientas
get_delivery_terms
Get one storefront's delivery terms
The full published terms for a single online storefront: every fee band over basket size, the minimum order, the service area, and where each figure came from. Use to explain a deliveryFee an optimize_delivery plan reported, or to answer 'what do I need to spend for free delivery?'. Take the slug from a plan's serviceSlug. catalogSize and catalogVisibility are reported here only when already known: this tool answers from published terms and never waits on the item count. A null in either means one of two things, and they are not interchangeable: we hold no priced store for this storefront, OR the count has not been taken yet. Call list_delivery_options for a count you can rely on being present; never read a null here as an empty shop.
Solo lectura Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['service_slug'], 'properties': {'service_slug': {'type': 'string', 'minLength': 1, 'description': "Storefront slug, e.g. 'shufersal-online' â\x80\x94 from a plan's serviceSlug."}}, 'additionalProperties': False}
get_product
Get product
Fetch full detail for one canonical product by product_id (UUID) or GTIN barcode, including every per-chain listing (chain-specific item code, display name, and package size). Use after search_products to confirm identity, or directly when the GTIN is already known. Each listing carries `orderable`: false means no delivery or pickup storefront prices it, so it cannot be bought through this API. A listing is catalogue identity, not availability: never present an `orderable: false` chain as somewhere the shopper can buy. When every listing is `orderable: false` the product is not purchasable right now, whatever its chains suggest.
Solo lectura Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'gtin': {'type': 'string', 'description': 'GTIN/barcode, used only if product_id is omitted.'}, 'product_id': {'type': 'string', 'format': 'uuid', 'description': 'Canonical product UUID.'}}, 'additionalProperties': False}
get_promotions
Get promotions
List promotions (e.g. '2 for 30₪', club-member price, second-unit discount), optionally filtered by store_id or product_id, and by active=true to only return promotions currently running. Use this to explain why an optimize_delivery line price is lower than list_price.
Solo lectura Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'description': 'City name in Hebrew or English (also accepts CBS locality codes). Restricts to promotions at stores in that city plus chain-wide promotions of chains present there.'}, 'limit': {'type': 'integer', 'maximum': 200, 'description': 'Max promotions to return, ordered by soonest end date. Defaults to 50, max 200.', 'exclusiveMinimum': 0}, 'active': {'type': 'boolean', 'description': 'If true, only currently-active promotions. Defaults to true.'}, 'store_id': {'type': 'string', 'format': 'uuid', 'description': 'Filter to promotions at this store.'}, 'product_id': {'type': 'string', 'format': 'uuid', 'description': 'Filter to promotions covering this canonical product.'}}, 'additionalProperties': False}
list_delivery_options
List storefronts that deliver here
Which Israeli online supermarkets deliver to an address, with each one's delivery fee, minimum order, free-delivery threshold and whether it offers click-and-collect — without pricing a basket. Use for 'who delivers to me?'. For 'what will my shopping cost delivered?', use optimize_delivery instead. Every entry carries deliveryTerms.confidence and verifiedAt; quote a fee only when it is verified or reported, and say the fee is unknown otherwise. Every entry also carries catalogSize (priced items we hold) and catalogVisibility. catalogVisibility 'partial_index' means WE cannot see the whole shop: that storefront's prices are read off a website that cannot be paged, so catalogSize is the part we indexed and says nothing about how much the retailer stocks. 'full_catalogue' means the count is the retailer's complete published price file. Never recommend a storefront on its delivery fee alone: one where we hold a few hundred items cannot fill a normal basket, so price the basket with optimize_delivery before naming a winner. An entry carrying notesRef instead of notes shares its terms with other storefronts: read the text from sharedNotes[notesRef]. Marketplace terms are written once per chain and held per venue, so they would otherwise repeat verbatim on every branch.
Solo lectura Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'City name in Hebrew or English. Enough for chains that publish a settlement list, not enough for a storefront whose area is a polygon or a depot radius.'}, 'near': {'type': 'string', 'maxLength': 100, 'minLength': 3, 'description': "'lat,lng' string, e.g. '32.078,34.774'. Do not combine with address."}, 'chain': {'type': 'string', 'description': 'Filter to one chain, by its name as it appears in chainName (ש×\x95פרס×\x9c) or by its legal barcode id. A value matching neither returns no options, which is not the same answer as nobody delivering here: omit it to see every storefront.'}, 'address': {'type': 'string', 'maxLength': 300, 'minLength': 3, 'description': "Delivery address in Israel, free text, e.g. '×\x9e×\xa0×\x93×\x9cס×\x95×\x9f 1, ת×\x9c ×\x90×\x91×\x99×\x91'. Preferred: some storefronts publish a service area that only a street address can be tested against."}, 'include_unavailable': {'type': 'boolean', 'description': 'Also return storefronts that do NOT serve this address, each with a reason. Useful for explaining why a well-known chain is missing.'}}, 'additionalProperties': False}
optimize_delivery
Price a shopping list for delivery
Price a whole shopping list at every Israeli online supermarket that delivers to an address, and rank them on what the order actually costs: items + delivery fee + service fee. Call this ONCE with the full list — never price lines separately. This is SuperMCP's shopping-list tool for online supermarket delivery. ASK THE SHOPPER WHERE THEY LIVE BEFORE CALLING, whenever you can get it in the same breath. A city is enough. It is not a detail that sharpens the answer, it usually IS the answer: of the 531 towns whose coverage we hold, 386 are served by exactly one chain. It is also much the cheaper call, comparing the handful of storefronts that reach one town instead of every storefront in the country. Only when you cannot ask, or when showing the range now beats a round trip, call with no destination. It does not fail: it returns status=needs_destination, the same list priced at every storefront in the country, carrying only what an address does not decide — each storefront's shelf prices, its own delivery fee and its minimum order. NOT ONE of them was tested against a service area, so that reply names no cheapest, carries no handoffUrl and is not a recommendation. Quote it as a range, say we do not yet know who delivers to this shopper, ask for their city or street address, then send {continuation, city} to get the storefronts that actually reach them. THE HEADLINE FIGURE IS deliveredTotal, not the item subtotal: a ₪35.90 delivery fee outweighs most price differences between chains. But RANK 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. Check pricedLines against requestedLines and say when the coverage is partial. A gap has two possible reasons and catalogVisibility says which. 'full_catalogue' means catalogSize is the retailer's complete published price file, so a line it did not price is a line it does not stock. 'partial_index' means WE cannot see the whole shop, because its prices are read off a website that cannot be paged, so the gap may be ours and the shop may well carry the missing items. Say which it is rather than telling a shopper a storefront does not stock something we simply never indexed. Both fields are null when the count has not loaded yet, which is not an empty shop. Read deliveryTerms.confidence before quoting: 'verified' was read from the retailer's own binding terms, 'reported' from a cited secondary source, 'unknown' means no fee is established and the ranking used an assumption (assumedDeliveryFee) that must not be repeated as a price. Anything other than verified or reported withholds the whole quotable tariff page, not just the fee: deliveryFee, freeDeliveryThreshold and nextFeeBreak all come back null together, because all three are read off the page we just declined to stand behind. Never fill one of them in from get_delivery_terms and quote it beside a fee this plan refused to give. minimumOrder is gated differently on purpose, lapsing only once the figure is past its 90-day recheck, so its presence is not evidence the fee beside it can be quoted. deliveryFeeIsFloor=true means the fee is a published lower bound, so quote it as 'from ₪X' and treat deliveredTotal as a minimum. meetsMinimum=false means the order cannot be placed as it stands; report amountToMinimum, the top-up needed. Those plans are still listed, after the orderable ones, so present them as options that need topping up rather than hiding them. Of several branches of one marketplace chain that all sit under their minimum, the one listed is the cheapest that is also nearest to its minimum, so the top-up you report is the smallest on offer there. Rank on cheapestDelivered only if the shopper will happily order twice: it prices missing lines at a market reference. bestSingleOrder is the fullest basket obtainable in one order. Both, and bestVerifiedTerms, carry totals only: find the storefront in plans by serviceSlug for its priced lines. When nextFeeBreak.worthTopUp is true, spending a little more makes the order cheaper overall — say so. A line carrying cheaperAlternative can be met for less AT THE SAME SHOP: it names the product, how many packs, what the line would cost instead, and the saving, promotions included. Every one is cheaper per 100g/ml/piece as well as per line, so it is a genuine saving rather than a smaller pack, and the saving can be quoted as it stands. Offer these unprompted when the shopper cares about price, and never silently swap them in — it is a different product and theirs to choose. Pin one by calling again with its productId. splitOrder, when it is not null, is the same list bought from two shops instead of one, with each leg's items, fees and its own handoffUrl. reason='cheaper' means it saves money after BOTH delivery fees; reason='more_of_the_list' means no one shop stocks everything and the second order fills the gap at extra cost, which `saving` reports as a negative. Volunteer it unprompted, and say which of the two it is. null means one order is the right answer here. If the shopper says a priced line is wrong, call suggest_similar_products with their Hebrew words and the rejected product_id, then call this tool again with that product_id on the line. Storefronts that cannot serve this basket come back in unavailableStores with a reason. By default only the actionable ones are listed: below_minimum_order, and price_feed_stale for a chain that delivers here but has published no prices for over a fortnight, which is therefore not in plans at all and must not be presented as an option. A plan flagged priceFeedStale is a milder case, over a week old: still worth comparing, but quote it as what the shop last published on priceFeedAsOf. If no storefront inside the fortnight can take the order, the abandoned ones come back in plans rather than leaving the shopper with nothing, and notes says so. unavailableStoresOmitted counts the rest, all ruled out on the address alone. A plan may carry venues: branches of one marketplace chain that priced this basket identically, collapsed into one row. Any slug in it works with get_delivery_terms. venuesOmitted counts further branches of that chain left out because each costs more and fills no line this row is missing. None of their figures are here and this row's are not theirs, so never quote a price for them; list_delivery_options names them all. By default only the recommended storefronts carry a `lines` breakdown; every other plan reports its totals and pricedLines with `lines: []`. That is not a gap — re-call with response_detail=standard only if you must compare the same item's price across chains. When the shopper settles on a storefront, give them that plan's handoffUrl: it opens the whole basket as one Hebrew page, every line with its price and its own product link. Hand over that one link rather than the per-line link fields, which leave the shopper opening a tab per item. Say that the page shows the prices this answer was built on.
Solo lectura Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'City name in Hebrew or English. Enough for chains that publish a settlement list, not enough for a storefront whose area is a polygon or a depot radius.'}, 'near': {'type': 'string', 'maxLength': 100, 'minLength': 3, 'description': "'lat,lng' string, e.g. '32.078,34.774'. Do not combine with address."}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'gtin': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'GTIN/barcode, if known.'}, 'unit': {'type': 'string', 'minLength': 1, 'description': 'Required with amount: kg, g, L, ml, unit, ×\x99×\x97, etc. Do not pair mass/volume units with pack_qty.'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Free-text product name, IN HEBREW. The catalogue is Hebrew, and a line is matched on the words the shopper used appearing in the product name, so a Latin brand ('Pampers', 'Coca Cola', 'Osem') matches nothing and the line is dropped as unresolvable. Write פ×\x9eפרס, ק×\x95ק×\x94 ק×\x95×\x9c×\x94, ×\x90×\x95ס×\x9d. Translate the shopper's wording rather than passing it through: an English shopping list still needs Hebrew queries here. Give a stated fat percentage exactly as they said it (ק×\x95×\x98×\x92' 5%), since it is matched exactly and is not guessed at."}, 'amount': {'type': 'number', 'description': "Physical amount, e.g. 1.5 with unit=kg. Also the right field for a count of individual items: 24 with unit='×\x99×\x97' means 24 bottles however they are packaged, and the packs are divided out for you wherever the pack size is known. Where it is not, the count is priced as that many of the chosen listing and the line says so with assumptions reason unit_count_assumed: read it before quoting the total, because a mass or volume is exact where a count had to be guessed at. Mutually exclusive with pack_qty.", 'exclusiveMinimum': 0}, 'pack_qty': {'type': 'integer', 'description': "Number of PACKS to buy, whatever each pack holds. Use it only when the shopper counted packs ('two six-packs', 'three cartons of eggs'). For a count of individual ITEMS ('24 bottles of beer', '40 plates') send amount with unit='×\x99×\x97' instead: a six-pack is one pack and six bottles, and pack_qty=24 there buys 144 bottles. Omit it when the shopper did not say a number: the line is priced as one pack and reported in assumptions. Do not invent a quantity.", 'exclusiveMinimum': 0}, 'product_id': {'type': 'string', 'format': 'uuid', 'description': 'Canonical product UUID, if known.'}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1, 'description': 'The shopping list. Required unless resuming with a continuation.'}, 'intent': {'type': 'string', 'description': "The shopper's own framing of this shop, in their own words, e.g. '×\x91ר×\x91×\x99ק×\x99×\x95 ×\x9c-12 ×\x90×\xa0ש×\x99×\x9d'. Not a summary of the item list â\x80\x94 pass what THEY said the shop was for. Shown on the handoff page next to what was priced. Optional; omit rather than inventing one."}, 'address': {'type': 'string', 'maxLength': 300, 'minLength': 3, 'description': "Delivery address in Israel, free text, e.g. '×\x9e×\xa0×\x93×\x9cס×\x95×\x9f 1, ת×\x9c ×\x90×\x91×\x99×\x91'. Preferred: some storefronts publish a service area that only a street address can be tested against."}, 'answers': {'type': 'array', 'items': {'type': 'object', 'required': ['item_index', 'product_id'], 'properties': {'item_index': {'type': 'integer', 'minimum': 0}, 'product_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}, 'description': 'One answer per question from the needs_confirmation reply.'}, 'slot_type': {'enum': ['standard', 'pickup'], 'type': 'string', 'description': 'Only two slots exist here: standard (default) is delivery to the door, pickup is click-and-collect, which is cheaper at the chains that offer it but means the shopper travels. Anything else is rejected.'}, 'preference': {'enum': ['cheapest', 'balanced'], 'type': 'string', 'description': 'cheapest takes the lowest delivered total outright; balanced (default) prefers a storefront whose delivery terms we verified when the money is close.'}, 'memberships': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 10, 'description': "Membership or card the shopper holds that unlocks a cheaper rate, e.g. ['credit_card'] for a Rami Levy card. Without it the public rate is quoted."}, 'continuation': {'type': 'string', 'description': 'Opaque token from a needs_confirmation, preview or needs_destination reply. The shopping list travels inside it, so send it with answers, or with the city or address that answers needs_destination, and nothing else.'}, 'include_club': {'type': 'boolean', 'description': 'Apply loyalty-club item prices. Default true; they are flagged clubOnly.'}, 'include_coupon': {'type': 'boolean', 'description': 'Apply coupon item prices. Default true; they are flagged couponOnly.'}, 'resolution_mode': {'enum': ['fast', 'strict', 'preview'], 'type': 'string', 'description': 'fast (default) makes best-effort product choices and reports them in assumptions, each carrying a kind: generic_default (the line named no particular product, so the everyday one is the answer) needs no warning, substitution (the line named a product and got another) does. strict asks before choosing, but only where WE are unsure, so it prices a confidently-wrong line without stopping. preview stops for YOU: it returns status=preview with items and assumptions and prices nothing, then send its continuation on its own to price the same list without resolving it twice. Worth it on a long or unusual list, where pricing every storefront is the expensive half and a wrong pick otherwise costs a second full call.'}, 'response_detail': {'enum': ['summary', 'standard', 'debug'], 'type': 'string', 'description': 'summary (default) returns the line-by-line breakdown only for the storefronts the recommendations name; it folds marketplace venues that priced this basket identically into one plan carrying venues, drops the branches of a chain that cost more and fill no line a kept branch fills, counting them in venuesOmitted, and replaces the out-of-area storefronts with a count. standard adds the lines for every storefront, every venue and the full unavailable list: ask for it only when comparing the same item across chains. debug adds resolution internals.'}, 'max_split_stores': {'type': 'integer', 'maximum': 3, 'minimum': 2, 'description': 'How many storefronts the returned splitOrder may spread the list over. Default 2. A third adds a third delivery fee, so it only wins when it reaches items the other two do not stock.'}}, 'additionalProperties': False}
search_products
Search products
Search the canonical product catalog by free text (Hebrew or English), brand, category, or exact GTIN, and answer 'how much is X' for a SINGLE item. Also matches chain listing names. Send city or address and every hit comes back priced: fromPrice is the lowest it goes for at any storefront delivering there, so quote it as 'from ₪X across N storefronts' (pricedAtStorefronts) and never as one national price — there is no such thing here. pricedAtStorefronts=1 is one shop's price, not a market rate. normalizedUnitPrice is that same money per 100g/100ml/piece: compare on it, NOT on fromPrice, because a smaller pack is cheaper to buy and usually dearer per gram. Results come back cheapest per unit first. fromPrice is the ordinary price, never a loyalty-club or coupon rate. Without a location nothing can be priced and the price fields are absent. For a whole shopping list call optimize_delivery ONCE with query items — never price lines one by one here, and never add these prices up: they come from different storefronts and each carries its own delivery fee. After optimize_delivery priced the wrong product, call suggest_similar_products with the shopper's Hebrew words and the rejected product_id, then call optimize_delivery again with that product_id. Returns canonical products (not per-chain detail); call get_product for listings.
Solo lectura Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'maxLength': 100, 'description': "City name in Hebrew or English (also accepts CBS locality codes). Aliases resolve to one place â\x80\x94 e.g. '×\x94רצ×\x9c×\x99×\x94', 'Herzliya', and '6400' are the same filter. May be combined with location as a disambiguation hint."}, 'gtin': {'type': 'string', 'maxLength': 64, 'description': 'Exact GTIN/barcode to look up.'}, 'near': {'type': 'string', 'maxLength': 100, 'description': "'lat,lng' string, e.g. '32.078,34.774', to find stores near a point."}, 'brand': {'type': 'string', 'maxLength': 100, 'description': 'Filter by brand name, partial match.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max results, default 20.'}, 'query': {'type': 'string', 'maxLength': 200, 'description': "Free text search, Hebrew or English, e.g. '×\x97×\x9c×\x91 ת×\xa0×\x95×\x91×\x94' or 'olive oil'."}, 'category': {'type': 'string', 'maxLength': 100, 'description': "Filter by internal category slug (l1 or l2), e.g. 'dairy'."}, 'location': {'type': 'string', 'maxLength': 300, 'minLength': 3, 'description': "Free-text neighborhood or address in Israel, e.g. '×\xa0×\x95×\x95×\x94 ×¢×\x9e×\x9c, ×\x94רצ×\x9c×\x99×\x94'. Resolved to coordinates via cached Nominatim. Do not combine with near."}, 'store_id': {'type': 'string', 'format': 'uuid', 'description': 'Optional store UUID to prefer locally stocked products.'}, 'radius_km': {'type': 'number', 'maximum': 200, 'description': 'Search radius in km around the resolved point. Defaults to 10km when near or location is set. Ignored without a point.', 'exclusiveMinimum': 0}, 'in_stock_only': {'type': 'boolean', 'description': 'When location is set, return only products with a local price. Default false.'}}, 'additionalProperties': False}
split_order
Split one shopping list across two or three shops
Answer 'can I save by ordering from more than one shop?' for a whole list. Returns which items to buy where, each leg's own subtotal, delivery fee and service fee, the combined delivered total, and what it saves against buying everything in one order. Every fee is a published one: a leg whose delivery fee we could not verify is never put in a split, because a split is a recommendation to pay a SECOND fee and it may not rest on a number we would refuse to quote for one order. reason='cheaper' means one order could buy this list and two buy it for materially less. reason='more_of_the_list' means no single storefront stocks everything, so the second order fills the gap: it costs MORE, saving is negative, and that is the honest answer rather than a hidden one. Say which of the two it is. Each leg carries its own handoffUrl, one page per order. Give the shopper both. Every leg meets its own storefront's minimum order, so both legs are placeable as they stand. Returns splitOrder: null when one order is the right answer, which is the usual case — report that plainly and point at the single-order recommendation instead of retrying. optimize_delivery already returns the same splitOrder field, so call this one only when the shopper asks about splitting specifically, or to raise max_stores to 3.
Solo lectura Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items'], 'properties': {'city': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'City name in Hebrew or English. Enough for chains that publish a settlement list, not enough for a storefront whose area is a polygon or a depot radius.'}, 'near': {'type': 'string', 'maxLength': 100, 'minLength': 3, 'description': "'lat,lng' string, e.g. '32.078,34.774'. Do not combine with address."}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'gtin': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'GTIN/barcode, if known.'}, 'unit': {'type': 'string', 'minLength': 1, 'description': 'Required with amount: kg, g, L, ml, unit, ×\x99×\x97, etc. Do not pair mass/volume units with pack_qty.'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Free-text product name, IN HEBREW. The catalogue is Hebrew, and a line is matched on the words the shopper used appearing in the product name, so a Latin brand ('Pampers', 'Coca Cola', 'Osem') matches nothing and the line is dropped as unresolvable. Write פ×\x9eפרס, ק×\x95ק×\x94 ק×\x95×\x9c×\x94, ×\x90×\x95ס×\x9d. Translate the shopper's wording rather than passing it through: an English shopping list still needs Hebrew queries here. Give a stated fat percentage exactly as they said it (ק×\x95×\x98×\x92' 5%), since it is matched exactly and is not guessed at."}, 'amount': {'type': 'number', 'description': "Physical amount, e.g. 1.5 with unit=kg. Also the right field for a count of individual items: 24 with unit='×\x99×\x97' means 24 bottles however they are packaged, and the packs are divided out for you wherever the pack size is known. Where it is not, the count is priced as that many of the chosen listing and the line says so with assumptions reason unit_count_assumed: read it before quoting the total, because a mass or volume is exact where a count had to be guessed at. Mutually exclusive with pack_qty.", 'exclusiveMinimum': 0}, 'pack_qty': {'type': 'integer', 'description': "Number of PACKS to buy, whatever each pack holds. Use it only when the shopper counted packs ('two six-packs', 'three cartons of eggs'). For a count of individual ITEMS ('24 bottles of beer', '40 plates') send amount with unit='×\x99×\x97' instead: a six-pack is one pack and six bottles, and pack_qty=24 there buys 144 bottles. Omit it when the shopper did not say a number: the line is priced as one pack and reported in assumptions. Do not invent a quantity.", 'exclusiveMinimum': 0}, 'product_id': {'type': 'string', 'format': 'uuid', 'description': 'Canonical product UUID, if known.'}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1, 'description': 'The shopping list, same shape as optimize_delivery.'}, 'intent': {'type': 'string', 'description': "The shopper's own framing of this shop, in their own words, e.g. '×\x91ר×\x91×\x99ק×\x99×\x95 ×\x9c-12 ×\x90×\xa0ש×\x99×\x9d'. Not a summary of the item list. Shown on each leg's handoff page next to what was priced. Optional; omit rather than inventing one."}, 'address': {'type': 'string', 'maxLength': 300, 'minLength': 3, 'description': "Delivery address in Israel, free text, e.g. '×\x9e×\xa0×\x93×\x9cס×\x95×\x9f 1, ת×\x9c ×\x90×\x91×\x99×\x91'. Preferred: some storefronts publish a service area that only a street address can be tested against."}, 'slot_type': {'enum': ['standard', 'pickup'], 'type': 'string', 'description': 'standard (default) or pickup.'}, 'max_stores': {'type': 'integer', 'maximum': 3, 'minimum': 2, 'description': 'How many storefronts to spread the list over. Default 2. A third adds a third delivery fee, so it only wins when it reaches items the other two do not stock.'}, 'memberships': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 10, 'description': "Memberships the shopper holds, e.g. ['credit_card', 'wolt_plus']."}}, 'additionalProperties': False}
suggest_similar_products
Suggest similar products
After optimize_delivery priced the wrong product, use this to show other things the shopper might have meant. Send their words in HEBREW (original line or the correction) and the rejected product_id so that SKU is dropped. Example: priced נקניקיות פרגיות, shopper said thigh cuts → query='פרגיות' or 'שוקיים', product_id=<the sausage>. Then call optimize_delivery again with the same list, that line pinned to the chosen product_id. Also answers 'is there a cheaper one?': every suggestion carries fromPrice, the lowest it goes for at any storefront delivering to this address, and normalizedUnitPrice, the same money per 100g/100ml/piece. Compare on normalizedUnitPrice, NOT on fromPrice: a smaller pack is cheaper to buy and usually dearer per gram, so a saving claimed on fromPrice alone is wrong whenever the pack sizes differ. Results come back cheapest per unit first, and `rejected` carries the same fields so the swap is directly comparable. fromPrice is a floor across storefronts, so quote it as 'from ₪X'; pricedAtStorefronts=1 means it is one shop's price rather than a market rate. Send city or address, or no price can be reported at all. Do not use this for a first-pass shopping list — call optimize_delivery once with every line.
Solo lectura Acceso externo
Esquema de entrada 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'maxLength': 100, 'description': "City name in Hebrew or English (also accepts CBS locality codes). Aliases resolve to one place â\x80\x94 e.g. '×\x94רצ×\x9c×\x99×\x94', 'Herzliya', and '6400' are the same filter. May be combined with location as a disambiguation hint."}, 'near': {'type': 'string', 'maxLength': 100, 'description': "'lat,lng' string, e.g. '32.078,34.774', to find stores near a point."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max neighbours to return. Default 8.'}, 'query': {'type': 'string', 'maxLength': 200, 'description': "What they meant, in Hebrew. Prefer the correction ('ש×\x95ק×\x99×\x99×\x9d') or the original line ('פר×\x92×\x99×\x95ת'). A Latin brand name matches nothing. Required unless product_id is set."}, 'location': {'type': 'string', 'maxLength': 300, 'minLength': 3, 'description': "Free-text neighborhood or address in Israel, e.g. '×\xa0×\x95×\x95×\x94 ×¢×\x9e×\x9c, ×\x94רצ×\x9c×\x99×\x94'. Resolved to coordinates via cached Nominatim. Do not combine with near."}, 'radius_km': {'type': 'number', 'maximum': 200, 'description': 'Search radius in km around the resolved point. Defaults to 10km when near or location is set. Ignored without a point.', 'exclusiveMinimum': 0}, 'product_id': {'type': 'string', 'format': 'uuid', 'description': 'The product_id optimize_delivery priced that the shopper rejected. Excluded from results.'}}, 'additionalProperties': False}
Historial

Cambios recientes en herramientas

Añadido
get_promotions
17 de September de 2026 a las 12:45
Añadido
suggest_similar_products
17 de September de 2026 a las 12:45
Añadido
get_product
17 de September de 2026 a las 12:45
Añadido
search_products
17 de September de 2026 a las 12:45
Añadido
get_delivery_terms
17 de September de 2026 a las 12:45
Añadido
list_delivery_options
17 de September de 2026 a las 12:45
Añadido
split_order
17 de September de 2026 a las 12:45
Añadido
optimize_delivery
17 de September de 2026 a las 12:45
Descubrir

Servidores MCP similares

AgentLot Marketplace

io.agentlot/marketplace

Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.

apex-x1

xyz.apexfaucet/apex-x1

Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…

SpellBook Finance

com.spellbook-finance/mcp

Provides Magic: The Gathering and other trading-card market prices, buylist offers, arbitrage analysis, sealed-product EV, seller…

API Direct

io.apidirect/api-direct

Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…

Digital Manager Guru

io.github.mcp-dir/guru-mcp

Provides Digital Manager Guru checkout, customer, transaction, subscription, affiliate, coupon, blocklist, and digital-product sa…

Pagar.me

io.github.mcp-dir/pagarme-mcp

Connects to Pagar.me to manage customers, cards, orders, charges, invoices, payment captures, confirmations, retries, refunds, an…

amazon-product-research-mcp

com.webotee/amazon-product-research-mcp

Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…

AgentLux

io.github.agentlux/agentlux

Operates an agent avatar marketplace with item generation, purchases, creator earnings, public profiles, social activity, and ERC…