# KDniao MCP for AI Agents AI Agent Connect > KDniao MCP lets you manage Chinese logistics and express deliveries through your AI agent. Track packages, identify carriers, and get shipping quotes without leaving your workspace. It handles waybill creation and real-time status updates for domestic and international shipments. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_nT46YVQb8QZIDe2Rb0S31sVyhGiJE9B60bBipijz/ai-agent-connect - **Tags:** logistics-tracking, waybill-management, express-delivery, supply-chain, carrier-integration, real-time-updates ## Description KDniao gives your AI agent a direct line into one of China's most reliable logistics networks. Instead of jumping between different tracking portals and copy-pasting waybill numbers, you can just ask your agent to handle the heavy lifting. It turns complex shipment monitoring into a simple conversation. You can check where a package is, figure out which carrier is handling it, and even get estimated arrival times or shipping prices on the fly. If you're running an e-commerce store or managing a supply chain, this Connector removes the friction of manual data entry. It's like having a professional logistics coordinator who never sleeps. You can set up automated alerts so you're the first to know when a status changes, or generate electronic waybills with just a few words. By connecting this to your workspace through Vinkius, you get a unified interface for all your shipping needs. It's about getting accurate data without the usual headache of navigating dense logistics portals. Whether you're auditing a supply chain or providing real-time customer support, you can manage domestic and international shipments with the same set of tools. This makes it a go-to for any operation that relies on China-based express delivery, giving you the ability to move goods faster and keep your customers informed without the usual administrative overhead. ## Tools ### create_electronic_waybill Create an electronic shipping waybill. Use this to generate digital shipping labels using sender and receiver info. ### get_estimated_arrival Get estimated delivery time. Use this to see when a package is likely to arrive at its final destination. ### onsite_pickup Request on-site courier pickup. Use this to have a courier come to your location to collect a shipment. ### preorder_pickup Schedule a courier pickup. Use this to book a specific time for a courier to collect your goods. ### query_shipping_price Get shipping price estimate. Use this to find out how much it costs to ship items along specific routes. ### subscribe_tracking Subscribe to tracking updates via webhook. Use this to get automatic alerts whenever a package status changes. ### track_package Track a package in real-time. Use this to see the current location and full history of a domestic or international shipment. ### identify_carrier Auto-detect carrier from tracking number. Use this to instantly find out which shipping company is handling a specific package. ## Prompt Examples **Prompt:** ``` Check the status of package YTO123456789. ``` **Response:** ``` I've retrieved the tracking details for that package. Here is the current status: | Detail | Information | | :--- | :--- | | **Current Status** | In Transit | **Last Location** | Shanghai Distribution Center | **Estimated Delivery** | October 24, 2023 **Recent History:** * 10:15 AM - Arrived at sorting facility * 08:30 AM - Departed from origin warehouse Would you like me to set up a notification for when this status changes? ``` **Prompt:** ``` Identify the shipper for tracking number 7890123456. ``` **Response:** ``` Based on the tracking number format, the shipping company for this package is **ZTO Express**. I can also check for other carriers like Yunda or EMS if you're unsure about the tracking number. Would you like me to do that? ``` **Prompt:** ``` Give me a shipping price for a package going from Shanghai to Hangzhou. ``` **Response:** ``` I've pulled the latest shipping estimates for that route: * **Standard Delivery:** $12.50 (Estimated 24-48 hours) * **Express Delivery:** $22.00 (Estimated 12-24 hours) * **Economy Delivery:** $8.00 (Estimated 3-5 days) Would you like me to book a pickup for one of these options? ``` ## Capabilities ### Track real-time package status Get the current location and full history for domestic or international shipments. ### Identify the shipping carrier Automatically detect which shipping company is handling a specific tracking number. ### Set up automated status alerts Receive pushed notifications whenever a package status changes. ### Predict delivery arrival times Get estimated delivery dates and times for your shipments. ### Create electronic waybills Generate digital shipping waybills using sender and receiver details. ### Request on-site courier pickups Schedule a courier to come to your location to collect a package. ## Use Cases ### Real-time customer support A customer asks for an update. The agent uses `track_package` and `get_estimated_arrival` to provide a full summary of the shipment's current status and expected delivery time. ### Warehouse pickup scheduling A warehouse worker needs a courier. The agent uses `preorder_pickup` to book a specific time for a courier to collect a shipment from the loading dock. ### Shipping cost auditing A logistics lead wants to compare prices. The agent uses `query_shipping_price` to fetch costs for three different routes to compare against the current budget. ### Bulk waybill generation An e-commerce seller has a new batch of orders. The agent uses `create_electronic_waybill` to generate the necessary shipping docs using the data in the order list. ## Benefits - Stop manual tracking: Use `track_package` to get instant history for domestic or international shipments without opening browser tabs or refreshing pages constantly. This keeps your data current and saves you from repetitive clicking. - Faster carrier identification: Use `identify_carrier` to instantly know which shipping company is handling a specific package. You won't have to guess or search through carrier lists when a customer asks for an update. - Automated alerts: Use `subscribe_tracking` to get pushed updates whenever a package status changes. This means you don't have to keep a tab open; your agent will notify you the moment a delivery milestone is hit. - Instant quotes: Use `query_shipping_price` to get shipping costs for specific routes during the checkout process or for audits. This helps you provide accurate pricing to your customers without manual calculations. - Easy waybill creation: Use `create_electronic_waybill` to generate digital shipping labels in seconds from your chat. It handles the sender and receiver details automatically, moving your orders from the screen to the dock. - Proactive delivery info: Use `get_estimated_arrival` to give customers accurate dates before they even ask. Knowing the estimated time of arrival helps you manage expectations and reduce the number of follow-up inquiries. ## How It Works The bottom line is you get a direct, conversational interface for managing Chinese logistics without the manual portal hopping. 1. Connect the KDniao MCP to your AI client using your EBusinessID and AppKey. 2. Tell your agent which package to track, which route to price out, or to create a new waybill. 3. Get immediate status updates, waybills, or price estimates in your chat. ## Frequently Asked Questions **What can I do with the KDniao MCP?** You can use it to manage Chinese logistics through your AI agent. This includes tracking packages in real-time, identifying carriers, getting shipping quotes, and creating digital waybills. **How does the KDniao MCP help with Chinese shipping?** It connects your AI agent directly to one of China's major logistics networks. This allows you to manage express deliveries and shipment monitoring without having to navigate complex web portals. **Can I create waybills using the KDniao MCP?** Yes, you can generate electronic shipping waybills directly through your agent. Just provide the sender and receiver details, and the Connector handles the rest. **How do I get real-time tracking with KDniao MCP?** The Connector allows your agent to fetch the most current location and history for domestic or international shipments. You can also set up automated alerts to get notified of status changes. **Can the KDniao MCP estimate shipping costs?** Yes, you can ask your agent to provide shipping price estimates for specific routes. This is helpful for auditing costs or providing quotes to customers during the checkout process. **Is the KDniao MCP good for e-commerce sellers?** It's built for e-commerce. It helps sellers automate tracking updates, manage waybill creation, and coordinate pickups, which saves significant time during daily fulfillment operations. **How do I find my KDniao EBusinessID and AppKey?** Log in to the [KDniao Portal](https://www.kdniao.com/), go to the 'User Center' or 'API Management' section, and you will find your unique EBusinessID and AppKey for integration. **What is the 'CustomerName' parameter?** For some carriers like Shunfeng (SF) and ZTO, KDniao requires the last 4 digits of the recipient's phone number in the 'CustomerName' field to retrieve tracking data. **Can I query shipping price estimates?** Yes. Use the `query_price` tool with the carrier code, origin city, destination city, and weight to retrieve estimated costs for that specific shipment.