# SMKlog Parcel Shipping Rates [Verified] [Health: Active]

**Category:** 📦 Delivery  
**Repository:** https://github.com/smklog/parcel-shipping-rates-mcp  
**GitHub Stars:** 1  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/smklog-parcel-shipping-rates

## Description
Live USPS, UPS and FedEx shipping rates for a US parcel described in plain words. No scale needed.

## Tools
Capabilities this server exposes over MCP:

- **get_parcel_quote** — 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, and DHL Express on the German and Australian lanes. 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, each as one checkout total with the SMKlog fee inside it (the fee is itemized only on the checkout receipt) and, where the carrier publishes one, its own counter price for the same parcel beside it.

Not every request is priced. A shipment past parcel limits or described as a pallet or freight load returns mode not_a_parcel with no rates: SMKlog does not arrange pallet or freight shipments. More than one box returns mode multiple_boxes with no rates: one label per box, so quote each box with quantity 1. 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, 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.

Parameter rules:
- 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.
- One label per box. quantity counts units of the item: units that fit one box are priced as that box (two books go in one carton), and units that need more than one box return mode multiple_boxes, as does any quantity above 1 sent with exact dimensions, since those describe a single box. A box past the largest parcel any carrier here takes (150 lb, 108 in on the longest side, 165 in of length plus girth; USPS stops lower, and only services that take the box are listed) or a product described as a pallet or freight load (a pallet of, LTL, truckload, shipping container) returns mode not_a_parcel. Neither carries rates.
- 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.
- from_zip must be a real 5-digit US ZIP (ZIP+4 is trimmed to five), or the call fails with invalid_us_zip.
- 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.
- Allowance: 80 calls an hour per client, shared with the public /quote route.
- **create_checkout_link** — 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. The result carries a session_id: keep it, and get_checkout_status tells you when the human has paid and when the label exists.

Side effects: it writes a session record (30-day life, readable through get_checkout_status) 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.

No session is returned when the shipment cannot be sold online: not a parcel (SMKlog does not arrange pallet or freight shipments), more than one box (one label per box), or an installed lithium battery crossing a border. Quote first to learn which case applies.

Parameter rules:
- A valid quote_id overrides product, from_zip, to_zip, to_country and quantity. service is still honored.
- 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.
- 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 quote's first rate, which is the top of the best-value ranking and not always the cheapest, so read the service field in the result.
- from_zip is a real 5-digit US ZIP. to_zip follows to_country (US, CA, GB, DE or AU).
- On the four international lanes the human completes the customs declaration on the page, and duty is billed to the recipient on arrival.
- **track_parcel** — 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, FedEx or DHL 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. When the label was bought through a create_checkout_link session, get_checkout_status hands back this number at label_ready. 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.
- **get_price_index** — 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.
- **get_checkout_status** — Reports where a payment session made by create_checkout_link stands: whether the human has opened checkout, paid, and whether the shipping label exists yet, with the tracking number once it does. Reads SMKlog's own order records only: no carrier call, no quote allowance, nothing changes. Poll it after handing the human the link, minutes apart rather than seconds, because nothing moves until the human acts.

Statuses, in order: awaiting_checkout (link made, no checkout started), checkout_started (a checkout exists, not paid), paid (paid, label not created yet: the checkout page buys it right after payment, otherwise an operator picks it up), label_ready (label bought, tracking_number present), delivered, refunded. Once label_ready, feed tracking_number to track_parcel for scan events.

