# KuaiDi100 MCP > KuaiDi100 MCP connects your AI agent to China's dominant logistics tracking platform, providing immediate visibility into complex supply chains. Instead of navigating carrier websites or manually entering numbers, you simply ask your agent for status updates, price estimates, or delivery timelines for any package in the region. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** package-tracking, carrier-identification, logistics-automation, real-time-notifications, shipment-status ## Description Managing international shipping requires juggling multiple carrier portals and deciphering cryptic tracking codes. KuaiDi100 makes that process disappear. This MCP gives your AI client direct access to China’s top logistics network. You can ask your agent things like, “What's the ETA for my order from Shanghai?” or “How much will it cost to ship this 5kg box to Shenzhen?” and get a precise answer instantly. It handles real-time status checks, automatically figures out which carrier is involved with just a tracking number, and even gives you price quotes before you commit to shipping. You never have to visit the KuaiDi100 website yourself; your agent does all that heavy lifting for you. Through Vinkius, this MCP lets you manage everything from simple status checks to setting up automated alerts, turning complex global logistics into a straightforward conversation. ## Tools ### check_carrier_availability Checks which carriers service a specific shipping route. ### estimate_delivery_time Calculates the predicted delivery time between two locations. ### get_map_tracking Retrieves visual, map-based data showing a shipment's physical route. ### identify_carrier Uses a tracking number to automatically determine the shipping carrier. ### query_shipping_price Fetches an estimate for the total cost of shipping based on weight and destination. ### submit_shipping_order Generates and submits a formal electronic waybill needed to start a shipment order. ### subscribe_tracking Sets up automated webhooks so you receive real-time notifications when the package status changes. ### track_package Retrieves a package's current, real-time status using its tracking number. ## 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 movements Retrieve the current and historical location data for any shipment. ### Determine carrier identity Automatically figure out which shipping company owns a given tracking number. ### Get cost estimates Calculate the expected shipping price for specific weights and routes. ### Predict delivery dates Estimate how long it will take a package to reach its destination. ### Set up alerts Activate push notifications that alert you when the status of a shipment changes. ### Create shipping orders Generate an official e-waybill for printing and submitting a new shipment order. ## Use Cases ### Inventory audit after customs delay A warehouse manager needs to know exactly where three different shipments are stuck. They ask their agent, 'What's the real-time status and map location for these three numbers?' The agent uses `track_package` and `get_map_tracking` across all numbers and presents a single, unified report. ### Quoting a client on cross-country logistics A sales rep needs to give a fast price quote for a new client. They ask their agent to 'Estimate the shipping cost for 10kg from Shanghai to Chengdu.' The agent uses `query_shipping_price` and provides immediate, detailed options. ### Handling a major shipment failure A logistics coordinator receives an alert that a package is delayed. They tell their agent, 'What's wrong with this tracking number?' The agent uses `identify_carrier` first to confirm the company, and then runs `estimate_delivery_time` to give a revised ETA. ### Setting up high-volume fulfillment An e-commerce team needs to process 50 outgoing orders. They prompt their agent: 'Generate the waybills and track these first five shipments.' The agent uses `submit_shipping_order` for the new batch, then runs `track_package` on the existing ones. ## Benefits - Instead of logging into five different carrier websites, your agent handles all tracking requests. You just ask for the status, and you get it immediately. - Stop guessing which company is running the shipment. The `identify_carrier` tool instantly tells you the responsible party from a single number. - Before quoting a client on shipping costs, use `query_shipping_price` to pull live estimates across multiple carriers for comparison. - Get visual confirmation of where packages are. Use `get_map_tracking` to visualize the actual journey instead of just reading text updates. - You can automate customer service completely. The `subscribe_tracking` tool sets up alerts, so your agent notifies you the moment a key status change occurs. ## How It Works The bottom line is you tell your agent what you need; it handles all the complex API calls and returns simple, actionable data. 1. Subscribe to this MCP, providing your required KuaiDi100 Customer ID and API Key. 2. Connect the credentials to your preferred AI client (like Cursor or Claude). 3. Ask your agent a natural language question, such as 'What's the status of my package with number X?' ## Frequently Asked Questions **How does KuaiDi100 MCP handle domestic vs international tracking?** The MCP handles both types of shipments using the `track_package` tool. It's built on China's leading platform, so it covers all major regional and cross-border routes. **Do I need a phone number to use KuaiDi100 MCP?** No, the MCP handles the necessary data inputs. While some specific carriers might require recipient details for tracking, your agent can manage this complexity for you when prompted. **Can I use KuaiDi100 MCP to estimate shipping costs?** Yes, using `query_shipping_price` lets you get detailed cost estimates based on weight and the specific route, helping you quote clients accurately before they ship. **What is the difference between `track_package` and `get_map_tracking`?** `track_package` gives you the text status updates (e.g., 'Arrived at Hub'). `get_map_tracking`, however, provides a visual map showing the actual geographical movement of the package. **How do I start using KuaiDi100 MCP with my AI agent?** You subscribe to this MCP and provide your API keys through Vinkius. Once connected, you can ask any compatible client (like Cursor or Claude) to perform logistics actions naturally.