estimate_price
Estimates the carrier's shipping fee from the carrier, the sending and receiving addresses and the parcel weight.
LABSCO SUMMARY
The arrival estimate splits by whether the parcel has left yet.
Before dispatch, the estimate works from the route, the order time and the service type. Once the parcel is moving, the second estimate takes the tracking history collected so far and revises the arrival from where it actually is. Fees are quoted per carrier from the two addresses and the weight, so a route can be priced and timed before anything is handed over.
What it is
A courier-logistics server over the Kuaidi100 API, covering parcel tracking, delivery-time estimates before and during transit, and shipping-fee estimates.
What you get
- The tracking history of a parcel, looked up by waybill number together with the phone number on the order.
- A pre-dispatch estimate from the carrier code, both addresses, the order time and the service type — arrival time and time in transit.
- An in-transit estimate that folds the tracking history so far into the revised arrival time.
- A shipping-fee estimate from the carrier, both addresses and the parcel weight.
Requirements
A Kuaidi100 API key, supplied as KUAIDI100_API_KEY. Tracking also needs the phone number attached to the order, not the waybill number alone.
Setup effort
One command plus a key — uvx kuaidi100-mcp, then supply credentials
USE CASES
01
Answering where a parcel has got to without opening the carrier's site
The waybill number and the phone number on the order return that parcel's tracking history in one call.
02
Quoting a delivery date before the parcel is handed over
The route, order time and service type produce an arrival estimate and the time in transit, and the same route with a weight gives the fee to expect.
03
Revising an arrival time for a parcel already on the road
The tracking history is pulled first, then fed into the in-transit estimate so the arrival time reflects where the parcel actually is.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
estimate_time
Estimates when a parcel will arrive and how long it will take from the carrier code, both addresses, the order time and the service type, before it is sent.
estimate_time_with_logistic
Estimates when a parcel in transit will arrive, from the carrier code, both addresses, the order time and the tracking history so far.
query_trace
Returns the tracking history of a parcel, taking the waybill number and the phone number on the order.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. All four are lookups; none books or pays for a shipment.
Requires
- uvx on PATH
- KUAIDI100_API_KEY in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"kuaidi100": {
"command": "uvx",
"args": [
"kuaidi100-mcp"
],
"env": {
"KUAIDI100_API_KEY": "<YOUR_KUAIDI100_API_KEY>"
}
}
}
}uvx
TERMINAL
uvx kuaidi100-mcpHosted endpoint
ENDPOINT URL
https://api.kuaidi100.com/mcp/sse?key=<YOUR_KUAIDI100_API_KEY>Add this hosted endpoint to your MCP client using the credentials listed under Requirements.
