Get live parcel shipping rates from a US origin
get_parcel_quoteLive parcel rates from a US origin: USPS, UPS, FedEx; DHL Express to DE and AU. Describe the item to estimate the box, or give exact dimensions and weight. Up to five services, each a total with the SMKlog fee inside (itemized only on the checkout receipt). To buy on smklog.com: quote_id to create_checkout_link. Typical prices: get_price_index (free).
Parameter rules:
weight_lb, length_in, width_in, height_in count only as a set of four above zero, else the box is estimated.
One label per box: units that fit one box are priced as that box; more boxes or a quantity above 1 sent with exact dimensions: multiple_boxes.
Over 150 lb, 108 in longest side or 165 in length plus girth, or pallet or freight: mode not_a_parcel.
product: the item, up to 200 characters; a bare route, weight or question: product_not_recognized.
from_zip: a real 5-digit US ZIP, else invalid_us_zip.
to_country: US, CA, GB, DE or AU, else international_unsupported_online; to_zip follows it.
80 calls an hour per client.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"product": "<product>",
"from_zip": "<from_zip>",
"to_zip": "<to_zip>"
},
"name": "get_parcel_quote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to_zip | Yes | A 5-digit ZIP for the US, else the country's postal code, e.g. M5V 2T6 (Toronto), SW1A 1AA (London). | |
| product | Yes | Plain-words item description, e.g. "65 inch flat screen TV in original box". | |
| from_zip | Yes | Origin US ZIP code, 5 digits. | |
| quantity | No | How many of the item ship together. | |
| width_in | No | Packed box width, inches. | |
| height_in | No | Packed box height, inches. | |
| length_in | No | Packed box length, inches. | |
| weight_lb | No | Packed weight, pounds. | |
| to_country | No | Two-letter destination country: US (default), CA, GB, DE, AU. | US |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | parcel_label_ready when rates are listed; otherwise not_a_parcel, multiple_boxes or parcel_restricted | |
| rates | Yes | Up to five services. Not cheapest first: ranked by checkout total in cents plus 175 per business day in transit (30 when none is quoted), lowest first; a rate with a carrier counter price may lead a near-tie within 50 cents or 2 percent. Sort by amount yourself for the cheapest. | |
| package | No | The packed box the rates were computed for | |
| quote_id | No | Valid 15 minutes; pass it to create_checkout_link to skip a second carrier call. Null when no rate came back or it could not be stored. |