swiggy

# Swiggy Skill

Order food, groceries, and book restaurants in India via Swiggy's MCP servers.

## Installation

The skill includes a `swiggy` CLI binary. After installing the skill:
```bash
cd skills/swiggy
npm link
```

This creates a global `swiggy` command. Verify with: `which swiggy`

## When to Use

- Food delivery: "Order biryani", "What's open late?", "Team lunch for 8"
- Groceries (Instamart): "Get eggs and milk", "Weekly groceries", "Recipe ingredients"
- Restaurant bookings (Dineout): "Book dinner Saturday 8pm", "Italian in Koramangala"

## Available Commands

### Food Delivery

```bash
# Search restaurants
swiggy food search "biryani" --location "Koramangala, Bengaluru"

# Get menu
swiggy food menu <restaurant-id>

# Cart management
swiggy food cart add <item-id> --quantity 2
swiggy food cart show
swiggy food cart clear

# Order (requires confirmation)
swiggy food order --address "home" --confirm
```

### Instamart (Groceries)

```bash
# Search products
swiggy im search "eggs" --location "HSR Layout, Bengaluru"

# Cart operations
swiggy im cart add <item-id> --quantity 3
swiggy im cart show
swiggy im cart clear

# Checkout (requires confirmation)
swiggy im order --address "home" --confirm
```

### Dineout (Restaurant Bookings)

```bash
# Search restaurants
swiggy dineout search "Italian Indiranagar"

# Get details
swiggy dineout details <restaurant-id>

# Check availability
swiggy dineout slots <restaurant-id> --date 2026-01-30

# Book table (free bookings only, requires confirmation)
swiggy dineout book <restaurant-id> --date 2026-01-30 --time 20:00 --guests 2 --confirm
```

## CRITICAL: Safety Rules

### ⚠️ NEVER Auto-Order
**ALWAYS get explicit confirmation before placing orders.**

1. **Show cart preview first:**
   - All items with quantities and prices
   - Total amount
   - Delivery address
   - Estimated delivery time (food/groceries)

2. **Ask for confirmation:**
   ```
   Ready to order:
   - 2x Chicken Biryani (₹500)
   - 1x Raita (₹60)
   Total: ₹560 + delivery
   Deliver to: Home (HSR Layout)
   ETA: 30-40 mins
   
   Confirm order? (yes/no)
   ```

3. **Only after user says YES:**
   - Run the order command with `--confirm` flag
   - Log to `memory/swiggy-orders.json`

### COD Warning
Swiggy MCP currently supports **Cash on Delivery only**. Orders **cannot be cancelled** once placed. Always double-check before confirming.

### Address Handling
- User may say "home", "office", etc. - map to actual addresses from USER.md or ask
- Always confirm delivery location in preview
- For Dineout, location is used for search only (not delivery)

## Workflow Examples

### Food Order Flow
```bash
# 1. Search
swiggy food search "biryani near Koramangala"

# 2. Browse menu (use restaurant ID from search)
swiggy food menu rest_12345

# 3. Add to cart
swiggy food cart add item_67890 --quantity 1

# 4. Preview cart
swiggy food cart show

# 5. Show preview to user, ask confirmation

# 6. If confirmed, order
swiggy food order --address "HSR Layout, Sector 2, Bengaluru" --confirm
```

### Grocery Shopping Flow
```bash
# 1. Search items
swiggy im search "eggs" --location "Koramangala"
swiggy im search "milk" --location "Koramangala"

# 2. Add to cart
swiggy im cart add item_11111 --quantity 2
swiggy im cart add item_22222 --quantity 1

# 3. Preview
swiggy im cart show

# 4. Confirm with user

# 5. Checkout
swiggy im order --address "Koramangala, Bengaluru" --confirm
```

### Restaurant Booking Flow
```bash
# 1. Search
swiggy dineout search "Italian Indiranagar"

# 2. Check details
swiggy dineout details rest_99999

# 3. Check slots
swiggy dineout slots rest_99999 --date 2026-01-30

# 4. Show options to user, confirm choice

# 5. Book
swiggy dineout book rest_99999 --date 2026-01-30 --time 20:00 --guests 2 --confirm
```

## Error Handling

- **No results:** Suggest broader search or different location
- **Out of stock:** Show alternatives
- **No slots available:** Suggest different times/dates
- **Authentication required:** User needs to authenticate via OAuth (handled by MCP)

## Tips

- For team orders: build cart iteratively, ask for preferences
- For budget shopping: filter results by price, show running total
- For recipe-to-cart: search each ingredient, add progressively
- For late night: mention delivery time in search criteria

## Order Logging

After successful order, append to `memory/swiggy-orders.json`:
```json
{
  "timestamp": "2026-01-28T21:16:00+05:30",
  "type": "food",
  "items": [...],
  "total": "₹560",
  "address": "HSR Layout",
  "orderId": "..."
}
```

## Authentication

Swiggy MCP uses OAuth. First use will trigger auth flow. The `swiggy` CLI handles this via mcporter.

## Dependencies

- Requires `mcporter` skill (uses it under the hood)
- Node.js runtime for the CLI wrapper

## Known Limitations

- COD only (no online payment yet)
- Orders cannot be cancelled
- Dineout: free bookings only
- Don't open Swiggy app while using MCP (session conflicts)

---

**Remember: Confirmation BEFORE ordering. Every. Single. Time.** 🐾