Firecrackers & Fireworks Store

• Search Products — Search/list the storefront catalog. Returns a SHORT ranked list — each item: id, name, sku, slug, price (final selling price), originalPrice (MRP), discount %, stock, inStock, packageType, categoryName, brandName — plus total/page/limit/totalPages for pagination. Default 10 per page (max 25); ask for page 2+ when you need more. For full detail (description, images) call get_product(id). Use category/brand SLUGS (from list_categories/list_brands).
• Get Product — Fetch a single product by slug, id, or sku (provide exactly one).
• List Categories — List product categories (id, name, slug, parentId). Use get_category_tree for hierarchy.
• Get Category Tree — Get the hierarchical category tree (active categories).
• List Brands — List active brands (id, name, slug).
• Get Store Info — Public company profile: name, contact numbers/WhatsApp/email, address, business hours, the Google Maps location link (mapLink) for customers who want to visit the shop, the storefront website URL (websiteUrl) where customers place orders, the public order-status/track link (trackOrderUrl), active pickup locations, payment settings (enabled methods, COD limits, UPI accounts for display), and the MINIMUM ORDER value (minOrderAmount, plus minOrderAmountOtherStates for outside the home state). Menti
• Get Store Settings — Public store settings: currency, minimum order amount, COD availability, stock display mode, maintenance flag, and enabled login methods.
• Get Pickup Locations — List active pickup / lorry-godown locations (this store ships via lorry to the nearest godown for customer collection). Optionally filter by city/state/search.
• List Coupons — List active public coupons the customer can use.
• Validate Coupon — Preview whether a coupon code applies to an order total (anonymous / general validation), returning the discount. Per-customer eligibility (usage limits, first-time) is enforced authoritatively at place_order using the signed-in customer — this preview never takes a customerId.
• Request Whatsapp Otp — Start sign-in: send a one-time password (OTP) to the customer over WhatsApp. Call this ONLY when the customer is not yet signed in and must sign in to place an order or view their account. Ask the customer for their phone number first. Then call verify_whatsapp_otp with the code they receive. If the customer is already signed in this returns alreadyAuthenticated=true and sends NO code — just proceed with the action.
• Verify Whatsapp Otp — Verify the WhatsApp OTP and sign the customer in. On success for an EXISTING customer the conversation becomes authenticated and the order/account tools unlock — then retry the action (e.g. place_order). If the result has requiresRegistration=true, this is a NEW customer: ask for their name (email optional) and call complete_registration, passing back the exact otpSessionToken returned here. You may pass a name here up front if the customer already gave one.
• Complete Registration — Finish sign-up for a NEW customer after verify_whatsapp_otp returned requiresRegistration=true. Pass the customer name (required), an optional email, and the exact otpSessionToken from verify_whatsapp_otp. On success the conversation becomes authenticated and the order/account tools unlock — then retry the action (e.g. place_order).
• Share Store Links — Share the links the customer needs: the storefront WEBSITE URL to place their order, and the public ORDER-STATUS (track) link. Set includeMap:true to also include the Google Maps LOCATION when the customer wants to VISIT the shop. Ordering happens on the website — use this instead of taking an order in chat. On a phone call this SENDS the links to the caller's WhatsApp and returns a spoken confirmation; on WhatsApp/web it RETURNS the links for you to put in your reply.
• Get My Profile — Get the signed-in customer profile (requires the customer token).
• Update My Profile — Update the signed-in customer profile fields (name, email, etc.).
• List My Addresses — List the customer’s saved shipping addresses.
• Add Address — Add a shipping address for the customer.
• Update Address — Update a saved shipping address by addressId.
• Remove Address — Remove a saved shipping address by addressId.
• Place Order — Place a REAL order/enquiry for the signed-in customer. Provide ONLY productId + quantity per line — the server looks up the authoritative price/MRP/discount from the catalog (client-supplied prices are never trusted). Provide a shippingAddress (or a pickupLocation) and paymentMethod. customerPhone is required (from the token or provided here). Returns the created order incl. orderNumber; fails with INSUFFICIENT_STOCK if any item exceeds available stock.
• Add To Cart — Add a product to the signed-in customer’s cart (the SAME cart as the website). Provide productId (from search_products/get_product) + quantity; the quantity is ADDED to any existing quantity for that product. Returns the updated cart summary. Use this for the conversational "add to cart → checkout" flow (an alternative to the Excel order form).
• View Cart — Show the signed-in customer’s current cart (items, quantities, prices, subtotal).
• Update Cart Item — Set the exact quantity of a product in the cart (quantity 0 removes it). Returns the updated cart summary.
• Remove From Cart — Remove a product from the cart. Returns the updated cart summary.

Showing the first 25 tools — full list and schemas: Directory API.