Innovist

Add a product to the shopping cart. IMPORTANT: productId must be the `id` field from product-search results. If cartId is omitted, a new cart is created — its ID is returned in the response. Pass this cartId to all subsequent cart operations. A cartId the store does not know → errorCode CART_NOT_FOUND; a productId from another store → PRODUCT_NOT_FOUND. If the store accepts fewer units than requested the response carries requestedQuantity / appliedQuantity / reason; lineQuantity is what the line now holds. Each product is capped per order at the store's purchase limit (else stock, else 25): over it → MAX_UNITS_PER_ITEM_EXCEEDED with limit. A product the store does not sell online → NOT_SELLABLE_ONLINE. A non-integer or < 1 quantity → VALIDATION.

add_to_cart

Remove all items from the cart. Removes all line items from the Shopify cart.

clear_cart

Create a REAL, payable Razorpay order and return a hosted checkout_url. Call once, after the shopper agrees. Args: { cartId } (from add_to_cart, full id incl. ?key=) OR { cartItems: [{productId|variantId, quantity}] }; optional pincode (6 digits, delivery check), idempotencyKey (8-128 chars; same key returns the same order). Reuse: a repeat on the same unchanged cart (or key) within 15 minutes returns that order with reused:true; a changed cart, or a call after that, mints a new order. Razorpay cannot cancel an unpaid order. total_amount is paise (total_amount_unit:'minor'); amount_display is human. Swiggy/Instamart/Dineout place real orders: without the shopper's yes they return CONSENT_REQUIRED; ask, then resend with notes.paymentMethod:'upi'. Errors: VALIDATION, EMPTY_CART, CART_NOT_FOUND, PRODUCT_NOT_FOUND, NOT_SERVICEABLE, MAX_UNITS_PER_ITEM_EXCEEDED, QUANTITY_NOT_AVAILABLE, SECURITY_LIMIT_EXCEEDED, IDEMPOTENCY_KEY_CONFLICT, CONSENT_REQUIRED, UPSTREAM_REJECTED, UPSTREAM_FAILED (retryable).

create_checkout

Get payment status for a Razorpay order. Pass `razorpay_order_id` (the `order_id` returned by create_checkout, 'order_' + 14 letters/digits). Returns found:true with order_status, payment_status (paid/pending), amount / amount_paid / amount_due in rupees (amountUnit:'major'; *_paise in paise), currency, payments and line_items [{name, quantity, unit_price, line_total}] in rupees (filled for Magic Checkout orders, which create_checkout makes; else [] with line_items_note); found:false with errorCode NOT_FOUND for an id this store does not own, or VALIDATION for a malformed id. It does NOT return the shipping address or fulfillment/shipment status.

get_order_status

Show detailed information for a specific product. Use this tool when the user wants to see more details about a single product, view product images, or check available variants (sizes, colors). Pass the `id` from search results as productId (Shopify: a Product or ProductVariant gid, or the handle; Fynd: the numeric id or the slug). Returns price, compareAtPrice, currency, brand, url, inStock, variants[] and a plain-text return policy; `serviceability` only with pincode, `sizePrice` only with variantId. An unknown id returns errorCode PRODUCT_NOT_FOUND.

get_product_details

Remove a product from the cart. Args: {cartId, productId | lineId, quantity?}. Without quantity the whole line is removed; with quantity it is reduced by that many (the line goes when it reaches 0). Identify the line by productId (variant id from search) OR lineId (from view_cart). Unknown cart → errorCode CART_NOT_FOUND; line not in cart → LINE_NOT_FOUND.

remove_from_cart

**Product Search Results**: The interactive widget above shows your filtered product results. You can browse products, apply additional filters, add items to cart, and complete checkout. The widget automatically updates based on your search criteria and applied filters.

search_products

Set the absolute quantity of one cart line. Args: {cartId, productId | lineId, quantity}; quantity 0 removes. If the store accepts fewer units (purchase limit / stock) the response is still success:true and carries requestedQuantity, appliedQuantity and reason — tell the shopper the applied quantity. Above the product's per-order cap (store purchase limit, else stock, else 25) → MAX_UNITS_PER_ITEM_EXCEEDED with limit, nothing changed.

update_cart_item

Retrieve current cart contents, including items and quantities. Args: {cartId}. An unknown cartId returns success:false with errorCode CART_NOT_FOUND (an empty cart is success:true with no lines). Pass `pincode` (Shopify) or `areaCode` (Fynd), a 6-digit Indian pincode, to also check delivery for all items; serviceable:null means it could not be checked. Read-only: the cart is never changed.

view_cart