Skip to content

zeptonow/mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

19 Commits
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Zepto MCP

The Zepto MCP allows MCP-compatible clients (such as Claude Desktop and Claude Code) to interact directly with Zepto's quick-commerce platform. It enables product search, cart management, order placement, and order history access through natural language conversations β€” across groceries, household essentials, personal care, electronics, toys, stationery, and more.

This integration is intended for Zepto customers in India with an active Indian mobile number.


πŸ§‘β€πŸ’» Who is it for?

The Zepto MCP is designed for end users who want the convenience of Zepto's shopping experience inside conversational AI clients. While early adopters are likely to be developers and power users, this is a consumer-facing integration that works with real Zepto accounts and real orders.


πŸ› οΈ Tools Available

πŸ” Search Products

Search Zepto's live product catalog using natural language queries. Results include real-time product availability, pricing, and relevant details.

πŸ›’ Cart Management

Manage your Zepto cart conversationally: - Add items to the cart\

  • Update quantities
  • Remove items

The cart stays in sync with your Zepto account.

πŸ“¦ Order Placement

Place Zepto orders directly from the MCP.

Notes: - Multiple payment methods are supported (see Payment Methods below). - Orders placed through the MCP are real Zepto orders and follow the same fulfillment flow as the Zepto app or website.

πŸ“œ Order History

Retrieve your past Zepto orders, including: - Order status (completed, cancelled, failed, etc.) - Ordered items - Prices and order details

This can be used to review previous purchases or understand order outcomes.


βš™οΈ Installation

The Zepto MCP uses OAuth authentication to securely connect to your Zepto account. Setup differs slightly by client.


Method 1: JSON Config (Claude Desktop, Cursor, VSCode etc.)

Claude Desktop provides a Developer Settings section that opens the MCP configuration file directly. Use that interface to add the Zepto MCP.

For Cursor, find the 'Tools & MCP' section inside Cursor settings, which will let you edit the config.

A working configuration looks like this:

{ 
    "mcpServers": { 
        "zepto": {
             "command": "npx", 
             "args": [ "mcp-remote", "https://mcp.zepto.co.in/mcp" ] 
        }
    }
}

After saving the configuration, restart your client. The Zepto MCP will then be available for use.


Method 2: Claude Code CLI

If you're using Claude Code, you can add the Zepto MCP with a single command:

claude mcp add --transport http --scope user zepto https://mcp.zepto.co.in/mcp

Follow the prompts to complete setup. Once added, Zepto tools will be available in your Claude Code sessions.


Method 3: ChatGPT

Zepto support for ChatGPT is implemented as an app and is currently in beta, pending approval from OpenAI. It is not yet available for general use.

Note: The ChatGPT integration is still in early development and may exhibit unexpected behavior or instability. We are actively working on improving reliability.

Once enabled, the ChatGPT experience will allow users to: - Search for groceries - Manage their Zepto cart - Place orders - View order history through a speciaised ChatGPT UI.

Steps to integrate

  1. Settings > Apps > Advanced settings > Enable Developer Mode
  2. Create App "Zepto" with url https://mcp.zepto.co.in/mcp
  3. Wait for OAuth to pop up and enter credentials
  4. Post authentication, Add @zepto in your messages to start using

Notes

  1. Enable "Local Network Access" to allow loading widgets properly
  2. ChatGPT's MCP experience is still maturing, there might be bugs post authentication and while loading tools

πŸ” Authentication

On first use, the MCP initiates an OAuth flow:

  1. You are redirected to a browser page
  2. Enter your Indian mobile number
  3. Verify using an OTP
  4. You are redirected back to the MCP client

After authentication, the MCP can securely access your Zepto account. Authentication can be cleared directly from the client if needed.

πŸ”— Allowed Redirect URIs

The following redirect URIs are whitelisted for MCP authentication:

  • claude://claude.ai/settings/connectors
  • https://claude.ai/api/mcp/auth_callback
  • https://insiders.vscode.dev/redirect
  • https://oauth.pstmn.io/v1/callback
  • https://vscode.dev/redirect
  • http://localhost
  • http://localhost/callback
  • http://127.0.0.1
  • http://127.0.0.1/callback

Please raise an issue you need additional URIs whitelisted.


πŸ’³ Payment Methods

The Zepto MCP supports multiple payment options:

  • πŸ’΅ Cash on Delivery (COD) β€” Pay when your order arrives.
  • πŸ“± UPI β€” Pay via any UPI app (GPay, PhonePe, etc.) through an in-conversation payment link.
  • πŸ’³ Cards β€” Credit and debit card payments via a secure checkout flow.
  • πŸ‘› Zepto Cash (Wallet) β€” Use your Zepto wallet balance to pay for orders.
  • πŸ”’ UPI Reserve Pay β€” Reserve-and-pay flow powered by NPCI and Razorpay. The amount is reserved upfront via UPI and charged upon order fulfillment.

You can ask the AI to show available payment methods for your order, or specify your preferred method directly β€” e.g. "Place my order using UPI" or "Pay with Zepto Cash".


πŸ’‘ Example Workflows

Here are some things you can try once the Zepto MCP is set up. Just type these as natural language prompts in your AI client.

1. πŸ›οΈ Quick Everyday Order

"Order 1L Amul Toned Milk, a dozen eggs, and a loaf of bread."

A straightforward flow β€” the AI searches for the items, adds them to your cart, and places the order. Great for quick everyday purchases.

2. πŸ”„ Reorder From History

"Reorder my last order"

The AI retrieves your most recent order, lists out the items, and adds them back to your cart so you can place the order again with a single confirmation.

3. 🍳 Recipe-Based Shopping

"I want to make paneer butter masala tonight for 4 people. Figure out what ingredients I need and order them from Zepto."

The AI generates a recipe ingredient list, searches for each item on Zepto, picks the right quantities, adds everything to your cart, and gives you a total β€” turning a dinner idea into a ready-to-place order.

4. πŸ“Έ Order From a Photo

[Attach a photo of a recipe card, a screenshot of a dish, or a fridge with missing items]

"Here's a recipe I found β€” order everything I'd need to make this."

The AI reads the image, identifies the ingredients or items, searches for them on Zepto, and builds your cart. Works with recipe screenshots, handwritten lists, or even a photo of a dish you want to recreate.

5. πŸŽ‰ Occasion-Based Shopping

"I'm hosting a Diwali party for 15 people this weekend. I'll need sweets, dry fruits, snacks, drinks, and some decorations. Put together a cart for me."

The AI plans a shopping list based on the occasion, searches across categories, adds appropriate items and quantities, and presents the full cart for your review β€” handling the thinking so you don't have to.


⚠️ Important Notes

  • This integration is not a sandbox or demo environment.
  • Any order placed through the Zepto MCP will be processed as a real Zepto order.
  • Multiple payment methods are supported β€” see Payment Methods for details.

πŸ”’ Privacy

This MCP does not persist or store conversation data.

The MCP only accesses data required to perform the requested actions (such as searching products, managing carts, placing orders, or retrieving order history) for the authenticated user.


πŸ’¬ Issues & Feedback

If you encounter issues, want to report bugs, or have feature requests, please use the GitHub Issues section of this repository.

About

Your favourite quick commerce app, now available as a MCP πŸš€

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors