Skip to main content
Glama
Hardik500

quick-commerce-mcp

by Hardik500

πŸ›’ 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

# 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)

  • 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