shippingrates-mcp-server

Get Container Freight Station (CFS) handling tariffs — charges for LCL cargo consolidation/deconsolidation at the port warehouse.

Returns per-unit handling rates, minimum charges, and storage fees.

PAID endpoint: $0.05 per call via x402 (USDC on Base or Solana).

Args:

• port (string): UN/LOCODE port code (e.g. INMAA, INMUN)

• service (string, optional): Filter by service type (e.g. import, export)

• cargo_type (string, optional): Filter by cargo type (e.g. general, hazardous)

• x_payment (string, optional): x402 payment proof header

Get port congestion metrics — vessel waiting times, berth occupancy, and delays.

Useful for assessing port efficiency and planning for potential detention costs.

PAID endpoint: $0.02 per call via x402 (USDC on Base or Solana).

Args:

• port (string): UN/LOCODE port code — e.g. "INNSA", "AEJEA"

• days_back (number, optional): Number of days of historical data (default: 30)

• x_payment (string, optional): x402 payment proof header

Returns: Congestion metrics with waiting times, delays, and trend data.

Calculate demurrage and detention (D&D) costs for a specific shipping line, country, container type, and number of detention days.

Returns a detailed slab breakdown: free days, per-diem rates for each slab, and total cost. This is the core tool for logistics cost analysis.

PAID endpoint: $0.10 per call via x402 (USDC on Base or Solana). If you have x402 payment capability, include the payment proof in x_payment.

Args:

• line (string): Shipping line slug — one of: maersk, msc, cma-cgm, hapag-lloyd, one, cosco

• country (string): ISO country code — e.g. "IN" (India), "AE" (UAE), "SG" (Singapore)

• container_type (string): Container type code — e.g. "20DV", "40DV", "40HC", "20RF", "40RF"

• days (number): Number of detention days to calculate (1-365)

• x_payment (string, optional): x402 payment proof header for authenticated access

Returns (when paid): { "line": string, "country": string, "container_type": string, "days": number, "free_days": number, "slabs": [{ "from": number, "to": number, "rate_per_day": number, "days": number, "cost": number }], "total_cost": number, "currency": string }

Compare demurrage and detention costs across multiple shipping lines for the same country, container type, and days.

Returns a side-by-side comparison of D&D costs from all available lines. Essential for freight procurement and carrier selection.

PAID endpoint: $0.25 per call via x402 (USDC on Base or Solana).

Args:

• country (string): ISO 2-letter country code

• container_type (string): Container type code — e.g. "40HC", "20DV"

• days (number): Number of detention days to compare

• x_payment (string, optional): x402 payment proof header

Get current exchange rates between two currencies.

Useful for converting shipping costs quoted in different currencies (USD, EUR, INR, AED, SGD, etc.).

This is a FREE endpoint — no payment required.

Args:

• from (string): Source currency code — e.g. "USD", "EUR", "INR"

• to (string): Target currency code — e.g. "INR", "USD", "AED"

Returns: { "from": string, "to": string, "rate": number, "timestamp": string }

Get inland haulage (trucking/rail) rates for moving containers between ports and inland locations.

Returns route-specific rates by container type, including base rate, fuel surcharges, and estimated transit times.

PAID endpoint: $0.05 per call via x402 (USDC on Base or Solana).

Args:

• origin (string): Origin port UN/LOCODE (e.g. INNSA, INMAA)

• destination (string): Inland destination city name (e.g. Ahmedabad, Delhi)

• container_type (string, optional): Filter by container type (e.g. 20GP, 40HC)

• mode (string, optional): Transport mode filter (PRE or ONC)

• x_payment (string, optional): x402 payment proof header

Search for inland transport routes (road/rail haulage from port to inland destination).

Find available haulage options, routes, and estimated costs for moving containers from port to final destination.

PAID endpoint: $0.03 per call via x402 (USDC on Base or Solana).

Args:

• line (string): Shipping line slug

• country (string): ISO 2-letter country code

• keyword (string, optional): Search term — city, region, or route

• x_payment (string, optional): x402 payment proof header

Get all shipping lines available in ShippingRates with per-country record counts.

Returns the 6 major shipping lines covered: Maersk, MSC, CMA-CGM, Hapag-Lloyd, ONE, COSCO. Each line includes the number of tariff/charge records available per country.

This is a FREE endpoint — no payment required.

Returns: Array of shipping lines with country breakdowns.

Get local charges (THC, documentation fees, seal fees, etc.) for a specific port and shipping line.

Returns detailed breakdown of all local charges applicable at the port.

PAID endpoint: $0.05 per call via x402 (USDC on Base or Solana).

Args:

• line (string): Shipping line slug

• country (string): ISO 2-letter country code

• port_code (string, optional): Specific port code to filter by

• x_payment (string, optional): x402 payment proof header

Look up port details by UN/LOCODE.

Returns port name, country, coordinates, timezone, and facility information.

PAID endpoint: $0.01 per call via x402 (USDC on Base or Solana).

Args:

• code (string): UN/LOCODE port code — e.g. "INNSA" (Nhava Sheva), "AEJEA" (Jebel Ali), "SGSIN" (Singapore)

