# Weimob MCP

> Weimob / 微盟 MCP gives your AI agent full control over major Chinese e-commerce operations. It lets you query, manage, and analyze products, customer records, and real-time orders directly from the Weimob platform without logging into a complex dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** omni-channel-retail, order-management, member-management, sales-analytics, inventory-tracking, marketing-saas

## Description

Running a retail shop in China means juggling inventory counts, tracking fulfillment status, and monitoring sales performance across multiple tools. This MCP connects your AI agent straight to the core data of the Weimob e-commerce system. You don't need to navigate deep menus or copy/paste figures anymore. Instead, you simply ask your agent what you need—like 'What were our top five sellers last week?' or 'How many units of SKU 123 are left?' Your agent handles the complex data retrieval, giving you accurate sales stats and detailed product info in a simple chat response. Because Vinkius hosts this MCP, you can access Weimob's entire suite of capabilities from one connection point. Whether you're managing a small mini-program store or running large-scale retail operations, your agent acts as an instant, real-time retail assistant.

## Tools

### get_customer
Retrieves specific details about a customer by name or ID.

### get_goods_detail
Fetches comprehensive information for a single product listing.

### get_inventory
Checks the current stock quantity and availability of any specific SKU.

### get_order
Retrieves detailed information for a single, specific order ID.

### get_sales_stats
Generates summarized performance statistics covering revenue and sales volume over defined periods.

### get_shop_info
Gets general, high-level operational information about the linked Weimob shop account.

### list_categories
Provides a list of all major product categories available in the store.

### list_customers
Generates an initial list of customer records associated with the shop.

### list_goods
Retrieves a comprehensive listing of all products currently sold through the store.

### list_orders
Provides an initial list of recent orders, allowing you to select specific transactions for deeper review.

## Prompt Examples

**Prompt:** 
```
List all products currently on sale in my Weimob shop.
```

**Response:** 
```
I've retrieved your on-sale goods. You have 25 active products, including 'Summer Dress' and 'Smart Watch'. Would you like more details or stock levels for any of them?
```

**Prompt:** 
```
Show me the last 5 orders from today.
```

**Response:** 
```
I've listed the last 5 orders. They include transactions for 'Organic Coffee' and 'Wireless Earbuds'. Total revenue from these orders is approximately ¥2,800. Should I check the fulfillment status for any of them?
```

**Prompt:** 
```
Get sales statistics for the last 7 days.
```

**Response:** 
```
Across the last 7 days, your shop generated ¥150,000 in revenue from 450 orders. Your top-selling category is 'Electronics'. Would you like a more detailed breakdown by product?
```

## Capabilities

### Retrieve Product and Category Data
You can list all available goods, get specific product details, and browse the shop's categories to find exactly what you need.

### Track Orders and Fulfillment Status
List recent orders or retrieve detailed order information to check on delivery status and track fulfillment progress.

### Manage Customer Records
Search for specific member profiles, including contact details and purchase history, allowing you to understand customer value.

### Monitor Inventory Levels
Check the current stock level for any product SKU in your shop instantly, ensuring accurate inventory counts before listing items.

### Analyze Sales Performance
Get high-level sales statistics and performance summaries to understand revenue trends over specific time periods.

## Use Cases

### Need to check stock before running a promotion.
The marketing team needs to know if they can run a flash sale on the 'Smart Watch'. Instead of checking 20 different product pages, they ask their agent. The agent uses `get_inventory` and reports back the exact count for that SKU in seconds.

### A customer calls with an order issue.
The support rep needs to quickly find out why Order #987 failed delivery. They ask their agent, which then uses `get_order` and provides the full transaction history, including payment and fulfillment notes.

### Analyzing last month's top performers.
The analyst wants to know which product category brought in the most money. They prompt their agent for sales stats, triggering `get_sales_stats` and receiving a breakdown of revenue by category.

### Finding out more about an old customer.
A salesperson needs to follow up with a key client who bought something six months ago. They use the agent, which triggers `get_customer`, pulling up the full purchase history and contact info.

## Benefits

- Track inventory across the board. Instead of manually checking separate dashboards, you can use the `get_inventory` tool to confirm stock levels for any SKU instantly.
- Understand customer behavior faster. By using `list_customers` and then `get_customer`, your agent pulls together purchase history and contact details in a single query.
- Get clear sales reports immediately. The `get_sales_stats` tool gives you immediate revenue summaries, so you don't have to wait for the end-of-month reporting cycle.
- Streamline order tracking. You can use `list_orders` to see recent activity and then drill down with `get_order` to check specific fulfillment details.
- Know your product catalog instantly. Use `list_goods` or `list_categories` to get a full view of what's on sale, saving time otherwise spent clicking through multiple tabs.

## How It Works

The bottom line is you talk to your agent normally, and it executes complex e-commerce queries against Weimob's live data.

1. Subscribe to this MCP using your Weimob Client ID and Client Secret.
2. Connect the credentials to your preferred AI client, like Cursor or Claude.
3. Ask your agent a natural language question (e.g., 'List all orders for today') and get structured data back immediately.

## Frequently Asked Questions

**How do I check current stock levels using Weimob MCP?**
You use the `get_inventory` tool by providing the specific SKU you want to check. The agent returns the exact quantity available in real-time.

**Can I see details for a single order with Weimob MCP?**
Yes, you use the `get_order` tool and must provide the unique order ID. This gives you everything from payment status to product list.

**What kind of sales data does get_sales_stats provide?**
The `get_sales_stats` tool provides aggregated performance metrics, typically including total revenue and the number of orders within a specified date range.

**Does Weimob MCP help me find product details?**
Yes. You use `list_goods` to see all available items, and then `get_goods_detail` to retrieve full specs for any single item.

**How do I list customers using Weimob MCP?**
You first run the `list_customers` tool to get a roster. Then you use `get_customer` on an individual ID to pull their specific profile and history.