# Meituan Waimai API MCP

> Meituan Waimai Open API / 美团外卖 connects your AI agent directly to China's top food delivery platform. Manage store status, confirm new orders, audit customer reviews, and track live courier progress—all through natural conversation. It takes the complexity of merchant portals and makes it conversational.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** food-delivery, merchant-operations, order-tracking, retail-orchestration, api-integration, delivery-management

## Description

Your agent handles all the heavy lifting associated with running a modern restaurant operation on Meituan Waimai. You can ask your AI client to confirm if store information is up to date, or check what categories are available for listing new items. Need to know how busy you are? Your agent retrieves detailed metadata and lists recent orders instantly. If a customer leaves feedback, the system pulls those user ratings right into the conversation so you don't miss anything. It even lets your agent manage store visibility; tell it to open the shop or put it offline when needed. All this happens without you ever needing to log into the massive Meituan Merchant Portal and click through half a dozen pages just to get basic operational data. By connecting this MCP via Vinkius, your AI client acts as a dedicated, always-on operations assistant for your entire delivery workflow.

## Tools

### cancel_order
Cancels an order and requires a specific reason code for the action.

### confirm_order
Confirms that a new, pending order has been accepted by the store.

### get_order_detail
Retrieves all specific information about an existing order ID.

### get_store_comments
Fetches a list of user reviews and comments left for the store location.

### get_store_info
Retrieves general, high-level operational metadata about the store's current status.

### list_categories
Provides a full list of food categories available for selling.

### list_recent_orders
Generates a filtered list of all orders that occurred within a specified time range.

### set_store_offline
Changes the store's status to offline, making it invisible on the platform.

### set_store_online
Restores the store's visibility and sets its operational status back to online.

### track_delivery
Provides a current, real-time update on the location and progress of an active delivery.

## Prompt Examples

**Prompt:** 
```
Show me the details for order 'ORD_88210934'.
```

**Response:** 
```
I've retrieved the details for order `ORD_88210934`. The total is 45.50 CNY. It includes 2x Beef Noodles and 1x Coke. The customer is located at 'Room 101, Bld 5, Shanghai Garden'. Would you like me to confirm this order now?
```

**Prompt:** 
```
Check the delivery status for the active order.
```

**Response:** 
```
I've checked the delivery progress. The courier, 'Zhang Wei', has picked up the order and is currently 1.5 km away from the destination. Estimated delivery time is in 8 minutes.
```

**Prompt:** 
```
Open my store 'STORE_8821' for new orders.
```

**Response:** 
```
Done! I've updated the status for store `STORE_8821` to 'Online'. You are now visible on the Meituan app and ready to receive new orders. Would you like me to list any pending orders?
```

## Capabilities

### Check store information
The tool retrieves current metadata about the physical store location and operational details.

### Manage online status
You can tell your agent to open or close the shop instantly, controlling its visibility on the platform.

### Handle incoming orders
The system confirms new orders and retrieves full details for any existing order ID.

### Track delivery progress
You can get a real-time status update on where the courier is relative to the destination.

### Review customer feedback
The agent pulls user comments and ratings, allowing you to monitor store performance by sentiment.

## Use Cases

### The Morning Prep Check
A manager needs to know if the store is ready before opening. Instead of checking the merchant portal, they prompt their agent: 'What's our current status?' The agent uses `get_store_info` and confirms if all necessary services are online.

### The Logistics Crisis
A customer calls about a late delivery. Instead of calling the courier, the ops team asks their agent to use `track_delivery`. The agent immediately reports the driver's current location and estimated arrival time.

### End-of-Day Reporting
A finance worker needs a batch list of all orders from last Tuesday. They ask their agent to use `list_recent_orders` for a specific date range, getting the data compiled instantly for auditing.

### Handling New Business Needs
A menu planner wants to know what food types they can sell. Instead of browsing the site, they ask their agent to use `list_categories` and get a clean list of available selling categories.

## Benefits

- Stop manually checking dashboards. Using the agent, you can instantly get a full order status using `get_order_detail` without navigating multiple screens.
- When labor hours are tight, use the tool to manage store visibility. Simply ask your agent to call `set_store_offline` when you close or `set_store_online` when you open up for business.
- Audit performance by pulling customer sentiment. Instead of reading through physical comment cards, your agent gathers all user ratings via `get_store_comments` directly into the chat.
- Manage the whole order lifecycle from a single prompt. You can confirm new orders using `confirm_order`, or use it to cancel an old one with specific reason codes via `cancel_order`.
- Get full oversight of your business history. The agent can list recent orders, and you can filter them by date range using `list_recent_orders` for financial checks.

## How It Works

The bottom line is that your AI client uses this MCP to convert complex, multi-step operational tasks into single, natural language prompts.

1. Subscribe to this MCP on Vinkius and input your Meituan Client ID and Secret credentials.
2. Connect the service to your preferred AI client, like Cursor or Claude.
3. Ask your agent a question about operations. For example: 'What's the delivery status for order XYZ?' The tool handles the API call and gives you a direct answer.

## Frequently Asked Questions

**How does Meituan Waimai Open API / 美团外卖 handle store status?**
It lets your agent control whether the shop is visible to customers. You can use `set_store_offline` when you close and `set_store_online` when you open, ensuring accurate service availability.

**Can I get details for a specific order with Meituan Waimai Open API / 美团外卖?**
Yes. You use the agent to call `get_order_detail` and provide the order ID, receiving all metadata—items, total cost, customer address—in one go.

**Does this MCP help with tracking deliveries? (Meituan Waimai Open API / 美团外卖)**
Absolutely. You ask the agent to use `track_delivery`, and it provides a real-time location update, telling you how far away the courier is and when they'll arrive.

**What if I need to cancel an order using Meituan Waimai Open API / 美团外卖?**
You ask your agent to `cancel_order`. It handles the process and requires you to specify a reason code, which is crucial for auditing purposes.

**Can I check customer reviews with Meituan Waimai Open API / 美团外卖?**
You can use `get_store_comments` to pull current user ratings and comments. This lets you monitor customer satisfaction directly within your agent chat.