# Cornershop MCP MCP

> Cornershop MCP automates B2B grocery delivery management via natural conversation with your AI agent. Search specific products across multiple local stores, build shopping carts, place full orders, track shoppers in real time, and adjust items mid-shop—all without opening the mobile app.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** grocery-delivery, last-mile, order-fulfillment, shopping-cart, real-time-availability

## Description

Running a corporate office or managing client deliveries shouldn't require jumping between five different apps. This MCP connects your AI agent directly to Cornershop by Uber, letting you handle complex last-mile grocery logistics using simple conversation. Need supplies for the week? You can start by searching local partners—like Jumbo or Lider—to check which stores are closest and have what you need. Once you know the store, you can search specific SKUs to verify pricing and availability instantly. From there, it handles everything else: building a complete shopping cart and placing the order for delivery. You don't have to wait by the phone; your agent monitors the entire process, giving live updates on where the shopper is and when the items will arrive. If you realize you forgot coffee filters while they’re already in the store, you can tell your agent to modify the cart immediately. It’s a massive time saver, letting you manage complex logistics directly through Vinkius, no matter which AI client you're running.


## Tools

### cancel_order
Cancels a pending delivery order, provided the shopper hasn't started picking items yet.

### create_order
Places an entirely new delivery order using product IDs and your specific address details.

### create_webhook
Sets up a dedicated webhook to receive explicit notifications about orders.

### get_order
Retrieves the full, detailed information for a specific delivery order ID.

### get_product
Gets all available details about one particular product, such as weight or brand.

### get_store
Retrieves specific information about a single store branch location.

### list_orders
Lists all your active and past delivery orders for review.

### list_shoppers
Gathers contact details and current status information about the shopper assigned to your order.

### list_store_aisles
Lists all product categories and aisles available within a specific store location.

### list_stores
Provides a comprehensive list of all partnering grocery stores, filterable by geography.

### list_webhooks
Displays the list of order webhooks you have configured in your account.

### search_products
Searches for specific grocery items and returns their matching SKU, current price, and stock status.

### track_order
Provides the real-time location and progress update for an active delivery order.

### update_order
Modifies an ongoing order by adding or removing items from the cart mid-shopping trip.

## Prompt Examples

**Prompt:** 
```
Search for Jumbo stores near latitude -33.4372 and longitude -70.6506 (Santiago Centro).
```

**Response:** 
```
I found 3 Jumbo stores serving that location: 1. Jumbo Costanera Center (Store ID: JMB-992, Delivery ETA: 90 mins). 2. Jumbo Bilbao (Store ID: JMB-841, Delivery ETA: 120 mins). 3. Jumbo Paseo San Bernardo (Store ID: JMB-221, Delivery ETA: Next day). Which store would you like to search products in?
```

**Prompt:** 
```
Where is the shopper for my order #CS-44919?
```

**Response:** 
```
Tracking order #CS-44919: The order is in 'delivering' status. Your Shopper (Carlos V., rating 4.9) is currently 3 blocks away (Lat: -33.412, Lng: -70.590) heading southbound. Current ETA is 7 minutes. Would you like me to verify the drop-off instructions?
```

**Prompt:** 
```
Place an order at Lider (ID: LDR-10) for 2 units of SKU 'Milk-Whole-1L' and deliver into the corporate office.
```

**Response:** 
```
Order successfully created! Order ID #CS-89821 has been placed at Lider (LDR-10) for 2x 'Milk-Whole-1L'. The total including service fees is $3,250. A Shopper will be assigned shortly and delivery is scheduled for the next 60 minutes window. I will notify you when shopping begins.
```

## Capabilities

### Discover local retail options
Find and compare multiple grocery stores and partners available in your area.

### Check product details and pricing
Search for specific SKUs across connected stores to confirm availability and current cost.

### Build and finalize delivery orders
Create a complete shopping cart from scratch or place an entire order with one command.

