Pine Labs

Use this when the user explicitly wants to add a specific product variant to their shopping cart, or update the quantity of an item already in the cart. Requires a confirmed product_id and variant_id obtained from search_products. Calling this with an existing variant_id replaces its quantity — it does not add on top of the existing quantity. Do not use to remove items entirely — use remove_from_cart instead. Do not use with quantity 0 or less — use remove_from_cart instead.

Use this when the user is about to check out or is viewing product variant options, to confirm live stock availability directly from the merchant's Shopify storefront. Returns per-variant availability and a source field indicating whether the result is live or a safe fallback. On network failure or timeout the tool returns an optimistic fallback (all variants available) — it never blocks checkout. Do not use for general product browsing, search, or discovery — use search_products instead.

Use this when the user wants to view their current cart contents, review items and quantities, see the total price, or get the checkout URL to proceed to payment. Returns all cart line items, total item count, total price in INR, and a direct checkout URL. Do not use to add or remove items — use add_to_cart or remove_from_cart instead.

Use this when the user wants to browse or discover products and needs to understand what product categories are available in the store. Returns the merchant name, total product count, and an alphabetically sorted list of product category names. Do not use for checking stock availability, managing the cart, or initiating checkout.

Use this when the user explicitly wants to remove a specific product variant from their cart entirely, regardless of quantity. If the variant is not in the cart, the tool is a no-op and returns the current cart unchanged. Do not use this to update quantity — use add_to_cart instead.

Use this when the user wants to search or browse products by keyword, category, or price range. Returns up to 10 matching products (sorted by price ascending) displayed in an interactive carousel. Do not use to add items to the cart, check live stock availability, or initiate checkout. To discover valid category values, call get_categories first.