freightgate-mcp-server

⚓ ShippingRates MCP Server

AI エージェント向けのコンテナ輸送インテリジェンス — デマレージとディテンション、現地費用、内陸輸送、CFS 料金。x402 経由の USDC によるリクエストごとの支払いに対応しています。

クイックスタート

ShippingRates を Claude Desktop、Cursor、または MCP 互換クライアントに追加します。

{
  "mcpServers": {
    "shippingrates": {
      "url": "https://mcp.shippingrates.org/mcp"
    }
  }
}

これで完了です。9 個のツールが自動検出されます。3 個は無料、6 個は x402 経由の有料です。

v2.1.0 の新機能

• デュアルチェーン決済 — Base Mainnet（EVM）＋ Solana Mainnet
• 段階的な料金設定 — データの複雑さに応じて、呼び出しごとに $0.03～$0.25
• PayAI ファシリテーター — 無料で利用でき、決済処理に API キーは不要です
• 23/23 エンドポイントを検証済み — 本番環境のヘルスチェックに合格しました
• 2,547 件以上のレコードを 14 個のデータベーステーブルに収録
• 自動検出用の /.well-known/mcp/server-card.json にあるサーバーカード
• リアルタイムの決済追跡に対応したライブ分析ダッシュボード
• 掲載先：Official MCP Registry、Smithery、Glama、mcp.so、x402scan

ツール

有料（x402 経由の USDC）

ツール	価格	説明
dd_calculate	$0.10	デマレージとディテンションの費用を計算します — フリータイム、日額料金、段階別内訳、合計費用
dd_compare	$0.25	1 回の呼び出しで 6 社すべての船社の D&D 費用を比較します。これを提供する競合他社はありません。
local_charges	$0.05	港の現地費用 — THC、書類手数料、BL 手数料、シール手数料
inland_search	$0.03	出発地／目的地で内陸輸送ルートを検索します
cfs_tariffs	$0.05	貨物の種類ごとのコンテナ・フレイト・ステーション取扱料金
inland_haulage	$0.05	内陸輸送料金 — 港から目的地までのトラック／鉄道輸送

無料

ツール	説明
list_lines	国ごとのレコード数とともに、6 社すべての船社を一覧表示します
get_stats	データベース統計 — レコード数、対象範囲、料金、最終更新日時
health_check	サーバーの状態、バージョン、ネットワーク構成

決済

ShippingRates は、AI エージェント向けのインターネット標準ネイティブ決済プロトコルである x402 プロトコルを使用します。

• 通貨： USDC（ステーブルコイン、常に $1.00）
• ネットワーク： Base Mainnet（EVM）＋ Solana Mainnet
• ファシリテーター： PayAI — 無料で、API キーは不要です
• 決済処理： 即時（約 200 ミリ秒）
• API キー、アカウント、サブスクリプションは不要です

エージェントがリクエストを送信 → 決済条件を含む HTTP 402 を受信 → USDC 決済に署名 → 証明を添えて再試行 → データを取得します。x402 クライアントライブラリがすべて自動で処理します。

対応する x402 クライアントライブラリ

• TypeScript： @x402/fetch または @x402/axios
• Python： x402 パッケージ（httpx／requests）
• Go： x402 Go モジュール

決済ウォレット

ネットワーク	アドレス
Base（EVM）	0x8c9e0882b4c6e6568fe76F16D59F7E080465E5C8
Solana	Gcv56hKWuEGmXheBpJxAwQxvX6QAMimZzzVrHaVCbNWE

データ対象範囲

指標	値
船社	6 社 — Maersk、MSC、CMA-CGM、Hapag-Lloyd、ONE、COSCO
レコード	14 個のテーブルに 2,547 件以上の検証済み運賃項目
国	9 か国 — IN、AE、SG、CN、MY、LK、PK、BD、TH
コンテナタイプ	20DV、40DV、40HC、20RF、40RF、20OT、40OT、20FR、40FR
データ品質	船社の公式 PDF をもとに 100％手作業で検証済み
データテーブル	dd_tariffs、local_charges、inland_haulage、cfs_tariffs、ports など

API アクセス

MCP を使用しない直接的な API 統合の場合：

リソース	URL
API ベース URL	https://api.shippingrates.org
ドキュメント全文	https://api.shippingrates.org/llms-full.txt
LLMs.txt	https://api.shippingrates.org/llms.txt
x402 ディスカバリー	https://api.shippingrates.org/.well-known/x402.json
MCP サーバー	https://mcp.shippingrates.org/mcp
MCP サーバーカード	https://mcp.shippingrates.org/.well-known/mcp/server-card.json
ヘルスチェック	https://api.shippingrates.org/health