Parameter rules:
- session_id is the session_id returned by create_checkout_link, shaped as_ plus a UUID. Nothing else identifies a session: no order id, no email, no quote_id.
- A session lives 30 days from creation. An unknown, malformed or expired id answers session_not_found rather than a status.
- The answer never carries names, addresses or emails. Treat the session_id like a tracking number: whoever holds it can read the tracking number.
- A manual-review request made from the handoff page is not a checkout and leaves the status at awaiting_checkout.
- Allowance: 60 checks an hour per client.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "smklog-parcel-shipping-rates": {
    "command": "npx",
    "args": ["-y","github:smklog/parcel-shipping-rates-mcp"],
    "env": {
      "SMKLOG_MCP_URL": "",
      "SMKLOG_MCP_TIMEOUT_MS": "",
      "SMKLOG_MCP_DEBUG": ""
    }
  }
}
```

**Requires environment variables:** `SMKLOG_MCP_URL`, `SMKLOG_MCP_TIMEOUT_MS`, `SMKLOG_MCP_DEBUG` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What SMKlog Parcel Shipping Rates does

SMKlog Parcel Shipping Rates exposes parcel pricing and shipment follow-up through MCP. It handles shipments originating in the United States and traveling domestically or to Canada, the United Kingdom, Germany, or Australia. DHL Express is included for German and Australian lanes; USPS, UPS, and FedEx are used across the supported routes.

The central tool, `get_parcel_quote`, accepts a plain-language product description, origin ZIP code, destination information, and optional packed dimensions and weight. When measurements are omitted, the service estimates the packed box. Results include up to five purchasable services, checkout totals containing the SMKlog fee, and a carrier counter price where available.

Additional tools create a purchase handoff, report session progress, track labels purchased through SMKlog, and provide historical-style reference data through a monthly price index. Labels are purchased by a human on smklog.com rather than directly by an agent.

## How it works

A normal purchase flow starts with `get_parcel_quote`. Pass its `quote_id` to `create_checkout_link` after the human selects a service. Reusing the quote avoids a second carrier call. The checkout tool returns a payment URL and `session_id`; `get_checkout_status` can later report whether checkout was opened, paid, or turned into a label. Once a label exists, its tracking number can be sent to `track_parcel`.

The server prices one box per label. Exact `weight_lb`, `length_in`, `width_in`, and `height_in` must be supplied together; otherwise the values are ignored and the package is estimated. The origin must be a valid five-digit US ZIP. Supported destinations are the US, Canada, the UK, Germany, and Australia.

`get_price_index` is intended for general comparisons rather than a specific shipment. It covers six standard boxes weighing one to 20 pounds, shipped from Newark, New Jersey, to five US cities. Monthly issues begin with `2026-07`, and omitting the month selects the newest issue.

## Setup and configuration

The hosted MCP endpoint is:

`https://quote-api.smklog.com/mcp`

It uses streamable HTTP and requires no API key, OAuth flow, account, or client-side credentials. A local stdio bridge is also available through `npx` or Docker and forwards requests to the hosted endpoint. The bridge supports these optional environment variables:

- `SMKLOG_MCP_URL` changes the forwarding endpoint.
- `SMKLOG_MCP_TIMEOUT_MS` sets the per-request timeout, with a minimum of 1000 milliseconds and a default of 90000.
- `SMKLOG_MCP_DEBUG=1` writes traffic summaries to stderr while keeping stdout as JSON-RPC.

The bridge can return its bundled protocol and tool snapshots when the endpoint is unreachable, but tool calls still require network access.

## Tools and capabilities

- `get_parcel_quote`: Gets live rates for one supported parcel and reports purchasable services.
- `create_checkout_link`: Creates a payment handoff for a selected shipment and returns a session identifier.
- `get_checkout_status`: Reads payment and label progress for a session retained for 30 days.
- `track_parcel`: Returns current delivery status, up to eight newest scan events, and an estimated delivery date when reported by the carrier. It only recognizes labels bought through SMKlog.
- `get_price_index`: Reads monthly benchmark rates without using quote allowance.

## Limitations and notes

Pallets, freight loads, shipments exceeding supported parcel limits, and multi-box requests return no rates. A box above 150 pounds, over 108 inches on its longest side, or above 165 inches in length plus girth is outside the broad carrier limits; USPS may impose lower limits. Quantities requiring multiple boxes must be quoted separately.

`get_parcel_quote` allows 80 calls per hour per client, shared with the public quote route. Checkout status allows 60 checks per hour per client. Creating a checkout session is not idempotent: repeated calls create separate sessions, and calls without a reusable quote may make additional carrier calls. The checkout page handles payment, contents certification, carrier-adjustment consent, and international customs details; duty is billed to the recipient on arrival for supported international lanes.

_Full upstream README: https://allmcps.com/mcp/smklog-parcel-shipping-rates/readme_