SMKlog Parcel Shipping Rates

SMKlog Parcel Shipping Rates — MCP サーバー

米国から発送する小包のUSPS、UPS、FedEx、DHL Expressの最新料金を、国内またはカナダ、英国、ドイツ、オーストラリア宛てで、平易な言葉で説明します。
はかり不要。アカウント不要。APIキー不要。

https://quote-api.smklog.com/mcp · streamable-http · MCP 2026-07-28, 2025-06-18, 2025-03-26

---

ほとんどの配送APIでは、箱の長さ、幅、高さ、重量が必要です。しかし、実際にはそうした情報がないことも多く、目の前にある荷物と送り先のZIPコードしかわからないものです。このサーバーは、その荷物を受け取ります。

**「ハードケースに入ったフルサイズのアコースティックギター」**と説明すると、梱包後の箱のサイズを推定し、3社の配送業者の最新料金を算出して、実際に購入できるサービスを返します。同じ小包について、購入時の合計金額と、配送業者が公開している場合は窓口料金も並べて表示するため、いつでも両方の金額を人に提示できます。

アシスタントに質問できること

• 「07922から90011まで、12 lbの箱を送るといくらですか？」
• 「ニュージャージー州からロサンゼルスまで、ハードケース入りのフルサイズのアコースティックギターを送るといくらかかりますか？」
• 「ニューアークからシカゴまで5 lbの箱を送る場合、USPS、UPS、FedExを比較してください。最安と最速はどれですか？」
• 「24 × 18 × 12 in、22 lbの箱を33101宛てに送る料金を調べて、ラベルの購入リンクもください。」
• 「荷物は今どこにありますか？追跡番号は9400111899561234567890です。」
• 「そのラベルの料金はもう支払われましたか？以前もらったセッションIDはこちらです。」
• 「5 lbの箱をデンバーに送る料金は、この数か月でどう変わりましたか？」

ツール

ツール	機能
get_parcel_quote	米国内の発送元から国内、またはカナダ、英国、ドイツ、オーストラリアへの荷物1個分の最新料金を、USPS、UPS、FedExで提示します。さらに、ドイツとオーストラリア向けにはDHL Expressの料金も提示します。荷物の説明を平易な言葉で入力すると、梱包後の箱の推定サイズを算出します。または、正確な寸法と重量を指定して、推定を省略できます。購入可能なサービスを最大5件返します。SMKlogの手数料を含む決済時の合計金額と、公開されている場合は運送会社の窓口価格を並べて表示し、配達予定期間も返します。
create_checkout_link	発送の料金を計算し、金額、SMKlogのチェックアウトをこの発送内容が入力された状態で開く引き継ぎ用URL、session_idを含む支払いセッションを返します。人がチェックアウト画面で内容の証明と運送会社による料金調整への同意を確認し、Stripeで支払います。
get_checkout_status	支払いセッションの状況を返します。awaiting_checkout、checkout_started、paid、label_ready（追跡番号を含む）、delivered、refundedのいずれかです。注文レコードから読み取るため、運送会社への問い合わせは発生せず、氏名、住所、メールアドレスも含まれません。セッション情報は30日間参照できます。
track_parcel	smklog.comでラベルを購入した発送について、配達状況、スキャンイベント、運送会社の配達予定日を返します。任意の追跡番号に対応する汎用トラッカーではありません。
get_price_index	SMKlogの月次荷物料金指数です。ニュージャージー州ニューアークから米国内の5都市への一般的な箱6種類（1～20 lb）の料金を、実際の発送の料金計算と同じ最新パイプラインで再計算します。参照しても見積もり枠は消費しません。

接続前に知っておきたいこと

見積もりは実際に運送会社へ問い合わせて算出するため、実費がかかります。 関心のあるバリエーションごとではなく、発送ごとに get_parcel_quoteを1回呼び出してください。サーバーにはクライアントごとのレート制限があり、上限に達した場合は機能を黙って制限するのではなく、明確に通知します。

発送元は米国です。 米国内の発送と、米国からの輸出に対応しています。それ以外の地域を発送元とするルートは対象外であり、サーバーは料金を捏造せず、その旨を通知します。

料金はSMKlogの手数料を含む決済時の合計金額です。 手数料の内訳が表示されるのはチェックアウトの領収書だけです。料金と並んで返されるのは、公開されている場合、同じ荷物に対する運送会社独自の窓口価格です。これは、運送会社の窓口に持ち込んだ場合に支払う金額です。実際に支払うのは合計金額です。

荷物のみ対応し、箱1つにつきラベル1枚です。 荷物の上限を超える発送や、パレットまたは貨物として記述された発送は、料金なしでmode: not_a_parcelを返します。SMKlogが販売するのは荷物用ラベルであり、パレットや貨物の発送は手配していません。quantityは商品の個数を示します。1つの箱に収まる個数は、その箱として料金を計算します。一方、複数の箱が必要な個数、または1つの箱を表す正確な寸法とともに指定された1を超えるquantityは、料金なしでmode: multiple_boxesを返します。その場合は、箱ごとに見積もりを依頼してください。

