list_coupons

Swiggy Instamart: List applicable coupon offers for the current cart. Returns coupon codes, titles, descriptions, and applicability status. Gated — only available for whitelisted accounts.

Swiggy Instamart: Fetch available coupon offers for the current Instamart cart, filtered by addressId. Returns codes and applicability status. Call this before apply_coupon to get valid codes.

Whitelist gate: This tool is only enabled for whitelisted accounts. Non-whitelisted users receive success: false with a specific error message — treat it as a business gate, not a tool error.

See list_coupons in actionComing soon

Example

const result = await client.callTool({
  name: "list_coupons",
  arguments: {
    addressId: "addr_01HXYZ",
  },
});

Parameters

Parameter	Type	Required	Description
`addressId`	`string`	yes	Delivery address ID (from `get_addresses`). Used to filter applicable coupons.

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

Success:

{
  "success": true,
  "data": {
    "availableCoupons": [
      {
        "couponCode": "SAVE100",
        "title": "string",
        "description": "string",
        "applicabilityStatus": "APPLICABLE"
      }
    ]
  },
  "message": "optional human-readable message"
}

applicabilityStatus — "APPLICABLE" (can be applied) or "APPLIED" (already applied to cart).

Non-whitelisted users:

{
  "success": false,
  "error": { "message": "Coupon tools are not enabled for your account yet." }
}

On other failures:

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

See Error codes for the full catalogue.

Details

Field	Value
Name	`list_coupons`
MCP Server	Instamart
Endpoint	`POST mcp.swiggy.com/im`
Stage	Cart
Behaviour	read-only

Next in this journey →

Continue with apply_coupon to apply a code to the cart.