Skip to main content
Glama
vinaybhosle

ShippingRates MCP Server

by vinaybhosle

⚓ ShippingRates MCP 서버

AI 에이전트를 위한 컨테이너 선적 인텔리전스 — 체선·체화료(Demurrage & Detention), 현지 비용, 내륙 운송, CFS 요금. x402를 통해 USDC로 요청당 결제.

MCP x402 Networks Version Status

빠른 시작

ShippingRates를 Claude Desktop, Cursor 또는 MCP 호환 클라이언트에 추가하세요:

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

끝입니다. 9개의 도구가 자동으로 발견됩니다. 3개는 무료, 6개는 x402를 통한 유료입니다.

Related MCP server: boo-x402-mcp

v2.1.0의 새로운 기능

  • 이중 체인 결제 — Base 메인넷(EVM) + Solana 메인넷

  • 계층형 가격 — 데이터 복잡성에 따라 호출당 $0.03 ~ $0.25

  • PayAI 중개자 — 무료, 결제 처리를 위한 API 키 불필요

  • 23/23 엔드포인트 검증 — 전체 프로덕션 상태 점검 통과

  • 14개 데이터베이스 테이블에 걸친 2,547개 이상의 레코드

  • 서버 카드 /.well-known/mcp/server-card.json — 자동 발견용

  • 실시간 분석 대시보드 — 실시간 결제 추적 기능

  • 공식 MCP 레지스트리, Smithery, Glama, mcp.so, x402scan에 등재됨

도구

유료 (x402를 통한 USDC)

도구

가격

설명

dd_calculate

$0.10

체선·체화료 계산 — 무료 일수, 일당 요금, 구간별 분석, 총 비용

dd_compare

$0.25

한 번의 호출로 6개 모든 선사의 D&D 비용 비교. 경쟁사 제공 불가.

local_charges

$0.05

항만 현지 비용 — THC, 서류 수수료, BL 수수료, 실(Seal) 수수료

inland_search

$0.03

출발지/목적지별 내륙 운송 경로 검색

cfs_tariffs

$0.05

화물 유형별 컨테이너 프레이트 스테이션(CFS) 처리 요금

inland_haulage

$0.05

내륙 운송 요금 — 항만에서 목적지까지 트럭/철도 운송

무료

도구

설명

list_lines

국가별 레코드 수와 함께 6개 모든 선사 목록 표시

get_stats

데이터베이스 통계 — 레코드, 적용 범위, 가격, 마지막 업데이트

health_check

서버 상태, 버전, 네트워크 구성

결제

ShippingRates는 x402 프로토콜을 사용합니다 — AI 에이전트를 위한 인터넷의 기본 결제 표준입니다.

  • 통화: USDC (스테이블코인, 항상 $1.00)

  • 네트워크: Base 메인넷(EVM) + Solana 메인넷

  • 중개자: PayAI — 무료, API 키 불필요

  • 정산: 즉시 (~200ms)

  • 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 접근

직접 API 통합을 위한 방법 (MCP 없이):

리소스

URL

API 기본

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는 세계 최초의 x402 네이티브 선적 데이터 API로, AI 에이전트와 자율 상거래를 위해 특별히 구축되었습니다.

링크

라이선스

이 저장소는 문서와 연결 구성만 포함합니다. ShippingRates API 및 MCP 서버는 SmartBiz AI가 운영하는 상업 서비스입니다.

API 사용은 x402 프로토콜을 통한 요청당 과금 방식이 적용됩니다.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Ocean container shipping intelligence for AI agents — D\&D tariffs, freight rates, vessel schedules, port congestion, inland haulage across 6 major carriers. 24 MCP tools.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides real-time, machine-readable ship and port conditions for major US container gateways using AIS data, allowing AI agents to query vessel status, berthing events, and gateway conditions without API keys or signup.
    Apache 2.0
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to access Solana wallet analytics, token data, and DeFi tools via pay-per-request USDC micropayments using the x402 protocol, without API keys or subscriptions.
    13
    34 npm
    MIT