• x_payment (string, optional): x402 payment proof header

Returns: { "port_code": string, "port_name": string, "country": string, "lat": number, "lon": number, ... }

Get ocean freight rates between two ports for a specific container type.

Returns current and historical rate data with trend indicators.

PAID endpoint: $0.03 per call via x402 (USDC on Base or Solana).

Args:

• origin (string): Origin port UN/LOCODE — e.g. "INNSA"

• destination (string): Destination port UN/LOCODE — e.g. "AEJEA"

• container_type (string, optional): Container type code — e.g. "40HC", "20DV"

• x_payment (string, optional): x402 payment proof header

Returns: Array of freight rates with carrier, rate, currency, effective dates.

Get recent regulatory updates and compliance requirements for shipping in a specific country.

Covers customs regulations, documentation requirements, trade restrictions, and policy changes.

PAID endpoint: $0.01 per call via x402 (USDC on Base or Solana).

Args:

• country (string): ISO 2-letter country code — e.g. "IN", "AE", "SG"

• limit (number, optional): Max number of updates to return (default: 10)

• x_payment (string, optional): x402 payment proof header

Returns: Array of regulatory updates with title, description, effective date, impact level.

Get schedule reliability metrics for a shipping line — on-time performance, average delays.

Useful for carrier selection and benchmarking.

PAID endpoint: $0.02 per call via x402 (USDC on Base or Solana).

Args:

• line (string): Shipping line slug — one of: maersk, msc, cma-cgm, hapag-lloyd, one, cosco

• trade_lane (string, optional): Trade lane filter — e.g. "Asia-Europe"

• x_payment (string, optional): x402 payment proof header

Returns: Reliability metrics with on-time %, average delay, sample size.

Search ShippingRates shipping data by keyword. Returns trade lanes, local charges, and shipping line information matching the query.

Use this for exploratory queries — e.g., search for a shipping line name, port, or country.

This is a FREE endpoint — no payment required.

Args:

• keyword (string): Search term — a shipping line name (e.g. "maersk"), port, country, or charge type

Returns: Matching trade lanes, local charges (THC, DO_fee, BL_fee, seal_fee), and line info.

Get current statistics for the ShippingRates shipping intelligence database.

Returns counts of tariff records, ports, trade lanes, freight rates, surcharges, local charges, congestion records, shipping lines, countries, and more. Use this to understand the scope and freshness of available data.

This is a FREE endpoint — no payment required.

Returns: { "tariff_records": number, "ports": number, "trade_lanes": number, "freight_rates": number, "local_charges": number, "shipping_lines": number, "countries": number, "last_scrape": string (ISO datetime) }

Get surcharges (BAF, CAF, PSS, EBS, etc.) for a shipping line in a specific country/direction.

Returns breakdown of all applicable surcharges with amounts and validity periods.

PAID endpoint: $0.02 per call via x402 (USDC on Base or Solana).

Args:

• line (string): Shipping line slug — one of: maersk, msc, cma-cgm, hapag-lloyd, one, cosco

• country (string, optional): ISO 2-letter country code

• direction (string, optional): "import" or "export"

• x_payment (string, optional): x402 payment proof header

Returns: Array of surcharges with type, amount, currency, effective dates.

Calculate the full landed cost of shipping a container — combines freight rates, surcharges, local charges (origin + destination), demurrage/detention, and transit time into one comprehensive estimate.

This is the most powerful tool: a single call replaces 5-6 individual queries.

PAID endpoint: $0.15 per call via x402 (USDC on Base or Solana).

Args:

• line (string): Shipping line slug — one of: maersk, msc, cma-cgm, hapag-lloyd, one, cosco

• origin (string): Origin port UN/LOCODE — e.g. "INNSA"

• destination (string): Destination port or inland location — e.g. "AEJEA", "DELHI"

• container_type (string): Container type code — e.g. "40HC", "20DV"

• detention_days (number, optional): Expected detention days (default: 0)

• x_payment (string, optional): x402 payment proof header

Returns: { "freight": { rate, currency }, "surcharges": { total, items[] }, "local_charges": { origin: { total, items[] }, destination: { total, items[] } }, "detention": { days, cost, currency }, "transit": { days, service }, "total_landed_cost": number, "currency": string }

Get estimated transit times between two ports.

Returns carrier-specific transit durations, service types, and frequencies.

PAID endpoint: $0.02 per call via x402 (USDC on Base or Solana).

Args:

• origin (string): Origin port UN/LOCODE — e.g. "INNSA"

• destination (string): Destination port UN/LOCODE — e.g. "AEJEA"

• x_payment (string, optional): x402 payment proof header

Returns: Array of transit options with carrier, duration, service type.

Get upcoming vessel schedules at a port — expected arrivals, departures, and vessel details.

PAID endpoint: $0.02 per call via x402 (USDC on Base or Solana).

Args:

• port (string): UN/LOCODE port code — e.g. "INNSA", "AEJEA"

• days_ahead (number, optional): Days to look ahead (default: 14)

• x_payment (string, optional): x402 payment proof header

Returns: Array of vessel arrivals/departures with vessel name, carrier, ETA/ETD.