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

Related MCP server: blinkit-mcp

πŸš€ 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

Available Tools

1 tool
get_cart_summaryB

Get current cart contents and total for specified platform.

ParametersJSON Schema
NameRequiredDescriptionDefault
platformYesPlatform to get cart from

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description must fully disclose behavior. It only says 'get', implying a read operation, but does not clarify whether the cart is user-specific or session-based, nor any potential side effects or limitations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence with no unnecessary words. It efficiently conveys the core purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity of the tool (one parameter, no output schema), the description adequately covers the basic purpose but lacks behavioral details that would fully inform an agent, such as how 'current' is defined or any authentication requirements.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage for the single parameter 'platform' with enum values. The description adds no extra meaning beyond the schema, so a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('get'), the resource ('cart contents and total'), and the scope ('for specified platform'). It is specific and leaves no ambiguity about what the tool does.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool, what prerequisites exist, or how it differs from alternatives. Since no sibling tools are listed, the absence of usage context reduces clarity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedget_cart_summary

TDQS

B3.2/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no risk of confusion between tools. The unique tool has a clear purpose.

Naming Consistency5/5

The sole tool 'get_cart_summary' follows a clear verb_noun pattern, which is consistent and descriptive.

Tool Count1/5

A single tool for a commerce server is far too few. Typical commerce operations require multiple tools (e.g., add/remove items, checkout), so this is an extreme mismatch.

Completeness1/5

The tool only retrieves cart summary, lacking any means to modify the cart, browse products, or complete purchases. This is severely incomplete for the stated domain.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    A Model Context Protocol server for real-time Swiss grocery shopping that searches and compares products across 8 major Swiss retailers (Migros, Coop, Aldi, Denner, Lidl, Farmy, Volgshop, Otto’s), normalizes per-unit prices, surfaces promotions, computes optimal multi-store shopping plans, and works with any MCP-compatible client without API keys or accounts.
    7
    82
    30
    AGPL 3.0
  • A
    license
    A
    quality
    C
    maintenance
    An API-only MCP server for Blinkit that enables automated shopping on the Indian quick-commerce platform, supporting login, search, cart, checkout, and payment via UPI.
    25
    1
    MIT