# Temu Seller Hub MCP

> Temu Seller Hub handles cross-border e-commerce operations through Temu's Open Platform API. Your AI agent manages everything from retrieving global buyer orders and monitoring payment status to syncing inventory levels, creating shipments, and processing returns—all without needing to log into the seller console.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** temu, pdd, dropshipping, fulfillment, inventory, cross-border

## Description

Listen up. This **Temu Seller Hub MCP Server - E-commerce Fulfillment** connects your AI client directly to Temu's Open Platform API, letting you manage cross-border e-commerce operations without ever having to log into the seller console yourself. You don't need to touch a dashboard; your agent handles the whole supply chain lifecycle.

### Order & Fulfillment Tracking

When it comes to orders, start with `get_order_list`; this tool pulls a paginated list of Temu orders for any date range you give it. You can then grab deep into specific purchases using `get_order_detail`, which gives you every piece of information on an order—line items are included, and so is the current payment status. When an order's ready to go, use `create_ship_order` via the v2 API; that marks the order as shipped and generates the necessary shipping records. You can always check what shipments already went out by calling `get_ship_order_list`.

### Inventory Management

Inventory control is critical, so we give you tools to keep your stock count accurate across the globe. Use `get_inventory` to get a list of current stock counts for every active SKU in your system. When you get new goods or fulfill a restock request, you'll use `sync_inventory` to update the exact stock quantity for a specific SKU and push that new number directly back to Temu's platform. If you need to plan for restocking, `get_purchase_orders` retrieves any incoming stock requests or purchase orders from the platform.

### Product & Catalog Auditing

Want to audit your listings before they crash? You can list every published item in your catalog using `get_goods_list`. If you only need details on one specific piece, `get_goods_detail` fetches the full product information for a single Item ID. For even deeper specs, use `get_goods_sku`, which gets detailed, SKU-level specifications and data for any particular variant. These tools let you check everything your store is running without manual effort.

### Returns and Logistics Planning

When stuff comes back or needs to be shipped out, we got you covered. Start by calling `get_aftersale_list`; it retrieves a list of all pending return or after-sale requests for your store. You can track the status of these returns and handle reverse logistics efficiently. Before shipping anything, check what carriers are legit using `get_logistics_companies`, which queries and returns a complete list of supported shipping methods on Temu.

By running these tools through your agent, you manage global fulfillment—from listing products to marking them shipped—all without ever having to log into the seller portal. It’s pure automation.

## Tools

### create_ship_order
Uses the v2 API to mark a specific order as shipped and create necessary shipping records.

### get_aftersale_list
Retrieves a list of all pending return or after-sale requests for your store.

### get_goods_detail
Fetches the full product details for one specific item ID on Temu.

### get_goods_list
Lists all published products currently available in your Temu store catalog.

### get_goods_sku
Gets detailed, SKU-level specifications and data for a particular product variant.

### get_inventory
Lists the current stock count across all active SKUs in your inventory system.

### get_logistics_companies
Queries and returns a list of shipping carriers supported by Temu.

### get_order_detail
Retrieves every piece of information for one specific order, including line items and payment status.

### get_order_list
Gets a paginated list of Temu orders based on a date range you provide.

### get_purchase_orders
Retrieves incoming stock requests or restocking purchase orders from the platform.

### get_ship_order_list
Lists all existing shipping records you have created through the system.

### sync_inventory
Updates the stock quantity for a specific SKU, reflecting new count data to Temu's platform.

## Prompt Examples

**Prompt:** 
```
Get my Temu orders from the last 24 hours and summarize pending fulfillment.
```

**Response:** 
```
Orders retrieved! You have 15 new orders in the last 24 hours. 11 are pending fulfillment, 3 are already shipped, and 1 is awaiting payment confirmation. The pending orders total $2,340 USD across 8 different destination countries. Would you like me to flag orders approaching the shipping SLA deadline?
```

**Prompt:** 
```
Mark order TMU-2024-88712 as shipped with tracking number YT2048391004.
```

**Response:** 
```
Order TMU-2024-88712 has been successfully marked as shipped! Carrier: Yanwen Express. Tracking: YT2048391004. The buyer will receive a notification with the tracking link automatically. Estimated delivery: 7-12 business days to destination (USA). Would you like to process the remaining 10 pending orders?
```

**Prompt:** 
```
Update inventory for SKU TMU-SHOE-42BLK to 250 units.
```

**Response:** 
```
Inventory updated! SKU TMU-SHOE-42BLK is now set to 250 units (previously 45 units). The change will be reflected on the Temu storefront within 5 minutes. Note: this SKU had 3 pending orders — the new stock level comfortably covers demand. Should I run a full inventory audit across all your active SKUs?
```

## Capabilities

### Order & Fulfillment Tracking
Get a list of Temu orders by date range, retrieve full details for specific orders, and initiate the process to mark an order as shipped.

### Inventory Management
List all SKU inventory levels across your store and update stock quantities for individual SKUs when you receive a new shipment.

