ShippingRates MCP Server
⚓ ShippingRates MCP 서버
AI 에이전트를 위한 컨테이너 선적 인텔리전스 — 체선·체화료(Demurrage & Detention), 현지 비용, 내륙 운송, CFS 요금. x402를 통해 USDC로 요청당 결제.
빠른 시작
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)
도구 | 가격 | 설명 |
| $0.10 | 체선·체화료 계산 — 무료 일수, 일당 요금, 구간별 분석, 총 비용 |
| $0.25 | 한 번의 호출로 6개 모든 선사의 D&D 비용 비교. 경쟁사 제공 불가. |
| $0.05 | 항만 현지 비용 — THC, 서류 수수료, BL 수수료, 실(Seal) 수수료 |
| $0.03 | 출발지/목적지별 내륙 운송 경로 검색 |
| $0.05 | 화물 유형별 컨테이너 프레이트 스테이션(CFS) 처리 요금 |
| $0.05 | 내륙 운송 요금 — 항만에서 목적지까지 트럭/철도 운송 |
무료
도구 | 설명 |
| 국가별 레코드 수와 함께 6개 모든 선사 목록 표시 |
| 데이터베이스 통계 — 레코드, 적용 범위, 가격, 마지막 업데이트 |
| 서버 상태, 버전, 네트워크 구성 |
결제
ShippingRates는 x402 프로토콜을 사용합니다 — AI 에이전트를 위한 인터넷의 기본 결제 표준입니다.
통화: USDC (스테이블코인, 항상 $1.00)
네트워크: Base 메인넷(EVM) + Solana 메인넷
중개자: PayAI — 무료, API 키 불필요
정산: 즉시 (~200ms)
API 키, 계정, 구독 불필요
에이전트가 요청을 보내면 → 결제 조건과 함께 HTTP 402 수신 → USDC 결제 서명 → 증명과 함께 재시도 → 데이터 수신. 모든 과정은 x402 클라이언트 라이브러리에서 자동으로 처리됩니다.
지원되는 x402 클라이언트 라이브러리
TypeScript:
@x402/fetch또는@x402/axiosPython:
x402패키지 (httpx / requests)Go:
x402Go 모듈
결제 지갑
네트워크 | 주소 |
Base (EVM) |
|
Solana |
|
데이터 적용 범위
지표 | 값 |
선사 | 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 기본 |
|
전체 문서 |
|
LLMs.txt |
|
x402 발견 |
|
MCP 서버 |
|
MCP 서버 카드 |
|
상태 확인 |
|
예시: 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는 다음에 등재되어 있습니다:
디렉토리 | 상태 |
✅ 활성 — | |
✅ 제출됨 | |
✅ 제출됨 | |
✅ 제출됨 | |
✅ 색인됨 — 6개 리소스 자동 발견 |
소개
SmartBiz AI 제작 — 인도 뭄바이 기반, 상업용 선적을 위한 AI 솔루션.
ShippingRates는 세계 최초의 x402 네이티브 선적 데이터 API로, AI 에이전트와 자율 상거래를 위해 특별히 구축되었습니다.
링크
라이선스
이 저장소는 문서와 연결 구성만 포함합니다. ShippingRates API 및 MCP 서버는 SmartBiz AI가 운영하는 상업 서비스입니다.
API 사용은 x402 프로토콜을 통한 요청당 과금 방식이 적용됩니다.
This server cannot be deployed
Maintenance
Related MCP Connectors
Market data and web intelligence for AI agents, paid per call in USDC on Base via x402.
Pay-per-call crypto market intelligence for AI agents. USDC on Base via x402.
Pay-per-call data APIs for AI agents. USDC on Base via x402. 33 tools, no signup.
Pay-per-use weather, environment, finance, and on-chain intelligence tools for AI agents via x402.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceOcean 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
- AlicenseAqualityDmaintenanceEnables AI agents to access crypto/web3 data across 5 chains with pay-per-call billing in USDC via x402, no API key required, and built-in spend caps.3636 npmMIT
- AlicenseNot gradedqualityBmaintenanceProvides 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
- AlicenseAqualityDmaintenanceEnables 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.1334 npmMIT