Shoppable

Add several products to a single Shoppable cart in one call. This is the preferred way to handle a "add A, B, and C to my cart" request — it keeps all items in one cart with one checkout URL, instead of creating separate carts per item. Returns a session ID, a checkout URL, and per-item status (added or skipped with reason).

add_multiple_to_cart

Add a single product (by UPC) to a Shoppable cart. Returns sessionId, itemCount, and an updated checkoutUrl. IMPORTANT for multi-item carts: each call without a sessionId creates a NEW separate cart, so the shopper would have to check out multiple times. If you are adding more than one item in the same conversation: (1) preferred — use add_multiple_to_cart with all UPCs in one call, or (2) pass the sessionId returned by your first add_to_cart call into every subsequent add_to_cart call. Always share the latest checkoutUrl with the shopper, not earlier ones.

add_to_cart

Given a product ID, return similar products (same category, comparable price). Useful for offering alternatives or letting the shopper compare options.

find_similar

Inspect the contents of an existing cart by session ID. Returns the items currently in the cart with names, merchants, prices, and quantities.

get_cart_contents

Get the checkout URL for an existing cart session.

get_checkout_url

Find products currently on sale, optionally filtered by category, brand, merchant, minimum discount percentage, or max price. Returns a JSON list of discounted products with original and sale prices.

get_deals

Look up a Shoppable merchant by name or ID. Returns merchant info including catalog size and network.

get_merchant

Look up an order by order number. BEFORE calling this tool, ask the shopper for at least one of: the email address used on the order, the phone number on the order, the billing postal/zip code, or the last name on the order. Pass whatever they confirm as `email`, `phone`, `postalCode`, or `lastName`. The order is only returned if at least one of those matches what is on file; otherwise the response is identical to "order not found" so the existence of the order is not leaked. Never share the order number publicly — treat it as something only the shopper should know. (Legacy: orderId is accepted as an alias for orderNumber for older clients.)

get_order

Return popular or trending products over a time window (day, week, or month), optionally scoped to a category, brand, or merchant.

get_trending

List available brands, optionally scoped to a merchant or category, or filtered by a name prefix.

list_brands