ShippingRates MCP Server
Ocean shipping intelligence: D&D, freight rates, vessel schedules, port data. 24 tools, 6 carriers.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http shippingrates-mcp-server 'https://mcp.shippingrates.org/mcp/'
{
"mcpServers": {
"shippingrates-mcp-server": {
"type": "http",
"url": "https://mcp.shippingrates.org/mcp/"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
ShippingRates MCP Server
Ocean container shipping intelligence for AI agents — real carrier tariff data, detention & demurrage, freight rates, vessel schedules, and total landed cost across 6 major carriers.
Remote MCP endpoint: https://mcp.shippingrates.org/mcp
Overview
ShippingRates gives AI agents access to structured, carrier-sourced data for container shipping decisions — D&D slab breakdowns, local port charges, inland haulage rates, freight rates, vessel schedules, port congestion, and full landed cost calculations.
Carriers covered: Maersk · Hapag-Lloyd · MSC · COSCO · ONE · CMA CGM
Quickstart
Connect any MCP-compatible client to the remote endpoint:
{
"mcpServers": {
"shippingrates": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.shippingrates.org/mcp"]
}
}
}
Paid tools require an x402 USDC payment on Base or Solana. Free tools work without any payment.
Tools (24 total)
Free (no payment required)
| Tool | Description |
|---|---|
shippingrates_stats | Database statistics — record counts, carrier coverage, last updated |
shippingrates_lines | List all shipping lines with country-level breakdowns |
shippingrates_search | Cross-data keyword search across ports, carriers, charges |
shippingrates_fx | Live exchange rates (USD base) |
Paid (x402 USDC micropayments)
| Tool | Price | Description |
|---|---|---|
dd_calculate | $0.10 | D&D slab breakdown by carrier, port, container type, and days over free time |
dd_compare | $0.25 | Cross-carrier D&D comparison at the same port |
local_charges | $0.05 | THC, documentation, seal, and BL fees by port and carrier |
inland_search | $0.03 | Search inland routes by origin/destination |
inland_haulage | $0.05 | Trucking and rail rates (12 origins, 72 destinations) |
inland_compare | $0.08 | Compare inland rates across carriers |
cfs_tariffs | $0.05 | CFS handling tariffs (APM Terminals — INMAA, INMUN) |
port | $0.01 | Port lookup by UN/LOCODE |
transit | $0.02 | Port-to-port transit times |
transit_schedules | $0.03 | Transit schedules with carrier service codes and frequency |
rates | $0.03 | Ocean spot freight rates with low/mid/high and trend |
surcharges | $0.02 | BAF, CAF, PSS surcharges by carrier |
congestion | $0.02 | Port congestion metrics and historical wait times |
congestion_news | $0.02 | Real-time shipping disruption news from 7 sources |
reliability | $0.02 | Schedule reliability (on-time %) by carrier |
vessel_schedule | $0.02 | Upcoming vessel calls at a port with ETA/ETD |
regulatory | $0.01 | Regulatory updates by country |
total_cost | $0.15 | Full landed cost: freight + surcharges + local charges + D&D |
facilities | $0.02 | India ICD/CFS facility directory |
risk_score | $0.10 | Composite route risk assessment (0–100 score) |
Example: Calculate D&D for a shipment
What are the detention and demurrage charges for a 20ft dry container at Nhava Sheva
(INNSA) on Maersk if it's been 10 days over free time?
The dd_calculate tool returns a slab-by-slab breakdown with daily rates, total accrued, and free time details — sourced directly from Maersk's published tariff.
Payment
Paid tools use the x402 protocol — a standard for HTTP micropayments. When an agent calls a paid tool:
- The server responds
402 Payment Requiredwith a USDC payment details - The agent pays via Base Mainnet or Solana (USDC)
- The agent retries with an
X-PAYMENTheader - Data is returned
Payment amounts range from $0.01 to $0.25 per call. No subscriptions, no API keys needed for basic access.
Free Tier
The API also offers a free tier: 25 API requests/month via api.shippingrates.org. Sign up at shippingrates.org.
Dashboard
Human-facing dashboard at app.shippingrates.org with D&D calculator, carrier comparator, inland routes explorer, vessel schedules, and rate calculator.
Links
- Homepage: https://shippingrates.org
- API Docs: https://api.shippingrates.org/docs
- MCP Endpoint: https://mcp.shippingrates.org/mcp
- x402 Discovery: https://api.shippingrates.org/.well-known/x402.json
- Agent Discovery: https://api.shippingrates.org/.well-known/agents.json
- OpenAPI Spec: https://api.shippingrates.org/openapi.json
License
MIT
Questions fréquentes
Qu'est-ce que ShippingRates MCP Server ?
Ocean shipping intelligence: D&D, freight rates, vessel schedules, port data. 24 tools, 6 carriers.
Comment installer ShippingRates MCP Server ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http shippingrates-mcp-server 'https://mcp.shippingrates.org/mcp/'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour ShippingRates MCP Server ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
ShippingRates MCP Server est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient ShippingRates MCP Server ?
Il est publié par vinaybhosle. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.