MCP-Server
ShippingRates MCP Server
io.github.vinaybhosle/shippingrates-mcp-server
Was dieses MCP kann
Provides ocean-shipping rates and schedules, demurrage calculations, port and vessel data, inland haulage comparisons, congestion, regulatory updates, and route risk.
Funktionen
Tools
26
Tools
shippingrates_cfs_tariffs
Get CFS Handling Tariffs
Get Container Freight Station (CFS) handling tariffs — charges for LCL (Less than Container Load) cargo consolidation and deconsolidation at port warehouses.
Use this for LCL shipments to estimate warehouse handling costs. Returns per-unit handling rates, minimum charges, and storage fees at the specified port. Not relevant for FCL (Full Container Load) shipments.
PAID: $0.05/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { facility, service_type, cargo_type, rate_per_unit, unit, minimum_charge, currency }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['port'], 'properties': {'port': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'UN/LOCODE port code (e.g. INMAA, INMUN)'}, 'service': {'type': 'string', 'description': 'Filter by service type'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'cargo_type': {'type': 'string', 'description': 'Filter by cargo type'}}, 'additionalProperties': False}
shippingrates_congestion
Port Congestion Data
Get certified port-authority congestion measurements for a specific port.
Only fields explicitly published by the authority are populated; unavailable measurements remain null and an unpublished severity remains "unknown". The current certified denominator is the Port of Los Angeles daily operations report (USLAX), including exact vessels-at-berth and local-cargo dwell values. For disruption advisories, use shippingrates_congestion_news instead.
PAID: $0.02/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns the unchanged API envelope: { port, port_name, current_level, days_back, history[] }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['port'], 'properties': {'port': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'UN/LOCODE port code; the current certified measured denominator is USLAX'}, 'days_back': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Days of historical data (default: 30)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}}, 'additionalProperties': False}
shippingrates_congestion_news
Shipping Disruption News
Get certified shipping-disruption publications from reviewed official port-authority sources.
The current publisher denominator is the official Port of Rotterdam and Port of Los Angeles news series. Every article in each finite collection window is retained; only explicit operational-disruption terms enter the customer result, and a successful zero-advisory collection stays empty instead of inventing an alert. For quantitative measurements, use shippingrates_congestion. For route-level risk scoring, use shippingrates_risk_score.
PAID: $0.02/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns the unchanged API array of { headline, summary, source, port_code, severity, published_at }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'port': {'type': 'string', 'description': 'Port UN/LOCODE filter'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Maximum number of results'}, 'severity': {'enum': ['normal', 'elevated', 'congested'], 'type': 'string', 'description': 'Severity classification filter'}, 'days_back': {'type': 'integer', 'minimum': 1, 'description': 'Days of historical news (default: 7)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}}, 'additionalProperties': False}
shippingrates_dd_calculate
Calculate Demurrage & Detention Costs
Calculate demurrage and detention (D&D) costs for one carrier in one country.
Use this when the user needs a detailed cost breakdown for a specific carrier. Returns free days, per-diem rates for each tariff slab, and total cost. This is the core tool for logistics cost analysis — it answers "how much will I pay if my container is detained X days?"
To compare D&D costs across all carriers at once, use shippingrates_dd_compare instead.
By default this returns carrier detention/demurrage. Pass charge_type="storage" to instead get TERMINAL port storage — a distinct charge billed by the terminal, not the carrier, and never mixed into the default D&D answer. Storage coverage is thin — only a handful of carrier/country lanes have it. Any uncovered combo returns an explicit 'no data' error (never a false $0), and that error names the lanes that ARE covered, derived live from the database rather than from a hardcoded list that would go stale.
PAID: $0.10/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: { line, country, container_type, days, free_days, breakdown, total_cost, currency, charge_type_served, charge_family: 'carrier_dd'|'terminal_storage' }
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['line', 'country', 'container_type', 'days'], 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Number of detention days'}, 'line': {'enum': ['maersk', 'msc', 'cmacgm', 'cma-cgm', 'hapag-lloyd', 'one', 'cosco', 'zim', 'evergreen', 'yangming', 'hmm', 'arkas', 'oocl', 'pil', 'wanhai'], 'type': 'string', 'description': 'Shipping line slug — maersk, msc, cmacgm (or cma-cgm), hapag-lloyd, one, cosco, zim, evergreen, yangming, hmm, arkas, oocl, pil'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 2-letter country code (e.g. IN, AE, SG)'}, 'direction': {'enum': ['import', 'export'], 'type': 'string', 'description': 'import or export (default import)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header (optional — required for paid access)'}, 'charge_type': {'enum': ['detention', 'demurrage', 'combined', 'storage'], 'type': 'string', 'description': "Override the charge type; default is the engine's detention→demurrage→combined priority. 'storage' is a distinct TERMINAL charge (not carrier D&D) and is ONLY ever returned when explicitly requested here — thin coverage, see tool description."}, 'container_type': {'enum': ['20GP', '40GP', '40HC', '20RF', '40RF', '20OT', '40OT', '45HC', '40FR', '20FR', '40DG', '20DG', '45RF', '45OT', '45DG', '40TK', '20TK', '45GP', '45TK', '40NOR'], 'type': 'string', 'description': 'ISO 6346 container type — 20GP, 40GP, 40HC, 20RF, 40RF, 20OT, 40OT, 45HC, 40FR, 20FR, 40DG, 20DG, 45RF, 45OT, 45DG, 40TK, 20TK, 45GP, 45TK, 40NOR'}}, 'additionalProperties': False}
shippingrates_dd_compare
Compare D&D Across Shipping Lines
Compare demurrage and detention costs across ALL available carriers for the same country, container type, and detention days.
Use this for freight procurement and carrier selection — it answers "which carrier has the cheapest D&D in this country?" Returns a side-by-side comparison with each carrier's free days, slab rates, and total cost sorted cheapest first.
For a single carrier's detailed D&D breakdown, use shippingrates_dd_calculate instead.
PAID: $0.25/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { line, free_days, total_cost, currency, slabs } for each available carrier, sorted by total_cost ascending.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['country', 'container_type', 'days'], 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Number of detention days'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 2-letter country code'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'container_type': {'enum': ['20GP', '40GP', '40HC', '20RF', '40RF', '20OT', '40OT', '45HC', '40FR', '20FR', '40DG', '20DG', '45RF', '45OT', '45DG', '40TK', '20TK', '45GP', '45TK', '40NOR'], 'type': 'string', 'description': 'ISO 6346 container type — 20GP, 40GP, 40HC, 20RF, 40RF, 20OT, 40OT, 45HC, 40FR, 20FR, 40DG, 20DG, 45RF, 45OT, 45DG, 40TK, 20TK, 45GP, 45TK, 40NOR'}}, 'additionalProperties': False}
shippingrates_dd_countdown
Demurrage/Detention Free-Time Countdown
Given a container's carrier, country, container type and ARRIVAL DATE, report how many free days remain, the first chargeable day, the per-diem once charging starts, cost accrued so far, and a forward cost projection.
Use this to answer "how long until this container starts costing demurrage, and how much per day?" — the proactive companion to shippingrates_dd_calculate (which answers a fixed number of days). Same underlying tariff engine, so the numbers agree.
The free-time clock starts at the carrier-defined event (port discharge or ICD rail arrival) — the arrival_date is taken as supplied, not carrier-confirmed (data_basis = user_supplied_arrival).
Pass charge_type="storage" for a TERMINAL storage countdown instead of carrier D&D (thin coverage — see charge_type param). The response's charge_family field ('carrier_dd' | 'terminal_storage') always discloses which one answered the request.
PAID: $0.10/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: { free_days_total, days_elapsed, free_days_remaining, free_time_ends_on, status, accrued_cost, current_daily_rate, currency, forecast[] }
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['line', 'country', 'container_type', 'arrival_date'], 'properties': {'line': {'enum': ['maersk', 'msc', 'cmacgm', 'cma-cgm', 'hapag-lloyd', 'one', 'cosco', 'zim', 'evergreen', 'yangming', 'hmm', 'arkas', 'oocl', 'pil', 'wanhai'], 'type': 'string', 'description': 'Shipping line slug — maersk, msc, cmacgm (or cma-cgm), hapag-lloyd, one, cosco, zim, evergreen, yangming, hmm, arkas, oocl, pil'}, 'port': {'type': 'string', 'description': 'Optional UN/LOCODE to pin a port-specific tariff (some lanes price ports differently, e.g. north vs south China)'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 2-letter country code (e.g. IN, AE, SG)'}, 'direction': {'enum': ['import', 'export'], 'type': 'string', 'description': 'import or export (default import)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header (optional — required for paid access)'}, 'charge_type': {'enum': ['detention', 'demurrage', 'combined', 'storage'], 'type': 'string', 'description': "Override the charge type; default is the engine's detention→demurrage→combined priority. 'storage' is a distinct TERMINAL charge (not carrier D&D) and is ONLY ever returned when explicitly requested here. Coverage is thin; an uncovered lane returns an explicit 'no data' error listing the currently-covered lanes."}, 'arrival_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Container arrival date, YYYY-MM-DD — starts the free-time clock'}, 'container_type': {'enum': ['20GP', '40GP', '40HC', '20RF', '40RF', '20OT', '40OT', '45HC', '40FR', '20FR', '40DG', '20DG', '45RF', '45OT', '45DG', '40TK', '20TK', '45GP', '45TK', '40NOR'], 'type': 'string', 'description': 'ISO 6346 container type — 20GP, 40GP, 40HC, 20RF, …'}}, 'additionalProperties': False}
shippingrates_facilities
India ICD/CFS Facility Directory
Search India's current official ICEGATE Inland Container Depot (ICD) and Container Freight Station (CFS) directory by source-published facility code, name, and type.
Use this to resolve an official ICEGATE ICD/CFS code or facility name. Optional operational attributes remain null unless a separate official source publishes and certifies them; the current edition does not assert GPS, rail, operator, or capacity data.
PAID: $0.02/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns the existing facility response shape, with certified code/name/type and null for unsupported optional attributes.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'code': {'type': 'string', 'description': 'Facility code filter'}, 'type': {'enum': ['ICD', 'CFS'], 'type': 'string', 'description': 'Facility type filter'}, 'state': {'type': 'string', 'description': 'Indian state name filter'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'rail_connected': {'type': 'string', 'description': "Rail connectivity filter — 'true' or 'false'"}}, 'additionalProperties': False}
shippingrates_fx
Currency Exchange Rates
Get the current certified ECB reference rate between two supported currencies — useful for converting shipping costs quoted in different currencies (USD, EUR, INR, SGD, CNY, JPY, and the rest of the official ECB daily series).
Use this to normalize costs from different carriers/countries to a common currency for comparison. The official publication is updated on ECB working days; unsupported currencies fail closed.
FREE — no payment required.
Returns: { rate, from, to, source, fetched_at, cache_age_minutes }
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'maxLength': 3, 'minLength': 3, 'description': 'Target currency code — e.g. "INR", "SGD"'}, 'from': {'type': 'string', 'maxLength': 3, 'minLength': 3, 'description': 'Source currency code — e.g. "USD", "EUR"'}}, 'additionalProperties': False}
shippingrates_inland_compare
Compare Inland Haulage Rates
Compare inland haulage rates across ALL available carriers for a port-to-ICD/city pair — sorted cheapest first.
Use this for carrier selection on inland legs — answers "which carrier offers the cheapest trucking/rail from port X to city Y?" For a single carrier's rates, use shippingrates_inland_haulage instead. To discover what routes exist, use shippingrates_inland_search first.
Ramp (ICD/CFS pickup) and door delivery rates are never mixed in one comparison — delivery_mode defaults to 'ramp'. Set delivery_mode='door' to compare door-delivery rates instead.
PAID: $0.08/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { carrier, mode, container_type, rate, currency, transit_days, weight_bracket, delivery_mode, icd_code } sorted by rate ascending.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Origin port UN/LOCODE — e.g. INNSA (Nhava Sheva), CNSHA (Shanghai), SGSIN (Singapore)'}, 'icd_code': {'type': 'string', 'description': 'Destination ICD UN/LOCODE filter'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'cargo_class': {'enum': ['general', 'DG'], 'type': 'string', 'description': "Cargo class filter — 'general' or 'DG' (dangerous goods). Default: general."}, 'destination': {'type': 'string', 'minLength': 1, 'description': 'Destination city or ICD code'}, 'delivery_mode': {'enum': ['ramp', 'door'], 'type': 'string', 'description': "Delivery mode filter — 'ramp' (ICD/CFS pickup) or 'door' (door delivery). Default: ramp — ramp and door rates are never mixed in one comparison."}, 'container_type': {'type': 'string', 'description': 'Container type (default: 20GP)'}, 'weight_bracket': {'type': 'string', 'description': 'Weight bracket filter (e.g. standard, heavy)'}}, 'additionalProperties': False}
shippingrates_inland_haulage
Get Inland Haulage Rates
Get inland haulage (trucking/rail) rates for moving containers between a port and an inland location.
Use this when you know the specific origin port and destination and need rate quotes. Returns route-specific rates by container type including base rate, fuel surcharges, and estimated transit times.
To discover what routes exist first, use shippingrates_inland_search. To compare rates across all carriers for the same route, use shippingrates_inland_compare.
PAID: $0.05/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { carrier, origin, destination, container_type, rate, fuel_surcharge, total, currency, transit_days, mode, delivery_mode, icd_code }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'mode': {'type': 'string', 'description': 'Transport mode filter (PRE or ONC)'}, 'origin': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Origin port UN/LOCODE (e.g. INNSA, INMAA)'}, 'icd_code': {'type': 'string', 'description': 'Destination ICD UN/LOCODE filter'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'cargo_class': {'enum': ['general', 'DG'], 'type': 'string', 'description': "Cargo class filter — 'general' or 'DG' (dangerous goods). Default: general."}, 'destination': {'type': 'string', 'minLength': 1, 'description': 'Inland destination city name (e.g. Ahmedabad, Delhi)'}, 'delivery_mode': {'enum': ['ramp', 'door'], 'type': 'string', 'description': "Delivery mode filter — 'ramp' (ICD/CFS pickup) or 'door' (door delivery). Default: ramp."}, 'container_type': {'enum': ['20GP', '40GP', '40HC', '20RF', '40RF', '20OT', '40OT', '45HC', '40FR', '20FR', '40DG', '20DG', '45RF', '45OT', '45DG', '40TK', '20TK', '45GP', '45TK', '40NOR'], 'type': 'string', 'description': 'Container type filter — e.g. 20DV, 40HC, 20RF'}}, 'additionalProperties': False}
shippingrates_inland_search
Search Inland Transport Routes
Search for available inland transport routes (road/rail haulage) from port to inland destinations for a specific carrier.
Use this to discover what haulage routes a carrier offers in a country. For example, search "ahmedabad" to find routes from Nhava Sheva to Ahmedabad via Maersk. Returns route options with ICD/CFS codes and available container types.
For actual haulage rate quotes, use shippingrates_inland_haulage. For cross-carrier rate comparison, use shippingrates_inland_compare.
PAID: $0.03/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { origin, destination, mode, container_types, icd_code } matching the search criteria.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['line', 'country'], 'properties': {'line': {'enum': ['maersk', 'msc', 'cmacgm', 'cma-cgm', 'hapag-lloyd', 'one', 'cosco', 'zim', 'evergreen', 'yangming', 'hmm', 'arkas', 'oocl', 'pil', 'wanhai'], 'type': 'string', 'description': 'Shipping line slug — maersk, msc, cmacgm (or cma-cgm), hapag-lloyd, one, cosco, zim, evergreen, yangming, hmm, arkas, oocl, pil'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 2-letter country code'}, 'keyword': {'type': 'string', 'description': 'Search term — city name, region, or route'}, 'icd_code': {'type': 'string', 'description': 'Destination ICD UN/LOCODE filter'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'delivery_mode': {'enum': ['ramp', 'door'], 'type': 'string', 'description': 'Delivery mode filter (default: ramp)'}}, 'additionalProperties': False}
shippingrates_lines
List Shipping Lines
List reviewed shipping-line identities that currently have live D&D coverage, with per-country record counts.
Use this to discover which carrier-country D&D combinations are currently available before querying a tariff tool.
FREE — no payment required.
Returns: Array of { shipping_line, country, records }.
Related tools: Use shippingrates_stats for aggregate totals, shippingrates_search for keyword-based discovery.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
shippingrates_local_charges
Get Port Local Charges
Get local charges at a port for a specific carrier — Terminal Handling Charges (THC), documentation fees (BL/DO), seal fees, and other port-specific charges.
Use this when calculating total shipping costs at origin or destination. Combine with shippingrates_dd_calculate for a complete port cost picture, or use shippingrates_total_cost for an all-in-one landed cost estimate.
PAID: $0.05/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { charge_type, charge_name, amount, currency, container_type, direction } for all applicable charges at the port.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['line', 'country'], 'properties': {'line': {'enum': ['maersk', 'msc', 'cmacgm', 'cma-cgm', 'hapag-lloyd', 'one', 'cosco', 'zim', 'evergreen', 'yangming', 'hmm', 'arkas', 'oocl', 'pil', 'wanhai'], 'type': 'string', 'description': 'Shipping line slug — maersk, msc, cmacgm (or cma-cgm), hapag-lloyd, one, cosco, zim, evergreen, yangming, hmm, arkas, oocl, pil'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 2-letter country code'}, 'port_code': {'type': 'string', 'description': 'Port code to filter (e.g. INMUN for Mumbai)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}}, 'additionalProperties': False}
shippingrates_port
Port Lookup
Look up port details by UN/LOCODE — name, country, coordinates, timezone, and terminal facilities.
Use this to validate port codes or get port metadata. If you don't know the UN/LOCODE, use shippingrates_search with the port or city name first.
PAID: $0.01/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: { port_code, port_name, country, country_code, lat, lon, timezone, facilities }
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['code'], 'properties': {'code': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'UN/LOCODE port code — e.g. "INNSA", "AEJEA", "SGSIN"'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}}, 'additionalProperties': False}
shippingrates_rates
Published Freight Benchmarks
Get current certified freight benchmark observations between two ports, optionally filtered by container type.
These are official published market indices, not carrier spot quotes or contracted rates. An unsupported lane returns an empty rates array. For a published multi-component estimate, use shippingrates_total_cost and inspect its coverage, data_gaps, and total_is_partial fields.
PAID: $0.03/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: { route, rates: [{ trade_lane_name, origin_port, origin_region, destination_port, destination_region, container_type, rate_low, rate_mid, rate_high, currency, index_source, trend, week_over_week_change_pct, rate_date }], carriers, transit_days_min, transit_days_max, rate_low?, rate_mid?, rate_high?, trend?, currency? }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Origin port UN/LOCODE — e.g. INNSA (Nhava Sheva), CNSHA (Shanghai), SGSIN (Singapore)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'destination': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Destination port UN/LOCODE — e.g. AEJEA (Jebel Ali), NLRTM (Rotterdam), USNYC (New York)'}, 'container_type': {'enum': ['20GP', '40GP', '40HC', '20RF', '40RF', '20OT', '40OT', '45HC', '40FR', '20FR', '40DG', '20DG', '45RF', '45OT', '45DG', '40TK', '20TK', '45GP', '45TK', '40NOR'], 'type': 'string', 'description': 'Container type filter — e.g. 20DV, 40HC, 20RF'}}, 'additionalProperties': False}
shippingrates_regulatory
Regulatory Updates
Get recent shipping regulatory updates and compliance requirements for a specific country — customs regulations, documentation requirements, trade restrictions, and policy changes.
Use this to stay current on regulatory changes that may affect shipments to/from a country.
PAID: $0.01/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: { updates: Array of { country, authority, subject, summary, category, reference_number, effective_date, source, source_url, scraped_at } }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['country'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results (default: 10)'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 2-letter country code'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}}, 'additionalProperties': False}
shippingrates_reliability
Schedule Reliability
Get the latest certified public schedule-reliability highlights for a carrier.
Use this for carrier selection and high-level benchmarking. Only metrics explicitly published in the source highlight are returned; unpublished carrier delay or sample-size fields remain null.
PAID: $0.02/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns the unchanged API reliability envelope with source, period, freshness, and published metric fields.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['line'], 'properties': {'line': {'enum': ['maersk', 'msc', 'cmacgm', 'cma-cgm', 'hapag-lloyd', 'one', 'cosco', 'zim', 'evergreen', 'yangming', 'hmm', 'arkas', 'oocl', 'pil', 'wanhai'], 'type': 'string', 'description': 'Shipping line slug — maersk, msc, cmacgm (or cma-cgm), hapag-lloyd, one, cosco, zim, evergreen, yangming, hmm, arkas, oocl, pil, wanhai'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'trade_lane': {'type': 'string', 'description': "Trade lane filter — e.g. 'Asia-Europe', 'Transpacific', 'Asia-Middle East'"}}, 'additionalProperties': False}
shippingrates_risk_score
Route Risk Assessment
Get a deterministic route-risk score (0-100) from current certified port-congestion measurements and explicit official disruption advisories.
Unknown inputs contribute zero points. A route is scored only when at least one current, source-published signal applies; unsupported routes return no result instead of an estimated score. Chokepoint impacts use an immutable, certified UN/LOCODE mapping for Hormuz, Suez, Bab el-Mandeb, Malacca, and Panama. For exact measurements, use shippingrates_congestion. For advisory detail, use shippingrates_congestion_news.
PAID: $0.10/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns the unchanged API result shape: { origin_risk, dest_risk, route_risk_score, active_alerts[], chokepoints_affected[] }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Origin port UN/LOCODE — e.g. INNSA (Nhava Sheva), CNSHA (Shanghai), SGSIN (Singapore)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'destination': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Destination port UN/LOCODE — e.g. AEJEA (Jebel Ali), NLRTM (Rotterdam), USNYC (New York)'}}, 'additionalProperties': False}
shippingrates_search
Search ShippingRates Data
Search current customer-published ShippingRates datasets by keyword.
Matches certified port codes/names, reviewed carrier identities, published transit services, and published local-charge names/carriers. Uncertified families remain empty and legacy rows are never used as a fallback.
FREE — no payment required.
Returns: { query, results: { ports, shipping_lines, trade_lanes, regulatory, local_charges } }.
Related tools: Use shippingrates_port for structured port lookup by UN/LOCODE, shippingrates_lines for full carrier listing.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['keyword'], 'properties': {'keyword': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Search term — e.g. "maersk", "mumbai", "hapag-lloyd"'}}, 'additionalProperties': False}
shippingrates_stats
ShippingRates Certified Publication Statistics
Get current counts from ShippingRates customer-published datasets.
Use this before calling data tools. Counts include only certified dependencies that are currently publishable; uncertified or unavailable families report zero instead of falling back to legacy database rows. The countries and shipping_lines fields are distinct counts represented in the published D&D tariff family.
FREE — no payment required.
Returns: { tariff_records, ports, transit_schedules, freight_rates, local_charges, shipping_lines, countries, last_scrape (ISO datetime) }
Related tools: Use shippingrates_lines for per-carrier breakdowns, shippingrates_search for keyword discovery.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
shippingrates_surcharges
Shipping Surcharges
Get carrier-specific surcharges — BAF (Bunker Adjustment Factor), CAF (Currency Adjustment Factor), PSS (Peak Season Surcharge), EBS (Emergency Bunker Surcharge), and more.
Use this to understand surcharge exposure for a carrier in a specific country/direction. These are charges added on top of base freight rates. For a complete cost breakdown, use shippingrates_total_cost which includes surcharges automatically.
PAID: $0.02/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { surcharge_type, surcharge_name, amount, currency, per_unit, effective_from, effective_to, direction }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['line'], 'properties': {'line': {'enum': ['maersk', 'msc', 'cmacgm', 'cma-cgm', 'hapag-lloyd', 'one', 'cosco', 'zim', 'evergreen', 'yangming', 'hmm', 'arkas', 'oocl', 'pil', 'wanhai'], 'type': 'string', 'description': 'Shipping line slug — maersk, msc, cmacgm (or cma-cgm), hapag-lloyd, one, cosco, zim, evergreen, yangming, hmm, arkas, oocl, pil'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 2-letter country code'}, 'direction': {'enum': ['import', 'export'], 'type': 'string', 'description': "Trade direction — 'import' or 'export'"}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}}, 'additionalProperties': False}
shippingrates_total_cost
Published Total-Cost Estimate
Calculate a published multi-component shipping-cost estimate from certified dependencies: freight benchmark observations when available, surcharges, origin/destination local charges, requested demurrage/detention exposure, FX, and transit context.
The result can be partial. A market index is not a carrier quote, and a missing component is counted as zero only when the response explicitly reports the gap. Always inspect coverage, data_gaps, total_is_partial, warning, and each component's verified flag before quoting the result. For individual components, use shippingrates_rates, shippingrates_surcharges, shippingrates_local_charges, and shippingrates_dd_calculate.
PAID: $0.15/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: { components: { freight: { amount, currency, basis, verified }, origin_local_charges / destination_local_charges: { port, items: [{ charge, amount, currency, charge_type ('mandatory'|'additional'), charge_type_reason? }], total, mandatory_total, additional_total, currency: 'INR', verified }, surcharges: { items, total, verified }, detention_demurrage? }, coverage, data_gaps?, transit_days, total_estimated_cost_usd, total_estimated_cost_inr, totals_basis: 'mandatory_only', total_additional_cost_usd/inr, total_all_inclusive_cost_usd/inr }.
IMPORTANT: the headline total_estimated_cost_* sums MANDATORY charges only (freight, lane surcharges, mandatory local charges, requested D&D). Conditional/if-applicable fees (amendments, penalties, cargo-type surcharges) are excluded from the headline — they are itemized with charge_type='additional' and summed in total_additional_cost_*; total_all_inclusive_cost_* is the sum of both.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['line', 'origin', 'destination', 'container_type'], 'properties': {'line': {'enum': ['maersk', 'msc', 'cmacgm', 'cma-cgm', 'hapag-lloyd', 'one', 'cosco', 'zim', 'evergreen', 'yangming', 'hmm', 'arkas', 'oocl', 'pil', 'wanhai'], 'type': 'string', 'description': 'Shipping line slug — maersk, msc, cmacgm (or cma-cgm), hapag-lloyd, one, cosco, zim, evergreen, yangming, hmm, arkas, oocl, pil'}, 'origin': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Origin port UN/LOCODE — e.g. INNSA (Nhava Sheva), CNSHA (Shanghai), SGSIN (Singapore)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'destination': {'type': 'string', 'maxLength': 20, 'minLength': 2, 'description': 'Destination port or inland location'}, 'container_type': {'enum': ['20GP', '40GP', '40HC', '20RF', '40RF', '20OT', '40OT', '45HC', '40FR', '20FR', '40DG', '20DG', '45RF', '45OT', '45DG', '40TK', '20TK', '45GP', '45TK', '40NOR'], 'type': 'string', 'description': 'ISO 6346 container type — 20GP, 40GP, 40HC, 20RF, 40RF, 20OT, 40OT, 45HC, 40FR, 20FR, 40DG, 20DG, 45RF, 45OT, 45DG, 40TK, 20TK, 45GP, 45TK, 40NOR'}, 'detention_days': {'type': 'integer', 'maximum': 365, 'minimum': 0, 'description': 'Expected detention days (default: 0)'}}, 'additionalProperties': False}
shippingrates_transit
Transit Time Lookup
Get estimated ocean transit times between two ports across all available carriers.
Use this for quick transit time comparison between ports — answers "how long does it take to ship from A to B?" Returns carrier-specific transit durations, service types, and frequencies.
For detailed routing with transhipment ports and service codes, use shippingrates_transit_schedules instead.
PAID: $0.02/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { carrier, transit_days, service_type, frequency, direct_or_transhipment }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Origin port UN/LOCODE — e.g. INNSA (Nhava Sheva), CNSHA (Shanghai), SGSIN (Singapore)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'destination': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Destination port UN/LOCODE — e.g. AEJEA (Jebel Ali), NLRTM (Rotterdam), USNYC (New York)'}}, 'additionalProperties': False}
shippingrates_transit_schedules
Transit Schedules by Carrier
Get detailed transit schedules for a specific carrier — service codes, routing via transhipment ports, transit days, and sailing frequency.
Use this when you need routing details beyond just transit time — e.g., which transhipment ports are used, what service string applies, or weekly frequency. For a quick transit time comparison across all carriers, use shippingrates_transit instead.
PAID: $0.03/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { carrier, service_code, origin, destination, transit_days, transhipment_ports[], frequency, direct }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['carrier'], 'properties': {'origin': {'type': 'string', 'description': 'Origin port UN/LOCODE filter'}, 'carrier': {'type': 'string', 'minLength': 1, 'description': 'Carrier SCAC code or slug'}, 'max_days': {'type': 'integer', 'minimum': 1, 'description': 'Maximum transit days filter'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'destination': {'type': 'string', 'description': 'Destination port UN/LOCODE filter'}}, 'additionalProperties': False}
shippingrates_vessel_schedule
Vessel Schedule
Get upcoming vessel arrivals and departures at a specific port.
Use this to check what vessels are expected at a port — useful for booking planning and tracking. Returns vessel names, carriers, ETAs/ETDs, and service routes.
For transit time estimates between two ports, use shippingrates_transit. For detailed service-level routing, use shippingrates_transit_schedules.
PAID: $0.02/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: Array of { vessel_name, carrier, voyage, eta, etd, service, from_port, to_port }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['port'], 'properties': {'port': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'UN/LOCODE port code — e.g. INNSA (Nhava Sheva), AEJEA (Jebel Ali), SGSIN (Singapore)'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'days_ahead': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'Days to look ahead (default: 14)'}}, 'additionalProperties': False}
shippingrates_vessel_schedule_options
Vessel Schedule Options With Cutoffs
Get carrier vessel/voyage schedule options between an origin and destination, including operational cutoff deadlines when the carrier source publishes them.
Use this for booking planning questions that need vessel details, voyage number, transshipment ports, ETA/ETD, and port/SI/VGM cutoffs. Missing cutoff fields remain null or absent; ShippingRates does not infer unpublished deadlines.
For port-call monitoring without cutoff details, use shippingrates_vessel_schedule.
PAID: $0.03/call via x402 (USDC on Base or Solana). Without payment, returns 402 with payment instructions.
Returns: { origin, destination, options: Array<{ carrier, vessel_name, vessel_imo, voyage_number, etd, eta, transshipment_ports, cutoffs, source_url }>, coverage }.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum schedule options to return (default: 50)'}, 'origin': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Origin UN/LOCODE — e.g. CNSHA, INNSA, SGSIN'}, 'carrier': {'type': 'string', 'description': 'Optional carrier filter — e.g. cmacgm, hapag, maersk'}, 'x_payment': {'type': 'string', 'description': 'x402 payment proof header'}, 'days_ahead': {'type': 'integer', 'maximum': 180, 'minimum': 1, 'description': 'Days to look ahead (default: 90)'}, 'destination': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': 'Destination UN/LOCODE — e.g. USLAX, DEHAM, AEJEA'}}, 'additionalProperties': False}
Verlauf
Letzte Tool-Änderungen
Hinzugefügt
shippingrates_dd_countdown
17. September 2026 12:53
Hinzugefügt
shippingrates_risk_score
17. September 2026 12:53
Hinzugefügt
shippingrates_inland_compare
17. September 2026 12:53
Hinzugefügt
shippingrates_congestion_news
17. September 2026 12:53
Hinzugefügt
shippingrates_facilities
17. September 2026 12:53
Hinzugefügt
shippingrates_transit_schedules
17. September 2026 12:53
Hinzugefügt
shippingrates_fx
17. September 2026 12:53
Hinzugefügt
shippingrates_total_cost
17. September 2026 12:53
Hinzugefügt
shippingrates_regulatory
17. September 2026 12:53
Hinzugefügt
shippingrates_vessel_schedule_options
17. September 2026 12:53
Hinzugefügt
shippingrates_vessel_schedule
17. September 2026 12:53
Hinzugefügt
shippingrates_reliability
17. September 2026 12:53
Hinzugefügt
shippingrates_congestion
17. September 2026 12:53
Hinzugefügt
shippingrates_surcharges
17. September 2026 12:53
Hinzugefügt
shippingrates_rates
17. September 2026 12:53
Hinzugefügt
shippingrates_transit
17. September 2026 12:53
Hinzugefügt
shippingrates_port
17. September 2026 12:53
Hinzugefügt
shippingrates_inland_haulage
17. September 2026 12:53
Hinzugefügt
shippingrates_cfs_tariffs
17. September 2026 12:53
Hinzugefügt
shippingrates_inland_search
17. September 2026 12:53
Hinzugefügt
shippingrates_local_charges
17. September 2026 12:53
Hinzugefügt
shippingrates_dd_compare
17. September 2026 12:53
Hinzugefügt
shippingrates_dd_calculate
17. September 2026 12:53
Hinzugefügt
shippingrates_search
17. September 2026 12:53
Hinzugefügt
shippingrates_lines
17. September 2026 12:53
Hinzugefügt
shippingrates_stats
17. September 2026 12:53
Entdecken
Ähnliche MCP-Server
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Oracle
com.stratalize/oracle
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Intelligence
com.stratalize/intelligence
Provides vendor, market, SaaS, workforce, government contract, public company, regulatory, competitive, and AI-brand intelligence…
Stratalize Real Estate
com.stratalize/realestate
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…