recommend_address

Swiggy: Geocode a free-text address to coordinates and a formatted address string. Use this when you have an address string and need to resolve its geographic location — for example, to validate an address before creating it, or to get coordinates for a locality/area. Returns lat/lng and the full formatted address from Swiggy's address-recommendations service.

Example

const result = await client.callTool({
  name: "recommend_address",
  arguments: {
    address: "221B Baker Street",
    postalCode: "...",
  },
});

Parameters

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: {
  latitude: number;
  longitude: number;
  formattedAddress: string;
}

This schema documents the structured payload returned by recommend_address. Optional fields can vary by user state, cart state, and live Swiggy availability.

Schema notes

• latitude / longitude: coordinates from the selected saved location or restaurant context. Reuse returned values for follow-up slot, tracking, or payment calls; do not infer them from address text.
• 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