例：D&D の計算

# Free endpoint — no payment needed
curl https://api.shippingrates.org/api/stats

# Paid endpoint — returns HTTP 402 with payment instructions
curl -X POST https://api.shippingrates.org/api/dd/calculate \
  -H "Content-Type: application/json" \
  -d '{"line": "maersk", "country": "IN", "container_type": "40HC", "days": 14}'

応答例（D&D の計算）

{
  "line": "maersk",
  "country": "IN",
  "container_type": "40HC",
  "days": 14,
  "free_days": 4,
  "currency": "USD",
  "slabs": [
    { "from": 5, "to": 7, "rate_per_day": 7.5, "days": 3, "cost": 22.5 },
    { "from": 8, "to": 14, "rate_per_day": 15, "days": 7, "cost": 105 }
  ],
  "total_cost": 127.5
}

応答例（D&D の比較）

{
  "country": "IN",
  "container_type": "40HC",
  "days": 14,
  "comparisons": [
    { "line": "maersk", "total_cost": 127.5, "free_days": 4, "currency": "USD" },
    { "line": "msc", "total_cost": 150.0, "free_days": 3, "currency": "USD" },
    { "line": "cosco", "total_cost": 95.0, "free_days": 7, "currency": "USD" }
  ],
  "cheapest": "cosco",
  "savings_vs_most_expensive": 55.0
}

アーキテクチャ

┌─────────────────────────────────────────────────────┐
│                   AI Agent / Client                  │
│            (Claude, Cursor, ChatGPT, etc.)           │
└──────────────┬──────────────────────┬───────────────┘
               │ MCP                  │ HTTP + x402
               ▼                      ▼
┌──────────────────────┐  ┌──────────────────────────┐
│  MCP Server v1.1.0   │  │    API Server v2.1.0     │
│  mcp.shippingrates   │──│  api.shippingrates.org   │
│  .org:3480           │  │  :3402                   │
└──────────────────────┘  └────────────┬─────────────┘
                                       │
                          ┌────────────▼─────────────┐
                          │  Shipping Intelligence DB │
                          │  SQLite — 14 tables       │
                          │  2,547+ verified records   │
                          └──────────────────────────┘

• MCP サーバー — TypeScript、@modelcontextprotocol/sdk、Streamable HTTP トランスポート
• API サーバー — TypeScript、Express.js、PayAI ファシリテーターを使用した x402 v2 SDK
• データベース — 公式の運送会社料金表 PDF のデータを使用した SQLite
• インフラストラクチャ — PM2 プロセスマネージャー、Cloudflare Tunnel、再起動後も稼働

ユースケース

• 貨物運送業者 — 予約前にペナルティ費用を見積もる
• AI エージェント — D&D 料金を最小限に抑えるため、コンテナの引き取りスケジュールを最適化する
• 物流会社 — 運送会社を比較し、最も安い選択肢を見つける
• 貿易金融 — 輸入業務のコストリスクを評価する
• サプライチェーンプラットフォーム — リアルタイムの D&D データを統合する

ディスカバリーとディレクトリ

ShippingRates は以下に掲載されています：

ディレクトリ	ステータス
公式 MCP レジストリ	✅ 公開中 — io.github.vinaybhosle/shippingrates-mcp-server
Smithery	✅ 申請済み
Glama	✅ 申請済み
mcp.so	✅ 申請済み
x402scan	✅ インデックス済み — 6 件のリソースを自動検出

概要

SmartBiz AI が構築しました。インドのムンバイを拠点とする、商業輸送向けの AI ソリューションを提供しています。

ShippingRates は、AI エージェントと自律型コマース向けに特化して構築された、世界初の x402 ネイティブな輸送データ API です。

リンク

• 🌐 ウェブサイト
• 📖 API ドキュメント全文
• 🔍 x402 ディスカバリー
• ⚡ x402 プロトコル
• 🤖 MCP 仕様
• 📊 API 統計

ライセンス

このリポジトリには、ドキュメントと接続設定のみが含まれています。ShippingRates API と MCP サーバーは、SmartBiz AI が運営する商用サービスです。

API の利用料金は、x402 プロトコルによるリクエストごとの課金に基づきます。