Parcel Tracking

Use Parcel Tracking to retrieve real-time shipment tracking information through a parcel tracking provider.

Supported tools

get_official_carrier_name

Search carriers by name keyword (supports fuzzy typos). Use this when you need the “official” carrier name to pass to tracking.

Parameter	Description	Required	Default
`query`	Keyword to search carrier names (case-insensitive, typos allowed).	Yes
`limit`	Max number of results to return.	No	`10`

Output: JSON string containing a list of matching official carrier names.

track_parcel_delivery_status

Track a parcel / shipment delivery status.

Parameter	Description	Required	Default
`number`	The tracking number of the parcel.	Yes
`carrier_name`	Optional carrier name. If carrier auto-detect fails, use `get_official_carrier_name` to find the correct name and retry.	No	`""`

Output: JSON string containing tracking information (or an error message).

Call track_parcel_delivery_status with the tracking number.
If you get a “carrier not found” error, call get_official_carrier_name with a carrier keyword (for example, “DHL”).
Retry track_parcel_delivery_status with carrier_name set to the official carrier name.