### Manage orders while in progress
Add, remove, or replace items on the cart even after the shopper has started picking goods.

### Monitor delivery status live
Get real-time GPS tracking and status updates for your assigned shopper and order.

## Use Cases

### The office needs last-minute supplies.
A manager asks their agent, 'We're out of coffee filters.' The agent uses `list_stores` to find local partners near the office. It then runs `search_products` for 'coffee filters', confirms availability and price at Jumbo, and uses `create_order` to place the entire delivery before the end of the day.

### The primary item was out of stock.
A procurement agent asks their agent to check an order. The agent runs `get_product` for a specialty tea and sees it's unavailable at the original store. It then suggests alternatives using `list_store_aisles` before running `update_order` to swap out the item.

### The delivery is delayed.
A user asks, 'Where is my shopper?' The agent uses `track_order`, which gives them the current GPS location. They can then use `list_shoppers` to get the contact name and rating if they need to call ahead.

### The order needs total cancellation.
A user realizes a mistake was made before anything was picked. The agent first uses `get_order` to verify the status, confirming it's pending picking, and then calls `cancel_order` to stop the whole process.

## Benefits

- You gain complete visibility into your supply chain. Instead of checking separate dashboards, you can use the `list_stores` tool to find local partners and then follow up with `list_store_aisles` to narrow down exactly where the item is kept.
- Never open a mobile app just to adjust a count. If you realize you need two more bottles of shampoo while the shopper is still in the store, use the `update_order` tool to add it instantly and continue monitoring the whole process.
- Get instant stock verification. Before placing an order, you can run `search_products` to confirm that a specific SKU is available at the desired price point across different stores.
- Stay informed without constant phone calls. The MCP tracks your order status using `track_order`, giving you real-time location and estimated time of arrival updates directly through your agent's conversation flow.
- Control the entire lifecycle. You can go beyond just placing an order with `create_order`; if something goes wrong, you have tools like `get_order` or `list_shoppers` to immediately get details and resolve the issue.

## How It Works

The bottom line is: once set up, managing complex grocery orders becomes a simple chat exchange with your AI client.

1. Subscribe to this MCP and provide your Cornershop Client ID and Secret keys through the B2B portal.
2. Connect these credentials to your AI agent via any compatible client, granting it access to your logistics account.
3. Tell your agent what you need—for example, 'Place an order for 5 cartons of eggs at Jumbo.'—and let it handle the rest.

## Frequently Asked Questions

**How do I find out which stores carry products near me using list_stores?**
You call `list_stores` and provide your latitude and longitude. This tool returns a list of all partnering grocery locations in the area, allowing you to pick the best one for your needs.

**Can I check product availability without placing an order using search_products?**
Yes. `search_products` is designed specifically for this. You input a SKU or name and get back real-time data on its current pricing and whether it's in stock at specific stores.

**What if I need to change the order after it's been placed?**
You use `update_order`. This tool lets you add or remove items from the cart even while the shopper is physically inside the store, bypassing the need for human intervention.

**How do I get all my past and current orders at once?**
You call `list_orders`. This gives you a comprehensive list of every order ID associated with your account, letting you know exactly what’s pending or delivered.

**When can I use the cancel_order tool to avoid penalties?**
You must cancel the order before the assigned shopper starts picking. The system only permits penalty-free cancellations if the pick process hasn't begun. Otherwise, you risk fulfillment fees.

**How do I set up automated alerts using create_webhook?**
You configure webhooks to receive real-time status updates for specific events like shopper assignment or order delivery completion. You can list existing hooks using the list_webhooks tool to verify setup.

**What information do I get when I run get_order?**
This function returns the full, comprehensive details for a single order ID. It includes not just status and items, but also payment breakdowns and specific store IDs required for reporting.

**If there’s an issue with delivery, how do I find shopper contact information using list_shoppers?**
The list_shoppers tool provides key information about the assigned person. You get access to their contact details and performance rating, helping you resolve issues instantly without calling customer support.