# KDniao MCP > KDniao connects your AI agent to China's major logistics network, giving you full visibility into e-commerce shipping and supply chain operations across the country. Use this MCP to track any package, identify carriers from a tracking number, estimate delivery timelines, or even schedule pickups, all through natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** logistics-tracking, waybill-management, express-delivery, supply-chain, carrier-integration, real-time-updates ## Description This MCP lets your AI agent manage complex Chinese logistics without needing to touch a single tracking portal. You can talk to your agent and get instant status updates on shipments across hundreds of carriers, turning complicated supply chain monitoring into simple conversation. Need to know where an order is? Your agent tracks the package in real time. Planning a bulk shipment? It estimates pricing and arrival times for specific routes. Want proof of delivery details? You can even ask it to identify the original shipper just from the tracking number. Whether you're running customer support or auditing fulfillment, your AI agent acts as your professional logistics assistant. Because Vinkius hosts this MCP, you connect once and gain immediate access to powerful tools for handling everything from creating electronic waybills to setting up automated status alerts. ## Tools ### create_electronic_waybill Generates the required digital shipping waybill document for a consignment. ### get_estimated_arrival Predicts the delivery time of a package using specific route data. ### identify_carrier Automatically detects which logistics company is handling the shipment from its tracking code. ### onsite_pickup Requests a courier to pick up goods directly from the specified location. ### preorder_pickup Schedules a future date and time for a courier to collect items. ### query_shipping_price Retrieves an accurate cost estimate based on the package size, route, and weight. ### subscribe_tracking Sets up automated webhook alerts to notify you whenever a shipment status changes. ### track_package Retrieves the full, real-time movement history and current location of a specific package. ## Prompt Examples **Prompt:** ``` Track package 'YTO123456789' using carrier code 'YTO'. ``` **Response:** ``` I've retrieved the traces for your YuanTong package. It has been delivered and signed for at 2:30 PM today in Beijing. Would you like to see the full delivery history? ``` **Prompt:** ``` Identify the shipper for tracking number '7890123456'. ``` **Response:** ``` Based on the tracking number format, the most likely shipper is 'ZTO Express' (ZTO). I can also check if it might belong to other carriers like Yunda or EMS if you prefer. ``` **Prompt:** ``` Estimate arrival time for an SF Express package from Shanghai to Hangzhou. ``` **Response:** ``` I've checked the route statistics. A standard SF Express shipment from Shanghai to Hangzhou typically arrives within 24 hours. Would you like me to check the estimated price for this route as well? ``` ## Capabilities ### Track real-time package location Get the current and historical journey details for any domestic or international shipment. ### Calculate delivery estimates Determine predicted arrival dates or figure out shipping costs before sending a product. ### Identify shippers by tracking number The agent automatically figures out which company originally shipped the item based on its code. ### Schedule pickups and waybills Request a courier to pick up items or generate necessary electronic shipping documentation. ### Set status change alerts Ask the system to monitor a package and send an automatic alert when its status changes. ## Use Cases ### A customer asks about an overdue package. Instead of giving the customer generic advice and having to manually check 4 different websites, you ask your agent to `track_package`. The AI instantly pulls the latest status, tells you where it is, and provides a clear timeline for resolution. ### You are fulfilling an order from multiple suppliers. Before sending out the invoice, you ask your agent to `query_shipping_price` for each item's route. It compiles all the necessary cost estimates so you can give the client one accurate total price. ### You need to know who sent a package with an unknown tracking number. The shipment arrived, but your team doesn't know who originally sent it. You prompt the agent to `identify_carrier` using just the number, and it tells you the most likely shipper company right away. ### You need to schedule a bulk collection of returned goods. Instead of calling a courier yourself, you instruct your agent to use `preorder_pickup` or `onsite_pickup`, scheduling the exact time and location for the recovery shipment. ## Benefits - Stop jumping between carrier websites. With this MCP, your AI agent handles all tracking and status checks using `track_package` in a single conversation. - Save time on planning. Instead of calling logistics partners for quotes, the agent uses `query_shipping_price` to get instant, accurate rates and estimates. - Automate customer updates entirely. Use `subscribe_tracking` to set up alerts; you'll know when a status changes without having to check manually. - Simplify paperwork. Need documentation? Your agent generates the necessary shipping record using `create_electronic_waybill`, taking manual form filling off your plate. - Solve mystery tracking numbers. If you only have a code, use `identify_carrier` to instantly know which company is responsible for delivery. ## How It Works The bottom line is that you get a single, conversational interface for managing all of your China-based logistics needs. 1. Subscribe to this MCP, providing your unique KDniao EBusinessID and AppKey credentials. 2. Connect the MCP to your preferred AI client (like Claude or Cursor). 3. Use natural language prompts with your agent to request tracking updates, pricing estimates, or pickup scheduling. ## Frequently Asked Questions **How does KDniao help me calculate shipping costs?** You use the `query_shipping_price` tool, which takes package details and routes to provide an instant cost estimate. This eliminates manual quotes from different carriers. **Can I set up automatic tracking updates with KDniao MCP?** Yes, you run the `subscribe_tracking` tool. This tells the system to monitor a package and send automated alerts via webhook whenever its status changes, so you don't have to check manually. **What if I only know the tracking number, but not the carrier?** No problem. Your agent can use `identify_carrier` with just the code. It will automatically detect and tell you which logistics company is managing that specific shipment. **Is KDniao good for cross-border tracking?** The MCP supports both domestic Chinese shipments and international packages, giving you a broad range of visibility across various networks. **How do I create the necessary shipping paperwork using this MCP?** You use the `create_electronic_waybill` tool. This generates the required official digital waybill using specific sender and receiver details, ready for the carrier to accept.