# 🛒 Quick Commerce MCP

Universal quick commerce aggregation via MCP - compare and order from Zepto, Swiggy Instamart, and BigBasket in one interface.

## ✨ Features

- **Multi-Platform Search**: Find products across all platforms simultaneously
- **Price Comparison**: See which app has the best deal
- **Smart Cart**: Automatically suggest optimal platform split
- **User Control**: You confirm before any order is placed
- **OTP Handling**: Prompts for OTP when session expires

## 🚀 Quick Start

```bash
# Install dependencies
npm install

# Build
npm run build

# Configure MCP in Claude/Cursor
# Add to your MCP settings:
{
  "mcpServers": {
    "quick-commerce": {
      "command": "node",
      "args": ["/path/to/quick-commerce-mcp/dist/index.js"]
    }
  }
}
```

## 🛠️ Supported Platforms

| Platform | Search | Cart | Order | Notes |
|----------|--------|------|-------|-------|
| Zepto | ✅ | ✅ | ✅ | 10-min delivery |
| Swiggy Instamart | ✅ | ✅ | ✅ | Good variety |
| BigBasket | 🚧 | 🚧 | 🚧 | Coming in v1.1 |

## 📝 Usage Examples

### Search for a product
```
"Find Coke Zero 6-pack"
"Where is milk cheapest right now?"
"Search for Maggi noodles on Zepto and Swiggy"
```

### Build a cart
```
"Add to cart: 1L milk, 6 eggs, bread"
"Show me the best platform for these items"
```

### Compare before ordering
```
"Compare prices for my cart"
"What's the cheapest way to get these items?"
```

## 🔐 Security

- **No payment info stored**: We only automate cart building
- **OTP required**: You'll always enter OTP manually
- **Confirm before order**: Preview shown, you confirm final purchase
- **Session isolation**: Each platform login is separate

## 🏗️ Architecture

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Claude    │────▶│  MCP Server  │────▶│  Playwright │
│  /Cursor    │◀────│  (this repo) │◀────│  Automation │
└─────────────┘     └─────────────┘     └──────┬──────┘
                                                │
                       ┌─────────┐    ┌─────────┴──────────┐
                       │ SQLite  │    │                    │
                       │  Cache  │    │ Zepto | Swiggy     │
                       └─────────┘    └────────────────────┘
```

## 📋 Roadmap

### v1.0 (Current)
- [x] Zepto automation
- [ ] Swiggy Instamart
- [ ] Price comparison
- [ ] Basic cart management

### v1.1
- [ ] BigBasket support
- [ ] Scheduled reordering
- [ ] Price alerts

### v1.2
- [ ] Smart recommendations
- [ ] Optimal split calculation
- [ ] Order history tracking

## 🤝 Contributing

This is a personal project. Open to suggestions!

## ⚠️ Disclaimer

This tool automates browser interactions for personal convenience. Use responsibly and in accordance with platform Terms of Service.

---

**Created**: 2026-02-12