Request a one-time password (OTP) to be sent to the given phone number. Call this first to initiate login. IMPORTANT — reassure the user: this MCP server runs entirely on their local machine. Their phone number is sent directly from their device to Milkbasket's servers — it never passes through any AI model or third party.

Verify the OTP received on the phone number to complete login. IMPORTANT — when asking the user for their OTP, always reassure them with this message: 'Your OTP is safe to share here. This MCP server runs entirely on your local machine — your OTP goes directly from your device to Milkbasket's servers and is never stored or seen by any AI model or third party.' After login, tokens are stored securely in the OS keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service).

Check whether the current session is authenticated and when it expires.

Clear the stored access and refresh tokens, effectively logging out.

Fetch the logged-in user's profile (name, email, address, delivery info) and wallet balance. Requires authentication.

Fetch the logged-in user's wallet balance including main credits, food credits, and cashback credits. Requires authentication.

Fetch a lightweight snapshot of the current cart — product IDs, quantities, unit prices, and a basic bill summary (subtotal, total, savings). Use this tool when you need a quick cart check: verifying if a product is in the cart, getting the item count, or getting the basic total without full product details. For the full checkout view with product names, images, discounts, delivery fee, GST, and final payable amount — use get_extended_basket instead. Requires authentication.

Fetch the full basket (cart) with COMPLETE product details including product names, weights, images, MRP, selling price, discount percentage, and an EXTENDED bill breakdown that includes delivery fee, GST, membership charges, cashback used, and final payable amount. Use this tool when you need to: show the user a detailed view of their cart (checkout screen), display product names or discount info for items in the cart, or show the complete bill breakdown including delivery fee and final payable amount. Use get_basket instead when you only need a quick/lightweight cart check (e.g. verifying if a product is in the cart, getting item count, or getting the basic total). Requires authentication.

Fetch the homepage hero collections. Each collection has a listId that can be passed to list_products to browse its products.

List products from a specific collection by its listId (obtained from get_hero_collections). Supports pagination and in-stock filtering. Requires authentication.

Fetch today's Mega Flash Deal products — items that are free or heavily discounted for the day. Returns paginated products with name, weight, MRP, selling price, discount %, and stock status. Requires authentication. Uses listId '157975' by default (the flash deals collection). IMPORTANT: To add any product from this list to the cart, always use add_flash_deal_to_cart — never use add_to_cart for flash deal items.

Get the status and eligibility details of a Mega Flash Deal. Returns deal terms, your current basket value vs the minimum required, how many free items you have claimed vs the maximum allowed, deal timing, and a human-readable status message explaining what you need to do to unlock the deal. Use this to check why a flash deal item could not be added to cart. Requires authentication. Default deal ID is 11732.

Add a Mega Flash Deal product to the cart for free. Use this instead of add_to_cart for flash deal items (price is always 0). Requires the productId from get_flash_deals. flashDealId defaults to 11732. Try adding directly — if it fails with an eligibility error, then call get_flash_deal_status to diagnose (e.g. basket is empty, deal expired, or max quantity already reached) and guide the user accordingly. Do NOT call get_flash_deal_status before every add — only use it to explain a failure. Requires authentication.

Search for products by name or keyword across the Milkbasket catalog. Supports pagination. Requires authentication.

Add a NEW product to the basket or INCREASE the quantity of an existing product. Use this only when the quantity is going UP (e.g. adding a product for the first time, or bumping qty from 2 to 3). To DECREASE quantity or DELETE a product from the cart, use remove_from_cart instead. For flash deal products (free items from get_flash_deals), use add_flash_deal_to_cart instead. Requires authentication. Get productId and price from search_products or list_products.

DECREASE the quantity of a product in the basket or DELETE it entirely. Use this when the quantity is going DOWN (e.g. reducing from 3 to 2, or removing a product). Set quantity=0 to completely remove the product from the cart. To ADD a new product or INCREASE quantity, use add_to_cart instead. Requires authentication. Get productId and price from get_basket or get_extended_basket.