search_products

Search for products available at the selected address. Returns products with their variants (e.g., different pack sizes, quantities). When a user asks to add a product, ALWAYS search first to see available variants, then ask the user which specific variant they want before adding to cart. Authentication is handled automatically. Use the addressId from get_addresses.

See search_products in actionComing soon

Example

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

Parameters

Parameter	Type	Required	Description
`addressId`	`string`	yes	Address ID from get_addresses tool
`query`	`string`	yes	Search query (product name, category, or brand)
`offset`	`number`	no	Pagination offset (default: 0)

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.

Response data

Field	Type	Description
`nextOffset`	`string`	Pagination cursor for the next page of results (`"0"` when no more pages)
`products`	`SearchProduct[]`	Directly matching (relevant) results — display these first
`similarProducts`	`SearchProduct[]` (optional)	Related/similar items returned when the API finds relevant alternatives. Only present when similar items exist. Display these in a separate "Similar Items" section below the main results

Each SearchProduct contains the product's name, brand, availability, and an array of variations (each with spinId, quantity description, pricing, and stock status).

Details

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

Next in this journey →

Continue with update_cart.