Back to Blog
MCPMarch 20, 202612 min read

Connect Any AI to Real-Time Grocery Data with QuickCommerce MCP Server

Give Claude, Cursor, Windsurf, or any MCP-compatible AI tool the ability to search products, compare prices, and check delivery ETAs across 7 Indian quick commerce platforms — in natural language.

#MCP#Model Context Protocol#Claude Desktop#Cursor#AI tools#function calling

Imagine asking your AI assistant: **"What's the cheapest Amul Butter near me right now?"** — and getting back live prices from BlinkIt, Zepto, Swiggy Instamart, BigBasket, DMart Ready, JioMart, and Minutes within seconds. No code, no browser tabs, no spreadsheets.

That's exactly what the **QuickCommerce MCP Server** makes possible. MCP — the Model Context Protocol — is an open standard that lets AI tools call external APIs as natural extensions of their reasoning. Instead of copying data from websites into your chat, the AI fetches it directly.

QuickCommerce API is the first grocery data provider to offer a hosted MCP server. You don't install anything. You don't write any code. You just paste a URL into your AI tool's config and start asking questions about grocery prices in plain English.

5+

AI Tools Supported

Claude, Cursor, Windsurf, etc.

7

Available Tools

Search, ETA, Compare...

<1 min

Setup Time

Just paste a URL

7

Platforms Queried

All Indian QC platforms

What Is MCP and Why Does It Matter?

The **Model Context Protocol (MCP)** is an open standard created by Anthropic that lets AI models call external tools during a conversation. Think of it as "plugins for AI" — but standardised, secure, and supported across multiple clients.

Before MCP, if you wanted Claude or ChatGPT to access live data, you had to build custom integrations, write wrapper scripts, or copy-paste data manually. MCP changes this by defining a universal protocol: the AI tool discovers available tools from an MCP server, understands their parameters, and calls them automatically when a user's query requires live data.

Here's what makes QuickCommerce's MCP server special: **it's hosted**. Most MCP servers require you to install Python packages, clone repos, and run local processes. Ours runs at `https://api.quickcommerceapi.com/mcp` — you just point your AI tool to the URL and you're done.

How MCP Connects AI to Grocery Data

💬You Ask"Compare milk prices on Zepto vs BlinkIt near me"
🧠AI ReasonsClaude/Cursor picks group_search tool, sets platforms & query
MCP ServerQuickCommerce API fetches live data from both platforms
📊Rich AnswerAI formats results: prices, images, availability, delivery ETA

AI Tools That Work with QuickCommerce MCP

Any tool that supports the MCP Streamable HTTP transport can connect to QuickCommerce. Here are the most popular ones:

AI ToolTypeMCP SupportBest For
Claude DesktopChat Assistant✅ NativePersonal grocery research, meal planning
Claude CodeCLI Agent✅ NativeBuilding apps, data pipelines, scripts
CursorCode Editor✅ NativeDeveloping quick commerce apps
WindsurfCode Editor✅ NativeAI-assisted development
VS Code + CopilotCode Editor✅ Via extensionGeneral development with live data
Custom AgentsSDK✅ MCP SDKProduction bots, automated workflows

Setup: 60 Seconds to Live Grocery Data in Your AI

You need two things: your QuickCommerce API key (free 50 credits on signup at quickcommerceapi.com/auth/signup) and the MCP config below. That's it.

Claude Desktop / Claude Code

Open your MCP settings file (`~/.claude.json` for Claude Code, or Settings → Developer → MCP Servers in Claude Desktop) and add:

