get_addresses

Swiggy (Instamart/Food): Get all saved delivery addresses for the authenticated Swiggy user, sorted by last order date. This tool works for Swiggy Instamart and Food services. Addresses are returned ...

Swiggy (Instamart/Food): Get saved delivery addresses for the authenticated Swiggy user, sorted by last order date. Supports pagination — pass page and pageSize to fetch beyond the first page. Addresses are returned WITHOUT coordinates (latitude/longitude) for privacy protection.

See get_addresses in actionComing soon

Example

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

Parameters

Parameter	Type	Required	Description
`page`	`number`	no	Page number (default: 1). Use with `pageSize` to paginate through addresses.
`pageSize`	`number`	no	Results per page (default: 10, max: 10).

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": {
    "addresses": [],
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 23,
      "totalPages": 3,
      "hasMore": true
    },
    "imWidgetV2Eligible": true
  },
  "message": "optional human-readable message"
}

data.pagination.hasMore — if true, call again with page + 1 to fetch remaining addresses.
data.imWidgetV2Eligible — Instamart domain only; indicates the user is on the IM widget v2 whitelist.

On failure:

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

See Error codes for the full catalogue.

Details

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

Agent guidance

How Swiggy agents and orchestration logic use this tool. Surface these expectations in your prompts or tool-selection policies.

**IMPORTANT **- STOP here and let the user choose:

Show the address list to the user
Ask: "Which address would you like to use for delivery?"
Do NOT call any other tool until the user has selected an address
Remember the selected addressId for all subsequent operations
If no addresses are returned, inform the user that they need to add an address first
Check data.pagination.hasMore — if true, offer to load more or auto-fetch the next page before presenting the full list

Next in this journey →

Continue with search_products.