# KuaiDi100 MCP for AI Agents AI Agent Connect

> KuaiDi100 is a package tracking MCP that connects your AI agent to China's leading logistics network. It lets you track domestic and international shipments, identify carriers, get price estimates, and manage waybills without leaving your chat window.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_urDXKOtIDziNBfjns8xXMGeT0spExcQovI2NIT7y/ai-agent-connect
- **Tags:** package-tracking, carrier-identification, logistics-automation, real-time-notifications, shipment-status

## Description

KuaiDi100 puts your AI agent in charge of the heavy lifting for Chinese logistics. Instead of jumping between tabs or manually entering tracking numbers into a web portal, you just ask your agent for the status of a shipment. It pulls real-time data from China's largest logistics network, tells you exactly where a package is, and even identifies the carrier if you only have a tracking number. If you're running a high-volume e-commerce store, you can use it to get shipping price estimates or check which carriers actually service specific routes. It handles the tedious stuff like subscribing to status updates and generating electronic waybills. You get a clear picture of your supply chain without the manual data entry. It's one of the many tools you can find in the Vinkius catalog to make your logistics workflow actually work for you.

## Tools

### estimate_delivery_time
Get a projected arrival date for a shipment between two locations. This helps you set accurate delivery expectations for your customers.

### get_map_tracking
Fetch data that shows the physical path a package took. It's perfect for visualizing the journey of an international shipment.

### identify_carrier
Input a tracking number to find out which shipping company is handling it. This saves you from having to guess based on the number format.

### query_shipping_price
Get a quote for shipping costs based on weight and destination. Use this to compare different carriers before booking.

### submit_shipping_order
Generate an electronic waybill for printing. This helps you get your packages out the door faster.

### subscribe_tracking
Set up a system to get notified automatically when a package status changes. You won't have to keep checking the status manually.

### track_package
Get the current status and history of a specific shipment. You can check where a package is in real-time.

### check_carrier_availability
See which carriers actually provide service on a specific route. Use this to find the best options for your shipping needs.

## Prompt Examples

**Prompt:** 
```
Track my Shunfeng package with number 'SF123456789'.
```

**Response:** 
```
I've retrieved the status for your SF Express package. It is currently in transit and arrived at the 'Shanghai Logistics Hub' at 10:30 AM today. It is expected to be delivered tomorrow.
```

**Prompt:** 
```
Identify which carrier uses number 'YT1234567890'.
```

**Response:** 
```
I've analyzed the tracking number. It most likely belongs to 'YuanTong Express' (yuantong). Would you like me to retrieve the real-time status for this package?
```

**Prompt:** 
```
Estimate the shipping cost for a 2kg package from Beijing to Shenzhen.
```

**Response:** 
```
I've retrieved price estimates for you. Shipping 2kg from Beijing to Shenzhen would cost approximately ¥18 via Yunda, ¥22 via ZTO, or ¥35 via SF Express (Standard). Which service would you prefer?
```

## Capabilities

### Track package status
Get real-time and historical data for any shipment.

### Identify carriers
Find out which shipping company has your package from a tracking number.

### Get price estimates
See how much shipping will cost based on weight and destination.

### Automate status updates
Set up push notifications for when a package moves.

### Generate waybills
Create and print electronic shipping orders instantly.

### Check route availability
See which carriers actually provide service on a specific route.

### Visualize shipment paths
Access map-ready data to see the physical journey of a package.

## Use Cases

### Bulk order status checks
An e-commerce owner needs to know where 50 different packages are. They ask the agent to check all of them at once using track_package.

### Comparing shipping costs
A logistics manager needs to find out which carrier is the cheapest for a 10kg box to Shenzhen. They use query_shipping_price to compare options.

### Identifying unknown carriers
A customer support rep gets a weird tracking number and needs to know who the carrier is. They use identify_carrier to get the exact name instantly.

### Automating shipment alerts
A warehouse manager wants to set up automatic alerts for all international shipments. They use subscribe_tracking to get real-time push notifications.

## Benefits

- Stop manual copy-pasting by using track_package to get instant shipment updates in your chat.
- Get accurate shipping quotes faster with query_shipping_price to compare costs across different carriers.
- Reduce customer wait times by using identify_carrier to quickly figure out who is handling a package.
- Automate your notifications with subscribe_tracking so you're always the first to know when a delivery happens.
- Simplify your paperwork by using submit_shipping_order to create electronic waybills on the fly.
- Improve delivery accuracy by using estimate_delivery_time to provide customers with realistic arrival windows.

## How It Works

The bottom line is you get a direct line to Chinese logistics data through a simple chat interface.

1. Subscribe to this Connector on the Vinkius Marketplace.
2. Add your KuaiDi100 Customer ID and API Key to your configuration.
3. Ask your AI client to track a package or estimate a shipping price.

## Frequently Asked Questions

**Can KuaiDi100 MCP track international packages?**
Yes, it tracks both domestic and international shipments within the Chinese logistics network.

**How do I use KuaiDi100 MCP to find a carrier?**
Just provide the tracking number to your agent, and it will identify the correct carrier for you.

**Can I get shipping quotes with KuaiDi100 MCP?**
Yes, you can ask for price estimates based on the weight of the package and the destination.

**Does KuaiDi100 MCP support automatic notifications?**
Yes, you can set up subscriptions to get real-time updates when a package's status changes.

**Can I generate shipping labels with KuaiDi100 MCP?**
Yes, it can generate electronic waybills which you can then print for your shipments.

**Is KuaiDi100 MCP good for high-volume e-commerce?**
It's ideal for e-commerce because it allows you to manage and query many shipments quickly through a single interface.

**How do I find my KuaiDi100 Customer ID and Key?**
Log in to the [KuaiDi100 API Portal](https://api.kuaidi100.com/), register for a developer account, and you will find your Customer Code (customer) and Authentication Key (key) in your account management dashboard.

**Do I need a phone number for tracking?**
Some premium carriers, especially Shunfeng (SF Express) and JD Logistics, require the last 4 digits of the recipient's phone number to retrieve tracking data for security reasons.

**Is international tracking supported?**
Yes! KuaiDi100 supports over 1,000 domestic and international carriers. You can use the `identify_carrier` tool if you are unsure which global company is handling your shipment.