claude_desktop_config.json
{
  "mcpServers": {
    "quickcommerce": {
      "url": "https://api.quickcommerceapi.com/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

Tip

Replace `your-api-key-here` with your actual API key from the [Dashboard](https://quickcommerceapi.com/dashboard). You get 50 free credits on signup — no credit card required.

Cursor / Windsurf

In Cursor, go to **Settings → MCP Servers → Add Server**. In Windsurf, open **Settings → MCP**. Use the same config:

MCP Server Configuration
{
  "name": "QuickCommerce",
  "url": "https://api.quickcommerceapi.com/mcp",
  "headers": {
    "X-API-Key": "your-api-key-here"
  }
}

Local Installation (Optional)

If you prefer running the MCP server locally (for airgapped environments or custom modifications), install the Python package:

Install & run locally
# Install
pip install quickcommerce-mcp

# Run with your API key
QUICKCOMMERCE_API_KEY=your-key quickcommerce-mcp
Local MCP config (stdio transport)
{
  "mcpServers": {
    "quickcommerce": {
      "command": "quickcommerce-mcp",
      "env": {
        "QUICKCOMMERCE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Info

The hosted version at `api.quickcommerceapi.com/mcp` is recommended for most users — zero setup, automatic updates, and no local dependencies. The local version is for advanced use cases.

The 7 Tools Your AI Gets Access To

When you connect to the QuickCommerce MCP server, your AI tool automatically discovers all 7 tools. It knows each tool's parameters, descriptions, and when to use them. Here's the full toolkit:

ToolWhat It DoesCreditsExample Prompt
search_productsSearch products by keyword on one platform1"Find paneer on Zepto near Bangalore"
get_item_detailsGet real-time price & stock for a specific item1"What's the current stock of item #501346 on BlinkIt?"
check_delivery_etaDelivery time & store status for a platform1"How fast can Swiggy deliver to Koramangala?"
group_searchSearch across multiple platforms in one callN (per platform)"Compare Atta prices on BlinkIt, Zepto, and DMart"
group_etaETAs from multiple platforms in one callN (per platform)"Which platform delivers fastest to Mumbai 400001?"
check_creditsCheck your remaining credit balanceFree"How many credits do I have left?"
list_platformsList all supported platformsFree"What platforms are supported?"

Real Conversations: What You Can Ask

The magic of MCP is that you don't need to know API parameters or endpoints. You just ask naturally. Here are real conversations that work out of the box:

Example 1: "Find Me the Cheapest Atta"

Your prompt (natural language)
You: Compare 5kg Atta prices across all platforms near
     Sarjapur Road, Bangalore (560103)

Claude: I'll search for Atta across all 7 platforms using group_search.

[Calls group_search with query="Atta 5kg",
 platforms="BlinkIt,Zepto,Swiggy,BigBasket,DMart,JioMart,Minutes",
 lat=12.9021, lon=77.6639, pincode="560103"]

Here's what I found:

| Platform   | Product                        | Price  |
|------------|--------------------------------|--------|
| DMart      | Samrat MP Chakki Wheat Atta    | ₹206   |
| BlinkIt    | Whole Farm Chakki Atta         | ₹207   |
| JioMart    | Good Life Chakki Atta          | ₹209   |
| Swiggy     | Fortune Chakki Fresh Atta      | ₹227   |
| BigBasket  | Aashirvaad Shudh Chakki Atta   | ₹245   |
| Zepto      | Aashirvaad Atta 5kg            | ₹249   |

DMart has the best price at ₹206. BlinkIt is a close second
at ₹207 with faster delivery (8 minutes vs DMart's 2PM-5PM slot).

Atta 5kg — Price Comparison Across Platforms

Example 2: "Who Delivers Fastest?"

Your prompt (natural language)
You: Which platform can deliver to Andheri West, Mumbai
     the fastest right now?

Claude: Let me check delivery ETAs for all platforms.

[Calls group_eta with platforms="BlinkIt,Zepto,Swiggy,BigBasket,DMart,JioMart,Minutes",
 lat=19.1364, lon=72.8296, pincode="400058"]

Here are the current delivery times:

| Platform   | ETA        | Status     |
|------------|------------|------------|
| Zepto      | 8 minutes  | ✅ Open    |
| BigBasket  | 10 minutes | ✅ Open    |
| BlinkIt    | 12 minutes | ✅ Open    |
| Swiggy     | 15 minutes | ✅ Open    |
| Minutes    | 22 minutes | ✅ Open    |
| JioMart    | N/A        | 🕐 Slot-based |
| DMart      | 2PM-5PM    | 🕐 Slot-based |

Zepto is fastest at 8 minutes. If you need it NOW, go with Zepto.
For bulk orders, DMart's 2PM-5PM slot has better prices.

Delivery ETA Comparison — Andheri West, Mumbai

Example 3: "Plan My Weekly Grocery List"

Your prompt (natural language)
You: I need milk, bread, eggs, and onions near HSR Layout,
     Bangalore. Find me the cheapest option for each across
     all platforms.

Claude: I'll search for each item across all platforms and find
the best deal for each.

[Calls group_search 4 times — once per item]

Here's your optimized shopping list:

| Item       | Best Platform | Price  | Delivery |
|------------|--------------|--------|----------|
| Amul Milk  | DMart        | ₹27    | 2PM-5PM  |
| White Bread| BlinkIt      | ₹40    | 10 min   |
| Eggs (12)  | Zepto        | ₹72    | 8 min    |
| Onion 1kg  | BigBasket    | ₹35    | 12 min   |

Total: ₹174 if you split across platforms
vs ₹198 on BlinkIt alone (saving ₹24)

Quick tip: If convenience matters more, BlinkIt has everything
at ₹198 delivered in 10 minutes.

Example 4: "Competitive Price Audit" (Business)

Your prompt to Claude Code / Cursor
You: I'm a brand manager for XYZ Ghee. Search for "ghee" on
     all platforms in Mumbai and show me how our product is
     priced compared to competitors like Amul and Gowardhan.

Claude: I'll do a competitive price audit across all platforms.

[Calls group_search with query="ghee", all 7 platforms, Mumbai coords]

Competitive Price Audit — Ghee (Mumbai 400001):

| Brand         | BlinkIt | Zepto  | Swiggy | BigBasket | DMart  |
|---------------|---------|--------|--------|-----------|--------|
| Amul Ghee 1L  | ₹620    | ₹615   | ₹625   | ₹610      | ₹599   |
| Gowardhan 1L  | ₹545    | ₹550   | ₹549   | ₹540      | ₹529   |
| XYZ Ghee 1L   | ₹580    | ₹575   | N/A    | ₹570      | N/A    |

Key findings:
- Your product is NOT listed on Swiggy and DMart — missing revenue
- You're priced 6% higher than Gowardhan on BlinkIt
- BigBasket offers your most competitive placement at ₹570

MCP Server Use Cases

Under the Hood: How the MCP Server Works

The QuickCommerce MCP Server uses the **Streamable HTTP transport** — the newest and most efficient MCP transport. Unlike older SSE-based servers, Streamable HTTP uses standard HTTP POST requests with JSON-RPC, making it compatible with any HTTP client and firewall-friendly.

1

Discovery

Your AI tool sends an "initialize" request to `https://api.quickcommerceapi.com/mcp`. The server responds with its capabilities: 7 tools, their names, descriptions, and parameter schemas.

2

Tool Selection

When you ask a question, the AI model reads the tool descriptions and decides which one(s) to call. For "compare milk prices on Zepto and BlinkIt" it picks `group_search`.

3

Execution

The AI sends a `tools/call` JSON-RPC request with the tool name and arguments. The MCP server calls the QuickCommerce REST API internally and returns the results.

4

Response

The AI receives the structured JSON data and formats it into a human-readable answer — tables, comparisons, recommendations, or whatever makes sense for your question.

POST /mcpMCP initialize handshake — what happens when your AI tool connects
Request (cURL)
POST https://api.quickcommerceapi.com/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
X-API-Key: your-api-key

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "id": 1,
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientInfo": {
      "name": "claude-desktop",
      "version": "1.0"
    }
  }
}
Response (JSON)
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-03-26",
    "capabilities": {
      "tools": { "listChanged": false }
    },
    "serverInfo": {
      "name": "QuickCommerce API",
      "version": "1.26.0"
    }
  }
}

Try it live in the API Playground →

POST /mcpMCP tools/call — AI calling group_search for price comparison
Request (cURL)
POST https://api.quickcommerceapi.com/mcp
Content-Type: application/json
X-API-Key: your-api-key

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 3,
  "params": {
    "name": "group_search",
    "arguments": {
      "query": "Amul Butter 500g",
      "platforms": "BlinkIt,Zepto,Swiggy",
      "lat": 12.9021,
      "lon": 77.6639,
      "api_key": "your-api-key"
    }
  }
}
Response (JSON)
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"BlinkIt\": {\n    \"products\": [\n      {\n        \"name\": \"Amul Pasteurised Butter\",\n        \"brand\": \"Amul\",\n        \"price\": 295,\n        \"mrp\": 310,\n        \"quantity\": \"500 g\"\n      }\n    ]\n  },\n  \"Zepto\": { ... },\n  \"Swiggy\": { ... }\n}"
      }
    ]
  }
}

