Facts about Foran Delivery: live areas, delivery time, hours, cashback, first-order promo, payment options, contact and app links. Call this first when a user asks what Foran is or where it delivers.

Turn an address or area name (e.g. 'Precinct 10 Bahria Town', 'Qasimabad Hyderabad') into coordinates and check whether Foran delivers there.

Search Foran's catalogue (groceries in Mart, food in Bites) near the customer. Returns item_id, price in Rs, store, stock and a link. Prices include current discounts.

Stores (Mart) or restaurants (Bites) that deliver to the customer's area, with open status, minimum order and distance.

Details of one store plus its popular items.

Full details of one product, including required options (size, flavour, add-ons) needed before adding it to the cart.

List product categories (e.g. Milk & Dairy, Fruits & Vegetables) or, with category_id, the items inside one category.

Read a Foran policy: terms, privacy, refund, cancellation, delivery, or about.

Status of an order. Logged-in customers pass session_key; guest orders need the phone number used on the order.

Search Foran products in all live areas (Bahria Town Karachi and Hyderabad). Returns ids usable with fetch.

Fetch full details for an id returned by search (format product:<item_id>:).

Log in with the customer's own Foran phone number and password (the same as the Foran app). Returns a session_key for cart, order and account tools. Only use credentials the customer typed themselves in this conversation. On a local install, credentials may instead come from FORAN_PHONE / FORAN_PASSWORD environment variables (call with no arguments).

Customer profile: name, phone, Foran Money (wallet) balance, loyalty points and order count.

The customer's saved delivery addresses (address_id is needed to place an order). New addresses are added in the Foran app or website.

Recent Foran Money (wallet) transactions: cashback, top-ups and payments.

Coupons the logged-in customer can use (code, discount, minimum order).

Show the customer's current Foran cart for Mart or Bites, with line totals and subtotal.

Add a product to the customer's cart. All items in one order must come from the same store. If the product has options, pass them (see foran_product_details).

Set a new quantity for one cart line (cart_id from foran_cart_view). Quantity 0 removes it.

Remove one cart line (cart_id) or empty the whole cart (all=true).

Check out the current cart to a saved address. First call WITHOUT confirm to get the order summary and show it to the customer. Only after the customer clearly says yes, call again with confirm=true to place the real order. Payment: cash_on_delivery or wallet (Foran Money). Orders placed here carry the MCP fee (Rs 150) instead of the app's processing fee; always show it in the summary.

The customer's running (active) orders or past order history.

Items, prices and status of one of the customer's orders.

Cancel an order that the store has not started yet (status pending). Ask the customer to confirm first, then call with confirm=true.

Practical guide to buying from Foran Delivery: how ordering works, one-store rule, delivery charges, free delivery, minimum order, payment, Foran Money top-up, cashback, custom orders from photos/lists, cancellation and refunds. Use it whenever a customer asks how Foran works or how to order.

For the Foran team only. Unlock staff tools (custom orders for any customer, e.g. from WhatsApp, and order status for any order) with the Foran staff key. Returns a staff_session valid for 7 days. Only use a key the user typed in this conversation.

Create a Foran order from what the customer sent: product names, a shopping list, or photos. Mix catalogue items (item_id) with custom items that are not in the app (name + estimated_price_rs). All items must be bought from ONE store: pick the nearest open store that has most items (foran_list_stores / foran_search_products). The order lands in the Foran admin panel as a pending 'Claude order' with the photos attached; the team confirms custom prices before dispatch. Who can use it: a logged-in customer (session_key; the order goes on their account) or Foran staff (staff_session; any customer name + phone, e.g. a WhatsApp customer). ALWAYS call first WITHOUT confirm: it returns the quote (items, delivery charge, MCP fee Rs 150, total, warnings). Show it to the user, and only after a clear yes call again with the same inputs and confirm=true. Cash on delivery.

Real-time status of a Foran order: stage with plain-language meaning, timeline, store, rider name and phone, items, delivery charge, total and payment. Customers: pass session_key (only their own orders). Staff: pass staff_session plus order_id or the customer's phone (latest 5 orders). Use this whenever someone asks 'where is my order?'.