[{"slug":"ZV-2026-0606","server_name":"quote-api.smklog.com","severity":"breaking","title":"quote-api.smklog.com: to_country on create_checkout_link narrowed to a closed enum (US, CA, GB, DE, AU); previously valid values may now be rejected.","summary":"[risky] Description of create_checkout_link changed (57% word delta). [breaking] to_country on create_checkout_link narrowed to a closed enum (US, CA, GB, DE, AU); previously valid values may now be rejected. [risky] Description of get_parcel_quote changed (46% word delta). [breaking] to_country on get_parcel_quote narrowed to a closed enum (US, CA, GB, DE, AU); previously valid values may now be rejected. [risky] Description of get_price_index changed (32% word delta). [risky] Description of track_parcel changed (44% word delta).","changes":[{"kind":"description_changed","tool":"create_checkout_link","after":"Turns a decided shipment into a payment session for buying its shipping label: the checkout amount and a handoff URL that opens SMKlog checkout prefilled with the parcel. Use it after get_parcel_quote, passing the quote_id that call returned, so the price is reused and no second carrier call is spent. Without a quote_id it prices the shipment live from the fields.\n\nSide effects: it writes a session record and is not idempotent. Calling it twice makes two sessions and, without a quote_id, spends two carrier calls. It never charges: no card is touched and nothing is reserved until the human confirms the contents certification and the carrier-adjustment consent on the page and pays there. A stale link simply reprices.\n\nNo session is returned when a person has to price the shipment: freight, oversize, a quantity above 1, or an installed lithium battery crossing a border. Quote first to learn which case applies.\n\nParameter rules:\n- A valid quote_id overrides product, from_zip, to_zip, to_country and quantity. service is still honored.\n- An expired quote_id falls back to live pricing from the fields. If those were omitted too, the call fails with missing_required_fields, so pass them alongside an old id.\n- service is matched as a case-insensitive fragment of the display name (\"Ground Advantage\", \"UPS Ground Saver\"). A fragment that matches nothing silently anchors the cheapest rate, so read the service field in the result.\n- from_zip is a real 5-digit US ZIP. to_zip follows to_country (US, CA, GB, DE or AU).\n- On the four international lanes the human completes the customs declaration on the page, and duty is billed to the recipient on arrival.","before":"Prices the shipment live and returns a payment session for buying the shipping label: the amount, and a handoff URL that opens the SMKlog checkout prefilled with this shipment. The human confirms the contents certification and the carrier-adjustment consent there and pays on Stripe hosted checkout. This tool never charges anything itself — MPP intent \"session\", not \"charge\". The two pricing tools are meant to be used in order, not chosen between: call get_parcel_quote first to compare services, then pass the quote_id it returns to this tool, which then spends no second carrier call. Calling this one without a quote_id is supported and prices the shipment live -- fine when the parcel is already decided and you never quoted it. Side effect and limits, stated rather than left to the annotations: it writes a session record on our side, it is not idempotent, and calling it twice makes two sessions and spends two carrier calls. Nothing is reserved and no card is touched until the human pays, and the link simply reprices if it goes stale. It cannot complete a purchase on its own — the human confirms the contents certification and the carrier-adjustment consent on the page, and on the four international lanes fills in the customs declaration there too. A shipment our rules send to a person (freight, oversize, an installed lithium battery crossing a border) returns no session at all: quote it first if you want to know which case you are in.","detail":"Description of `create_checkout_link` changed (57% word delta).","severity":"risky","descriptionDelta":0.5700934579439252},{"kind":"enum_narrowed","path":"inputSchema.properties.to_country","tool":"create_checkout_link","after":"enum[US,CA,GB,DE,AU]","before":"open","detail":"`to_country` on `create_checkout_link` narrowed to a closed enum (US, CA, GB, DE, AU); previously valid values may now be rejected.","severity":"breaking"},{"kind":"description_changed","tool":"get_parcel_quote","after":"Live shipping rates for one parcel sent from a US origin — inside the US, or to Canada, the UK, Germany or Australia — across USPS, UPS and FedEx. Describe the item in plain words and the packed box size and weight are estimated. Give exact dimensions and weight to skip the estimate. Returns up to five purchasable services with the checkout total, the carrier cost beneath it and the SMKlog fee stated separately.\n\nManual review: oversized, palletized or crated shipments are priced by a person. Clients that declare the io.modelcontextprotocol/tasks extension get a durable task handle (poll it with tasks/get, answers usually take a few business hours). Others get a pointer to the human review page. Shipping labels are bought on smklog.com, not through this tool.\n\nChoosing between the tools: use this one to answer what a shipment would cost. Then hand the quote_id it returns to create_checkout_link once the human has settled on shipping this exact parcel, so the pair costs one carrier call rather than two. Use get_price_index instead for typical or historical prices: it is free, while this tool spends a rate-limited carrier call every time.\n\nParameter rules:\n- weight_lb, length_in, width_in and height_in count only as a set of four, each above zero. Leave any one out and all four are ignored in favor of the estimate, so never send weight alone.\n- Online pricing covers one parcel up to 150 lb, 108 in on the longest side and 165 in of length plus girth. A heavier or larger box, a quantity above 1, or a product worded as freight (pallet, LTL, truckload, machinery, bulk) returns no rates and goes to a person.\n- product is the item itself, up to 200 characters. A bare route (\"to Canada\"), a bare weight (\"7 lbs\") or a question is refused as product_not_recognized before any carrier is called.\n- from_zip must be a real 5-digit US ZIP (ZIP+4 is trimmed to five), or the call fails with invalid_us_zip.\n- to_zip follows to_country: a 5-digit ZIP for US, otherwise that country's own postal code handed to the carriers as typed. A to_country outside US, CA, GB, DE and AU is refused as international_unsupported_online, so do not retry it with a different box.\n- Allowance: 80 calls an hour per client, shared with the public /quote route.","before":"Live shipping rates for one parcel sent from a US origin — inside the US, or to Canada, the UK, Germany or Australia — across USPS, UPS and FedEx. Describe the item in plain words and the packed box size and weight are estimated; give exact dimensions and weight to skip the estimate. Returns up to five purchasable services with the checkout total, the carrier cost beneath it and the SMKlog fee stated separately. Oversized, palletized or crated shipments are priced by a person: clients that declare the io.modelcontextprotocol/tasks extension get a durable task handle (poll it with tasks/get, answers usually take a few business hours); others get a pointer to the human review page. Shipping labels are bought on smklog.com, not through this tool. Choosing between the tools: use this one to answer what a shipment would cost, then hand the quote_id it returns to create_checkout_link once the human has settled on shipping this exact parcel -- that pairing costs one carrier call rather than two. Use get_price_index instead for typical or historical prices, because it is free while this tool spends a rate-limited carrier call every time.","detail":"Description of `get_parcel_quote` changed (46% word delta).","severity":"risky","descriptionDelta":0.461864406779661},{"kind":"enum_narrowed","path":"inputSchema.properties.to_country","tool":"get_parcel_quote","after":"enum[US,CA,GB,DE,AU]","before":"open","detail":"`to_country` on `get_parcel_quote` narrowed to a closed enum (US, CA, GB, DE, AU); previously valid values may now be rejected.","severity":"breaking"},{"kind":"description_changed","tool":"get_price_index","after":"The SMKlog parcel shipping price index: a monthly repriced basket of six common boxes (1 to 20 lb) shipped from Newark, NJ to five US cities, quoted through the same live USPS, UPS and FedEx pipeline that prices real shipments. Returns the cheapest purchasable service per box and lane with every rate behind it, plus basket averages. Reference data for questions like \"what does shipping a shoebox cost in the US right now\" — reading it spends no quote allowance. For a price on a specific shipment, call get_parcel_quote instead. Parameter rules: month names one published issue as YYYY-MM; issues exist from 2026-07 onward, one per month, and omitting month returns the newest. A month with no issue answers issue_not_found together with available_months, so one miss lists every valid value; anything not shaped YYYY-MM answers invalid_month. Every issue prices the same boxes and lanes, so two months compare cell for cell.","before":"The SMKlog parcel shipping price index: a monthly repriced basket of six common boxes (1 to 20 lb) shipped from Newark, NJ to five US cities, quoted through the same live USPS, UPS and FedEx pipeline that prices real shipments. Returns the cheapest purchasable service per box and lane with every rate behind it, plus basket averages. Reference data for questions like \"what does shipping a shoebox cost in the US right now\" — reading it spends no quote allowance. For a price on a specific shipment, call get_parcel_quote instead.","detail":"Description of `get_price_index` changed (32% word delta).","severity":"risky","descriptionDelta":0.31818181818181823},{"kind":"description_changed","tool":"track_parcel","after":"Track a shipment whose shipping label was bought on smklog.com, by carrier tracking number. Returns the current delivery status, the latest scan events and the estimated delivery date when the carrier reports one. Works for SMKlog labels only — it is not a universal tracker for arbitrary USPS, UPS or FedEx numbers, so a number from any other seller comes back not-found rather than as a status. Unrelated to the two pricing tools: it neither quotes nor spends quote allowance. Parameter rules: tracking_number is the only key; no order id or email is needed or accepted. It is matched after removing spaces and hyphens and ignoring case, so a pasted or spoken number works as-is. Expect USPS as 20 to 22 digits (13 characters ending in US for international), UPS as 1Z plus 16 characters, FedEx as 12 to 22 digits; anything shorter than 6 characters after cleanup is refused as tracking_number_required, and a number SMKlog never sold answers 404 tracking_not_found with status \"not_found\". Scan events come newest first, up to eight.","before":"Track a shipment whose shipping label was bought on smklog.com, by carrier tracking number. Returns the current delivery status, the latest scan events and the estimated delivery date when the carrier reports one. Works for SMKlog labels only — it is not a universal tracker for arbitrary USPS, UPS or FedEx numbers, so a number from any other seller comes back not-found rather than as a status. Unrelated to the two pricing tools: it neither quotes nor spends quote allowance.","detail":"Description of `track_parcel` changed (44% word delta).","severity":"risky","descriptionDelta":0.4358974358974359}],"published_at":"2026-09-01T19:46:50.978Z"}]