Try it live in the API Playground →

Hosted vs Local: Which Should You Choose?

FeatureHosted (Recommended)Local (pip install)
SetupPaste URL + API keypip install + env config
UpdatesAutomatic — always latestManual pip upgrade
DependenciesNonePython 3.10+, pip
TransportStreamable HTTPstdio (subprocess)
Latency~200ms (server-to-server)~250ms (local → API)
FirewallWorks anywhere with HTTPSNeeds outbound HTTPS
Offline❌ Needs internet❌ Needs internet (for API calls)
Custom tools❌ Fixed toolset✅ Can extend in Python
Best forMost users, teamsDevelopers, custom agents

Credit Costs: What Does It Cost?

MCP calls use the same credit system as the REST API. The AI tool deducts credits for each tool call it makes. Here's the breakdown:

ToolCreditsTypical Usage
search_products1 per callSingle platform search
get_item_details1 per callCheck specific item price/stock
check_delivery_eta1 per callSingle platform ETA
group_search1 per platformCompare across N platforms (N credits)
group_eta1 per platformETAs from N platforms (N credits)
check_creditsFreeCheck balance anytime
list_platformsFreeNo auth required

A typical question like "compare Atta on all 7 platforms" costs 7 credits (one per platform). You can ask "how many credits do I have?" anytime — it's free. Start with 50 free credits on signup, then top up from ₹99 for 500 credits.