ここでラベルが自動的に購入されることはありません。 create_checkout_linkはURLを生成します。人が購入手続きを完了し、内容を証明して、運送会社による料金調整に同意します。エージェントがこのサーバーを通じて誰かのお金を使うことはできません。

接続

{
  "mcpServers": {
    "smklog": {
      "type": "http",
      "url": "https://quote-api.smklog.com/mcp"
    }
  }
}

APIキーもOAuthも登録も不要です。見積もり、追跡、料金指数はすべて公開されています。

標準入出力経由

ローカルコマンドのみを起動するクライアント（Claude Desktop、Cursor、MCP inspector、Docker ベースのランナー）向けに、このリポジトリは同じエンドポイントへのシンプルな標準入出力ブリッジを提供します。依存関係も、ビルド手順も、キーも不要です。

{
  "mcpServers": {
    "smklog": {
      "command": "npx",
      "args": ["-y", "github:smklog/parcel-shipping-rates-mcp"]
    }
  }
}

Docker を使う場合：

docker build -t smklog-parcel-shipping-rates-mcp https://github.com/smklog/parcel-shipping-rates-mcp.git
docker run -i --rm smklog-parcel-shipping-rates-mcp

このブリッジは、すべての JSON-RPC メッセージを https://quote-api.smklog.com/mcp に転送し、応答を 1 行につき 1 つの JSON オブジェクトとして書き戻します。また、2026-07-28 のルーティングエンベロープを HTTP ヘッダー（MCP-Protocol-Version、Mcp-Method、Mcp-Name）に反映し、レガシーパスではネゴシエーションされたバージョンの initialize を送信するため、どちらのプロトコル世代でも利用できます。エンドポイントに接続できない場合でも、ここに同梱されているスナップショット（initialize.json、tools.json）から initialize と tools/list に応答するため、提供されている内容を確認できます。ツールの呼び出しにはネットワーク接続が必要です。npm test でエンドツーエンドのテストを実行できます。

設定

ブリッジが読み取る環境変数は、任意の 3 つだけです。それ以外は読み取りません。

変数	デフォルト	動作
SMKLOG_MCP_URL	https://quote-api.smklog.com/mcp	ブリッジの転送先エンドポイントです。
SMKLOG_MCP_TIMEOUT_MS	90000（最小値 1000）	リクエストごとのタイムアウトです。見積もりは運送会社へのリアルタイム照会で、30 秒ほどかかることがあります。
SMKLOG_MCP_DEBUG	未設定	1 を設定すると、通信の概要を stderr に出力します。stdout にはクリーンな JSON-RPC のみが出力されます。

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

シークレットとキー

設定するものはありません。このサーバーは API キー、トークン、アカウントを必要とせず、ブリッジも認証情報を読み取りません。このサーバーのクライアント設定に、運送会社、決済、その他の API キーを入れないでください。何も読み取りませんし、設定ファイルはシークレットを保管する場所として適切ではありません。運送会社と決済の認証情報は、サーバー側にのみ保存されます。

データとプライバシー

• 見積もりツールに渡すのは、商品の説明、郵便番号、任意の箱のサイズと重量です。番地を含む住所、氏名、メールアドレス、電話番号を尋ねることはありません。氏名、住所、決済情報は、このサーバー経由ではなく、smklog.com のチェックアウトで利用者が入力します。
• 商品の説明と箱の情報は、運送会社に対する小包の料金算出に使用されます。識別された商品は当社の商品カタログに保存されるため、同じ商品の次回の見積もりでも同じ結果が得られます。
• 各ツール呼び出しは 30 日間記録されます。記録内容は、ツール、商品の説明、各郵便番号の先頭 3 文字、宛先の国、クライアントソフトウェアの種類、リクエスト元の国、結果です。この目的で IP アドレス、完全なユーザーエージェント、番地を含む住所、連絡先情報が保存されることはありません。
• レート制限では、接続元 IP アドレス（および IP アドレスとユーザーエージェントの組み合わせ）の一方向 SHA-256 ハッシュをキーとして、1 時間単位でリクエスト数を集計します。アドレスそのものが書き込まれることはありません。
• ポリシー全文：https://smklog.com/privacy。

Smithery からもインストールでき、公式 MCP レジストリには com.smklog/parcel-shipping-rates として掲載されています。

MCP 以外の方法で利用する場合： OpenAPI · A2A エージェントカード · API ドキュメント · llms.txt

運営者

SMKlog は米国内の配送ラベルを販売しています。このサーバーが返す料金は、ウェブサイトと同じ料金算出パイプラインによるもので、別の「API 料金」はありません。アシスタントを使わない方も、配送計算ツールで同じラベルの料金を調べて購入できます。 お問い合わせ、バグ報告、予期しない結果の報告先：[email protected]。 セキュリティに関する報告：SECURITY.md をご覧ください。変更履歴：CHANGELOG.md。