apply_coupon

Swiggy Instamart (Grocery): Apply a coupon code to the current Instamart cart. Returns the updated cart with the discount reflected in the bill breakdown — same structure as get_cart / update_cart. Use list_coupons first to discover valid coupon codes.

Authentication is handled automatically.

See apply_coupon in actionComing soon

Usage notes

This tool is not completely rolled out yet; it may not appear in tools/list for every user or account.

Example

const result = await client.callTool({
  name: "apply_coupon",
  arguments: {
    couponCode: "WELCOME20",
  },
});

Parameters

Parameter	Type	Required	Description
`couponCode`	`string`	yes	REQUIRED: The coupon code to apply (e.g. "SAVE100", "FREEDEL"). Case-insensitive — will be uppercased automatically.

Session credentials (user identity, access token) are supplied automatically by the authenticated MCP session - you do not pass them in the tool call. See Authenticate.

Response

All Swiggy MCP tools return:

{
  "success": true,
  "data": { /* tool-specific payload */ },
  "message": "optional human-readable message"
}

On failure:

{
  "success": false,
  "error": { "message": "description of what went wrong" }
}

See Error codes for the full catalogue.

Output schema

data: InstamartCart

The cart shape is the same as get_cart, with the coupon discount reflected in billBreakdown.lineItems.

Schema notes

Fields marked optional may be omitted depending on user state, cart/order state, and live Swiggy availability.
Use returned identifiers and enum values exactly as provided; do not invent fallback IDs, status values, payment methods, or timestamps.

Details

Field	Value
Name	`apply_coupon`
MCP Server	Instamart
Endpoint	`POST mcp.swiggy.com/im`
Stage	Cart
Behaviour	mutating

Next in this journey →

Continue with checkout.