freightgate-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:

• line (string): Shipping line slug

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

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

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 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:

• line (string): Shipping line slug

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

• container_type (string, optional): Filter by container type

• 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

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) }