# Swiggy MCP Instamart

> Order groceries through the Swiggy Instamart MCP server (mcp.swiggy.com/im) — address → search or go-to items → set cart → coupons → checkout → track. Use when an agent with Swiggy Instamart tools must find products, build or edit a grocery cart, apply coupons, check out or track a delivery. Assumes the swiggy-mcp skill.

- Skill: `hktitan/swiggy-mcp-instamart` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hktitan/swiggy-mcp-instamart`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/swiggy-mcp-instamart/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/swiggy-mcp-instamart

---


# swiggy-mcp-instamart

```
get_addresses → your_go_to_items | search_products → update_cart → get_cart
   → list_coupons / apply_coupon → get_payment_options → checkout → track_order
```

## Step rules

1. **`get_addresses` once; pass `addressId` to every search.** Stock and serviceability are per address, so a search without it is meaningless. `create_address` if none fits (ask only for full address, name, phone, category; no coordinates).
2. **Returning user? `your_go_to_items { addressId }` first.** One call replaces 3–5 searches and is what Swiggy recommends for reorders.
3. **`search_products { addressId, query }` returns products with `variations[]`.** The cart takes the **variation** ids: `spinId` (+ `skuId`), never `productId`. Check `isInStockAndAvailable` and `maxQuantity` before offering a variation. Show `similarProducts` in a separate section when present. Paginate with `nextOffset`.
4. **`update_cart` REPLACES the whole cart.** `update_cart { selectedAddressId, items: [{ spinId, skuId, quantity }] }` must contain every item the user wants, not just the new one. To add one item: `get_cart`, merge, send the full list. The response may include `removedOutOfStockItems` and `reducedQuantityItems` — tell the user about each with its `reason`.
5. **Show the cart after every change:** `get_cart` → `items[]`, `billBreakdown.toPay`, `unserviceableItems`, `cartWarning`. Read the cart again before checkout.
6. **Do not switch address mid-cart.** Carts bind to the delivery address; call `clear_cart` first, then rebuild at the new address.
7. **Coupons:** `list_coupons { addressId }` then `apply_coupon { couponCode }` (case-insensitive). Report savings only from the returned cart. These two tools and `get_order_details` are rolled out per account (absent from `tools/list` for some users as of 2026-09-05); use only the tools the server lists, and say so if they are missing.
8. **Before `checkout`:** state items, `billBreakdown.toPay`, the exact delivery address, the payment method, and — if the cart spans multiple stores — "Your cart contains items from N stores; Swiggy will create one order per store." Ask "Do you want to proceed with placing this order to this address?" and wait for a clear yes. Minimum order ₹99.
9. **Place:** `checkout { addressId, paymentMethod?, intentApp?, generateUPIQR? }`. `paymentMethod` is a GROUP — `"UPI"`, `"Cash"`/`"COD"`, `"SwiggyPay"` — never an app id; the app id goes in `intentApp` with `paymentMethod: "UPI"`. Cash → placed; use `message` verbatim ("Instamart order placed successfully"). UPI → `PENDING_PAYMENT`, not placed yet → `swiggy-mcp-payments` (Instamart confirms with `orderId + paasId`). Report multi-store results per order.
10. **Track:** `track_order { orderId, lat, lng }` — coordinates are **required**; take them from the address/order context. Respect `pollingIntervalSeconds`, never faster than 10 s. `get_delivery_status { orderId, addressId }` for structured ETA. History: `get_orders { count?, orderType?, activeOnly? }`; details: `get_order_details { orderId }`.
11. **Cancellation:** no tool; say "To cancel your order, please call Swiggy customer care at 080-67466729."

## Failure → response

- Item out of stock at this address → suggest alternatives from a new `search_products`.
- Address not serviceable → ask for another address (or offer Food delivery instead).
- Minimum order not met → ask the user to add items.
- Cart expired → rebuild from the user's confirmed list, confirm, then continue.
- 5xx on `checkout` → `get_orders { activeOnly: true }` before any retry.

## Agent prompt

> You help users shop on Swiggy Instamart. Resolve the saved address first. Offer `your_go_to_items` for reorders; use `search_products` for new items; add variation `spinId`s. `update_cart` replaces the cart, so always send the full list. Show the cart and total, get an explicit yes before `checkout`, and never announce success on a `PENDING_PAYMENT` response.