### Product & Catalog Auditing
List published products or fetch detailed specifications for any specific product to check listings before an audit run.

### Returns and After-Sale Handling
Retrieve a list of incoming return requests (after-sale items) and check their refund status.

### Logistics Planning
Query supported shipping carriers available on Temu to ensure you select the right option for a shipment.

## Use Cases

### A large shipment arrived, and you need to update stock.
You just got 500 units of SKU ABC-123. Instead of manually logging into the seller console and finding the right field, your agent runs `sync_inventory(SKU='ABC-123', quantity=500)`. The system confirms the update immediately, letting you move on to fulfillment.

### A buyer claims an order is stuck and needs tracking.
The customer asks for status updates. You use `get_order_detail(order_id='TMU-123')` to pull all info—the payment date, the last known shipping carrier, and if it's already marked as shipped via `create_ship_order`. Problem solved in seconds.

### You suspect a product listing is out of sync.
Before running an ad campaign, you need to verify specs. You run `get_goods_sku(sku='XYZ')` to pull the precise dimensions and material data directly from Temu's platform, ensuring your website copy matches.

### You need a complete overview of all current orders.
It’s time for weekly reconciliation. You use `get_order_list` with date filters to pull every order created last week. Then you can run through the list, checking pending payments or fulfillment status using other tools.

## Benefits

- Stop losing time manually checking stock. `sync_inventory` updates SKUs instantly, stopping oversells before they happen.
- Never miss a shipment detail again. Use `get_order_detail` to get full line items and payment status for any single order ID.
- Streamline logistics planning by using `get_logistics_companies`. It tells you which carriers are actually supported on Temu.
- Handle returns faster. The `get_aftersale_list` tool gives you a clean list of all RMA requests, so you can track refunds efficiently.
- Manage your entire catalog from one place. Run `get_goods_list` or `get_goods_sku` to audit product data across hundreds of listings at once.

## How It Works

The bottom line is you give it your Temu API keys, and your AI agent does the rest of the heavy lifting for order processing and stock updates.

1. Register as a developer on the Temu Open Platform website.
2. Create an application there and obtain your required App Key and App Secret credentials.
3. Generate an Access Token using the seller OAuth flow, then feed those tokens into the server. The engine handles all signing automatically.

## Frequently Asked Questions

**How do I check if an order is ready to ship using get_order_detail?**
You must use `get_order_detail` first. This tool provides the full payment status and line-item data, confirming that all necessary steps—like payment verification—are complete before you call `create_ship_order`.

**What is the difference between get_goods_list and get_goods_sku?**
`get_goods_list` gives you a broad overview of all products published in your store. Use `get_goods_sku` when you need deep, specific data for one variant—like its exact dimensions or weight—for logistics planning.

**Can I use get_inventory to see historical stock levels?**
No, `get_inventory` provides the current live count across all active SKUs. If you need past data, you must check your internal ERP or accounting system, not this API.

**What should I use if an order needs to be flagged as shipped?**
You call `create_ship_order`. This tool uses the necessary shipping APIs (v2) and requires a valid tracking number before it marks the order as fulfilled.

**When I use get_order_list, what are the best practices for handling pagination or huge volumes of data?**
The tool supports pagination and uses create/before timestamps. You must implement a loop that fetches data in chunks (e.g., 100 records at a time) to prevent hitting API limits and ensure you get all historical orders.

**If I use get_goods_detail and the product ID is invalid, how should my agent handle the resulting error?**
The tool returns specific HTTP status codes for errors. Your agent needs to check for '404 Not Found' immediately and skip that item instead of throwing a critical failure. Always log the bad SKU.

**What is the workflow difference between checking current stock with get_inventory versus tracking incoming supplies via get_purchase_orders?**
get_inventory shows your immediate, active stock count right now. Use get_purchase_orders when you need to track what Temu plans to send you next—it’s for forecasting and restocking planning.

**For initial setup, how does the connection process affect using tools like create_ship_order?**
The initial OAuth flow provides a temporary Access Token. You must ensure your agent automatically refreshes this token before every API call to keep the shipping and order creation functions running without interruption.

**How do I obtain the Access Token required for authentication?**
You must complete the OAuth 2.0 authorization flow using your App Key through your specific seller account on the Temu Open Platform. The flow will generate an Access Token that grants scoped permissions to your store's order, inventory, and logistics data.

**Can I manage inventory across multiple SKU variants simultaneously?**
Yes! The `sync_inventory` tool accepts batch SKU updates. You can push quantity changes for multiple product variants in a single call, and the engine handles all MD5 signature computation and parameter encoding automatically.

**Is there any risk of accidentally modifying live product listings or canceling orders?**
All write operations require explicit parameters — order IDs, SKU identifiers, tracking numbers — that must be deliberately specified. The Access Token is scoped to your seller account, and the MD5 signature layer prevents request forgery. Critical actions like order cancellation are logged and require confirmation parameters.