add_to_cart
ChatGPTAdd a product to the shopping cart. IMPORTANT: productId must be the id field from product-search results (a variant GID, e.g. gid://shopify/ProductVariant/...) — never pass a product page URL or metadata.product_gid. If cartId is omitted, a new cart is created — its ID is returned in the response. Pass this cartId to all subsequent cart operations.
clear_cart
ChatGPTRemove all items from the cart. Removes all line items from the Shopify cart.
create_checkout
ChatGPTCreate a Razorpay order from the cart and return a hosted checkout URL. Always call get_cart first to confirm the cart has items before calling this tool.
get_filter_options
ChatGPTGet available filter values (categories, brands, tags, sizes, colors, price range) for the store. Call this tool before search_products when the user mentions specific brands, categories, sizes, colors, or other product attributes. WORKFLOW: 1. User mentions a filter (brand/category/size/color/tags) — call this tool first. 2. Use exact values from the response. 3. Call search_products with the user's query and those exact filter values. 4. Always follow this tool with a search_products call — never stop here. RETURNS: - productTypes: available categories (e.g., ['T-Shirts', 'Jeans', 'Phones']) - vendors: available brands (e.g., ['Nike', 'Adidas', 'Apple']) - tags: available tags (e.g., ['sale', 'new-arrival', 'bestseller']) - priceRange: {min, max} bounds - variantOptions: sizes, colors, materials (e.g., [{name: 'Size', values: ['S', 'M', 'L']}]) EXAMPLES: 'show me nike shoes' → get_filter_options, then search_products({query: 'shoes', vendor: 'Nike'}) 'blue t-shirts on sale' → get_filter_options, then search_products({query: 't-shirts', tags: ['sale'], variantOptions: [{name: 'Color', value: 'Blue'}]})
get_order_status
ChatGPTGet order status and details using a Razorpay order ID. Returns order information including items, shipping address, payment status, and fulfillment status. Use this when the user asks about their order with an order ID.
get_product_details
ChatGPTShow 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). Use the productId from the search results.
remove_from_cart
ChatGPTRemove a product from the cart or reduce its quantity.
search_products
ChatGPTProduct 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.
update_cart_item
ChatGPTUpdate the quantity of a specific cart line item. Use quantity 0 to remove.
view_cart
ChatGPTRetrieve current cart contents, including items and quantities.
