English Français العربية

ShippingRates MCP Server

Official registry Other

Ocean shipping intelligence: D&D, freight rates, vessel schedules, port data. 24 tools, 6 carriers.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http shippingrates-mcp-server 'https://mcp.shippingrates.org/mcp/'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "shippingrates-mcp-server": {
            "type": "http",
            "url": "https://mcp.shippingrates.org/mcp/"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ShippingRates MCP Server
  2. Overview
  3. Quickstart
  4. Tools (24 total)
  5. Example: Calculate D&D for a shipment
  6. Payment
  7. Free Tier
  8. Dashboard
  9. Links
  10. License

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)
ToolDescription
shippingrates_statsDatabase statistics — record counts, carrier coverage, last updated
shippingrates_linesList all shipping lines with country-level breakdowns
shippingrates_searchCross-data keyword search across ports, carriers, charges
shippingrates_fxLive exchange rates (USD base)
Paid (x402 USDC micropayments)
ToolPriceDescription
dd_calculate$0.10D&D slab breakdown by carrier, port, container type, and days over free time
dd_compare$0.25Cross-carrier D&D comparison at the same port
local_charges$0.05THC, documentation, seal, and BL fees by port and carrier
inland_search$0.03Search inland routes by origin/destination
inland_haulage$0.05Trucking and rail rates (12 origins, 72 destinations)
inland_compare$0.08Compare inland rates across carriers
cfs_tariffs$0.05CFS handling tariffs (APM Terminals — INMAA, INMUN)
port$0.01Port lookup by UN/LOCODE
transit$0.02Port-to-port transit times
transit_schedules$0.03Transit schedules with carrier service codes and frequency
rates$0.03Ocean spot freight rates with low/mid/high and trend
surcharges$0.02BAF, CAF, PSS surcharges by carrier
congestion$0.02Port congestion metrics and historical wait times
congestion_news$0.02Real-time shipping disruption news from 7 sources
reliability$0.02Schedule reliability (on-time %) by carrier
vessel_schedule$0.02Upcoming vessel calls at a port with ETA/ETD
regulatory$0.01Regulatory updates by country
total_cost$0.15Full landed cost: freight + surcharges + local charges + D&D
facilities$0.02India ICD/CFS facility directory
risk_score$0.10Composite 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:

  1. The server responds 402 Payment Required with a USDC payment details
  2. The agent pays via Base Mainnet or Solana (USDC)
  3. The agent retries with an X-PAYMENT header
  4. 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.

License

MIT

Frequently asked questions

What is ShippingRates MCP Server?

Ocean shipping intelligence: D&D, freight rates, vessel schedules, port data. 24 tools, 6 carriers.

How do I install ShippingRates MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http shippingrates-mcp-server 'https://mcp.shippingrates.org/mcp/'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ShippingRates MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is ShippingRates MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ShippingRates MCP Server?

It is published by vinaybhosle. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.