# Douyin Local Life API MCP for AI Agents MCP

> Douyin Local Life API connects your AI agent directly to China's primary social commerce platform for managing physical retail and hospitality operations. Use it to check shop details, track order status, verify customer coupons, and update product inventory—all from a single conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** local-life, merchant-api, douyin, order-fulfillment, coupon-verification, social-commerce, poi-management, china-services

## Description

Managing local retail shops or restaurants involves jumping between multiple backend systems: checking the POS, looking up stock in one app, and confirming an order on another. This MCP lets your AI agent handle all that complexity through natural language. You don't need to navigate the Douyin Merchant Center; you just ask for what you need. Your agent can instantly retrieve shop metadata, list recent orders, verify customer coupons, or even check product stock levels across various locations. It acts like having a digital manager on call, giving you accurate, real-time data from one authorized source. Connect this MCP via Vinkius to give your AI client control over the entire local life operational flow.

## Tools

### get_order_detail
Retrieves comprehensive information and status updates for a specific placed order.

### get_product_detail
Fetches all the metadata required for a specific product listing or offering.

### get_product_stock
Checks and reports the current inventory count for any given product at a store location.

### get_shop_info
Retrieves general metadata about a specific shop or point of interest.

### get_verify_code
Validates customer coupon codes and confirms if an order is eligible for fulfillment.

### list_recent_orders
Provides a summary list of the most recent orders placed at a location.

### search_shops
Searches for shops or points of interest based on geographic criteria or keywords.

### update_product_stock
Manually adjusts the inventory count for a product at a specific shop location.

## Prompt Examples

**Prompt:** 
```
What are the shop details for POI ID 'POI_88210934' and what products do they sell?
```

**Response:** 
```
**Shop Metadata Retrieved:**
*   **Name:** Tasty Dumplings
*   **Status:** Active (Hours: 10am-10pm)
*   **Location:** Pudong District, Shanghai

**Top Products:**
| ID | Name | Price |
|---|---|---|
| PRD_9920 | Premium Set Menu | ¥88 |
| PRD_5432 | Steamed Dumplings | ¥12 |

The shop is currently accepting orders.
```

**Prompt:** 
```
I need to check the status of an order placed yesterday, and if possible, verify a coupon code '998877' for it.
```

**Response:** 
```
**✅ Coupon Verified:** The code '998877' is valid! It applies a 15% discount.

**📦 Order Status (ID: 6342):**
*   **Details:** Premium Set Menu + Steamed Dumplings
*   **Status:** Awaiting Fulfillment
*   **Next Step:** Ready for pickup in 30 minutes.
```

**Prompt:** 
```
What's the current stock count for 'PRD_9920' at my main branch (POI_8821)?
```

**Response:** 
```
**Inventory Check Complete.**

The product **Premium Set Menu** (ID: PRD_9920) currently has 45 units available at the specified shop location. This is a good buffer level, but we should monitor it closely.
```

## Capabilities

### Search and retrieve shop locations
Find metadata for specific shops or search for nearby points of interest.

### List and check order status
Pull up a list of recent orders and get the full details for any single transaction.

### Verify customer coupons
Check if a given coupon code is valid and confirm if an order can be marked as fulfilled.

### Monitor and adjust product inventory
Get current stock counts for products at specific locations, or manually update those levels.

### Access core product information
Retrieve detailed metadata about any life service offering or product sold through the platform.

## Use Cases

### A restaurant needs to confirm if today's large catering order is ready.
The agent uses `list_recent_orders` and then `get_order_detail` to check the status of the specific transaction. It confirms the order was processed, saving the manager a phone call to the kitchen.

### A retail worker needs to know if a customer's discount code is valid for a current sale.
The agent runs `get_verify_code` with the provided coupon number. It confirms validity and marks the order as ready for fulfillment, keeping the line moving quickly.

### A branch manager needs to audit inventory across three different locations before a holiday rush.
The agent uses `get_product_stock` multiple times for key items and then updates counts using `update_product_stock` when receiving the overnight shipment data.

### A developer needs to build a tool that shows product info based on shop location.
The agent first uses `search_shops` to find POIs nearby, then calls `get_shop_info`, and finally gets specific item data using `get_product_detail`.

## Benefits

- You can instantly list recent orders and pull full details using `list_recent_orders` and `get_order_detail`, eliminating the need to click through multiple dashboards.
- Avoid overselling products. Use `get_product_stock` before confirming a sale, and immediately adjust counts with `update_product_stock` when inventory changes hands.
- Speed up customer service: Quickly verify complex coupon codes using `get_verify_code`, ensuring the fulfillment process is secure and fast.
- Operational visibility improves by letting your agent search for shops (`search_shops`) and retrieve their core metadata (`get_shop_info`) without needing a web browser.
- Stop relying on manual data entry. The MCP allows you to automate checking product details (`get_product_detail`), keeping all your sales information centralized.

## How It Works

The bottom line is you get to manage complex local retail tasks simply by talking to your agent.

1. Subscribe to this MCP and input your Douyin Client Key, Client Secret, and App Private Key.
2. Connect your preferred AI client (Claude, Cursor, or any compatible agent) through the Vinkius catalog.
3. Ask your AI client a question—like 'What's the stock for product X at shop Y?'—and let it handle the API calls.

## Frequently Asked Questions

**How do I find my Douyin Client Key and Secret?**
Log in to the [Douyin Open Platform](https://open.douyin.com/), create an application, and you will find your unique Client Key and Client Secret in the application details overview.

**What is a POI ID?**
A POI ID (Point of Interest ID) is a unique identifier for a physical store or location registered within the Douyin ecosystem. It is required for all store-specific operations like inventory management.

**Can I verify coupons in real-time?**
Yes! Use the `verify_order_coupon` tool with the customer's verification code and your POI ID. Your agent will communicate with Douyin to confirm the coupon is valid and mark the order as fulfilled.