Tip

Pro tip: Ask the AI to use `group_search` instead of searching platforms individually. "Compare X on BlinkIt, Zepto, and Swiggy" (3 credits) is cheaper than three separate "search X on BlinkIt" calls — and gives you the comparison in one response.

Try It Without Installing Anything

Don't have Claude Desktop or Cursor? You can try the MCP-powered chat directly in your browser at quickcommerceapi.com/mcp/chat. It uses the same tools, shows the same rich product cards, and works on mobile too. Just log in and start asking.

Security & Privacy

Your API key is sent via the `X-API-Key` header over HTTPS — it never appears in URLs or logs. The MCP server is stateless: it doesn't store your queries, results, or conversation history. Each request is authenticated, executed, and forgotten.

The hosted MCP server runs on the same AWS App Runner infrastructure as the REST API, in `ap-south-1` (Mumbai). All traffic is encrypted with TLS 1.3. The server has no access to your AI tool's conversation history — it only sees the specific tool call parameters.

Build Your Own Agent with MCP

The MCP server isn't just for chat interfaces. You can build autonomous agents that use QuickCommerce tools to make purchasing decisions, monitor prices, or generate reports. Here's a minimal Python example using the MCP SDK:

Python: Build a price monitoring agent
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def price_check():
    """Check Amul Butter prices across platforms."""
    headers = {"X-API-Key": "your-api-key"}

    async with streamablehttp_client(
        "https://api.quickcommerceapi.com/mcp",
        headers=headers,
    ) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # List available tools
            tools = await session.list_tools()
            print(f"Available tools: {[t.name for t in tools.tools]}")

            # Search across platforms
            result = await session.call_tool(
                "group_search",
                arguments={
                    "query": "Amul Butter 500g",
                    "platforms": "BlinkIt,Zepto,Swiggy,BigBasket",
                    "lat": 12.9021,
                    "lon": 77.6639,
                    "api_key": "your-api-key",
                },
            )

            print(result.content[0].text)

asyncio.run(price_check())
TypeScript: Connect from Node.js
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport }
  from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://api.quickcommerceapi.com/mcp"),
  { requestInit: { headers: { "X-API-Key": "your-api-key" } } }
);

const client = new Client({ name: "my-agent", version: "1.0" });
await client.connect(transport);

// Call any tool
const result = await client.callTool({
  name: "group_search",
  arguments: {
    query: "Milk 1L",
    platforms: "BlinkIt,Zepto",
    lat: 19.076,
    lon: 72.8777,
    api_key: "your-api-key",
  },
});

console.log(result.content);

Frequently Asked Questions

Does the AI store my grocery searches?

The QuickCommerce MCP server is stateless — it does not store queries or results. Your AI tool (Claude, Cursor, etc.) may store conversation history according to its own privacy policy, but the MCP server forgets everything after each request.

Can I use MCP with ChatGPT or Gemini?

Not yet — MCP is currently supported by Anthropic's Claude and several code editors. However, you can use the REST API with any AI tool that supports function calling (OpenAI, Gemini, etc.). The browser chat also works for everyone.

What happens if I run out of credits mid-conversation?

The tool will return an error message saying "Insufficient credits" with a link to the pricing page. The AI will relay this to you. You can top up instantly and continue the conversation.

Is pincode required for all platforms?

Pincode is only required for **DMart, JioMart, and Minutes**. For BlinkIt, Zepto, Swiggy, and BigBasket, latitude and longitude are sufficient. If you ask the AI about DMart without a pincode, it will tell you one is needed.

Get Started Now

The QuickCommerce MCP Server is live and ready. Sign up, grab your API key, paste the config, and ask your AI about grocery prices. It takes less than 60 seconds.

1

1. Sign Up Free

Create your account at quickcommerceapi.com/auth/signup. Get 50 free credits instantly.

2

2. Copy Your API Key

Find it in the Dashboard under your profile.

3

3. Add MCP Config

Paste the JSON config into your AI tool. Set the URL to `https://api.quickcommerceapi.com/mcp` and add your key as `X-API-Key` header.

4

4. Start Asking

"Compare Atta prices on all platforms near me" — and watch the magic happen.

Ready to Get Started?

Sign up for free and get 50 credits instantly. No credit card required. Start querying 7 quick commerce platforms with a single API.