ShippingRates MCP Server

io.github.vinaybhoslePublished by GitHub account vinaybhoslev2.2.0Updated Oct 28, 2026

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

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP server giving assistants ocean container shipping data: D&D charges, freight rates, vessel schedules, port and inland costs, and landed cost.

What you can do
  • Look up reference data: database stats, shipping lines, cross-data keyword search, live FX rates
  • Calculate detention and demurrage: slab breakdowns and cross-carrier comparison
  • Price local and inland costs: THC/documentation fees, trucking and rail rates, CFS tariffs
  • Check ports and schedules: port lookup by UN/LOCODE, transit times, vessel calls, congestion, reliability
  • Estimate freight: spot rates, surcharges, regulatory updates, route risk score, full landed cost
When to use it
Useful when an assistant has to answer container shipping questions — D&D exposure, freight and local charges, transit times, port congestion or total landed cost — and the user wants carrier-sourced figures rather than general knowledge.
Requirements
A remote streamable HTTP endpoint; no local package or API key is needed for basic access. Paid tools require an x402 USDC micropayment on Base Mainnet or Solana, retried with an X-PAYMENT header. A separate free tier of 25 API requests per month is available through the provider's API site with sign-up.
Before you install
Most of the 24 tools cost money per call, from about $0.01 to $0.25 in USDC, so an assistant can spend funds without a subscription or key. Payment requires a funded crypto wallet on Base or Solana. Queries and payment details go to a third-party service.

Installation

In SourceWeft

  1. Open ShippingRates MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.vinaybhosle%2Fshippingrates-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

ShippingRates MCP Server

[License: MIT]

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:

json
{  "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.

Links

License

MIT

Source: README.md at commit 712f907

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v2.2.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts