FreightUtils MCP Server

Calculate cubic metres (CBM) for a shipment. CBM is the standard volume unit in international shipping. 1 CBM = 1m x 1m x 1m = 1,000 litres. Ocean freight carriers price per "freight tonne" (1 CBM or 1,000 kg, whichever is greater).

• length_cmnumberrequiredLength in centimetres
• width_cmnumberrequiredWidth in centimetres
• height_cmnumberrequiredHeight in centimetres
• piecesintegerNumber of identical pieces (default: 1)

Calculate air freight chargeable weight (volumetric vs actual). Airlines charge the greater of actual weight or volumetric weight. IATA standard factor: 6,000 (1 CBM = 166.67 kg). A ratio > 1.0 means volumetric (light for its size).

• length_cmnumberrequiredLength in centimetres
• width_cmnumberrequiredWidth in centimetres
• height_cmnumberrequiredHeight in centimetres
• gross_weight_kgnumberrequiredActual gross weight in kilograms
• piecesintegerNumber of identical pieces (default: 1)
• factorintegerVolumetric divisor (default: 6000)

Calculate loading metres (LDM) for road freight. LDM measures trailer utilisation. European trailers are 13.6m long, 2.4m wide. Supports pallet presets (euro, uk, half, quarter) and vehicles (artic, rigid10, rigid75, luton).

• palletstringPallet preset
• length_mmnumberCustom pallet length in mm
• width_mmnumberCustom pallet width in mm
• quantityintegerNumber of pallets (default: 1)
• stackablebooleanCan pallets be stacked?
• stack_heightintegerStack height 2 or 3
• weight_kgnumberWeight per pallet in kg
• vehiclestringVehicle type
• vehicle_length_mnumberCustom vehicle length in m

Look up dangerous-goods (hazmat) reference data from the ADR 2025 dataset — 2,939 entries across all 9 hazard classes. Provide exactly one of: un_number (exact lookup, returns every packing-group variant), search (case-insensitive partial match on the proper shipping name, min 2 characters), or hazard_class (all entries in that class). Returns proper shipping name, hazard class, classification code, packing group, labels, special provisions, limited/excepted quantity codes, transport category, tunnel restriction code, and hazard identification number for each match. Returns reference data only — it does not assess or certify regulatory compliance for a shipment; an empty result set means nothing matched.

• un_numberstringExact UN number — 4 digits, optionally "UN"-prefixed; explosives keep their leading zero. Examples: "1203", "UN1203", "0004".
• searchstringCase-insensitive partial match on the proper shipping name (min 2 characters). Example: "acetone".
• hazard_classstringFilter by ADR hazard class and its divisions. Examples: "3" (flammable liquids), "6.1" (toxic), "8" (corrosive), "1.4" (an explosives division).

Calculate ADR 1.1.3.6 exemption. Points = quantity x multiplier per transport category. Total <= 1,000 = exempt from full ADR requirements. For single substance: provide un_number + quantity. For mixed loads: provide items array.

• un_numberstringUN number for single check (4 digits, optionally "UN"-prefixed)
• quantitynumberQuantity in kg/L
• itemsarrayArray of items for mixed-load check

Search 6,352 airlines by name, IATA/ICAO code, AWB prefix, or country. AWB prefixes are 3-digit codes on air waybills identifying the carrier (e.g., 176 = Emirates).

• querystringGeneral search (name, code, prefix or country — min 2 chars)
• iatastringExact IATA code (2 alphanumeric chars)
• icaostringExact ICAO code (3 letters)
• prefixstringAWB prefix (3 digits)
• countrystringFilter by country name (min 2 chars)

Get ISO shipping container specs (10 types: 20ft, 40ft, 40ft HC, reefer, open-top, flat-rack, 45ft). Returns dimensions, capacity, weight limits, and pallet counts.

• typestringContainer slug (e.g., "20ft-standard", "40ft-high-cube"). Omit to list all.

Search 6,940 Harmonized System tariff codes. HS codes are 6-digit international product classification codes used for customs. Provide a search term or exact code.

• querystringSearch by product description (min 2 chars)
• codestringExact HS code (2-6 digits)
• sectionstringBrowse by section (Roman numeral I–XXI)

Look up Incoterms 2020 trade rules. 11 rules defining transport, insurance, customs responsibilities. 7 for any mode (EXW, FCA, CPT, CIP, DAP, DPU, DDP), 4 sea-only (FAS, FOB, CFR, CIF).

• codestringIncoterm code (3 letters, e.g., "FOB", "CIF")
• categorystringFilter by mode

Calculate how many boxes fit on a pallet with layers, rotation, and weight limits. Determines optimal arrangement and volume utilisation.

• pallet_length_cmnumberrequiredPallet length in cm
• pallet_width_cmnumberrequiredPallet width in cm
• pallet_max_height_cmnumberrequiredMax stack height in cm
• pallet_deck_height_cmnumberPallet deck height (default: 15cm)
• box_length_cmnumberrequiredBox length in cm
• box_width_cmnumberrequiredBox width in cm
• box_height_cmnumberrequiredBox height in cm
• box_weight_kgnumberBox weight in kg
• max_payload_kgnumberMax pallet payload in kg
• allow_rotationbooleanAllow 90-degree rotation (default: true)

Convert between freight units. Weight: kg, lbs, oz, tonnes, short_tons, long_tons. Volume: cbm, cuft, cuin, litres, gal_us, gal_uk. Length: cm, inches, m, feet, mm. Freight: cbm→chargeable_kg, cbm→freight_tonnes.

• valuenumberrequiredValue to convert
• fromstringrequiredSource unit — weight (kg, lbs, oz, tonnes, short_tons, long_tons), volume (cbm, cuft, cuin, litres, gal_us, gal_uk) or length (cm, inches, m, feet, mm)
• tostringrequiredTarget unit — any source unit, plus the freight targets chargeable_kg and freight_tonnes (only valid from cbm)

Calculate total CBM, loading metres (LDM), volumetric and mode-specific chargeable weight for a multi-item mixed consignment — per-line and grand totals, plus objective advisory flags. Provide a transport mode (sea | air | road) and either "lines" (canonical: each line has quantity, dims {l,w,h,unit}, weight {value,unit}, and optional description / hs_code / un_number / stackable) or the legacy flat "items" array (dimensions in cm, weight in kg). Air uses an IATA volumetric divisor (default 6000, settable via options.air_volumetric_divisor). Optionally pass options.container_number / options.awb_number for a check-digit sanity flag. Flags are advisory only — implausible density, mode/option mismatch, dangerous-goods presence by UN number against the ADR 2025 reference, and container/AWB check-digit validity. They never state that a shipment is permitted or compliant. Best-effort deterministic calculation and reference data only. Verify all inputs. Not regulatory, customs, or dangerou

• modestringTransport mode: sea | air | road (default road). Selects the chargeable-weight basis.
• linesarrayCanonical consignment lines (preferred). Each: { quantity, dims:{l,w,h,unit}, weight:{value,unit}, optional description / hs_code / un_number / stackable }.
• itemsarrayDeprecated flat alias — dimensions in cm, weight in kg. Prefer "lines". Provide lines OR items.
• optionsobjectOptional: { air_volumetric_divisor, container_number, awb_number }.

Search 116,129 UN/LOCODE transport locations worldwide. Covers seaports, airports, rail terminals, road terminals, inland clearance depots, and border crossings. Search by location name, code (e.g. GBLHR), country, or function type.

• querystringSearch by name or code (e.g. "Rotterdam", "GBLHR", "LHR")
• codestringExact UN/LOCODE lookup (e.g. "GBLHR", "NLRTM")
• countrystringISO 2-letter country code filter (e.g. "GB", "NL")
• function_typestringFilter by location function
• limitintegerMax results (default 20)

Estimate UK import duty and VAT for a commodity code and origin country. Uses live GOV.UK Trade Tariff data. Returns CIF value, duty rate/amount, VAT rate/amount, total import taxes, and total landed cost. Flags preferential rates and import restrictions.

• commodity_codestringrequiredUK tariff commodity code (6-10 digits)
• origin_countrystringrequiredISO 2-letter country of origin (e.g. "CN", "US")
• customs_valuenumberrequiredCustoms value in GBP
• freight_costnumberFreight cost in GBP (default 0)
• insurance_costnumberInsurance cost in GBP (default 0)
• incotermstringIncoterm basis

Composite shipment summary — chains CBM, weight, LDM/volumetric/W&M, ADR compliance, and UK duty estimation into one response. Accepts multiple items with a transport mode (road/air/sea/multimodal). Returns per-mode calculations, DG compliance flags, and customs estimates.

• modestringrequiredTransport mode
• itemsarrayrequiredArray of shipment items with dimensions, weight, and optional HS/UN codes
• originobjectOrigin location — ISO country code and optional UN/LOCODE
• destinationobjectDestination location — ISO country code and optional UN/LOCODE
• incotermstringIncoterms 2020 three-letter code (e.g. 'DAP', 'EXW', 'FOB')
• freight_costnumberOptional freight cost in GBP for duty calculation
• insurance_costnumberOptional insurance cost in GBP for duty calculation

Look up air freight ULD (Unit Load Device) specs. 16 types including AKE (LD3), PMC, PLA, and special units. Returns dimensions, weights, volume, aircraft compatibility, and deck position.

• typestringULD code (e.g., "AKE", "PMC") or slug (e.g., "ake-ld3"). Omit to list all.
• categorystringFilter by ULD category
• deckstringFilter by deck position

Look up road freight vehicle and trailer specs. 17 types: curtainsiders, rigids, vans, US trailers. Returns internal dimensions, payload limits, pallet capacity, and features.

• slugstringVehicle slug (e.g., "standard-curtainsider"). Omit to list all.
• categorystringFilter by category
• regionstringFilter by region

Get the URL where the user can subscribe to FreightUtils Pro for higher API limits. Use this when the user asks how to upgrade, hits a rate limit, or asks about pricing. Returns the URL where the user can subscribe via web — agents must NOT attempt to complete the subscription themselves.

• tierstringTier to surface (only "pro" supported today)

Compare quantities against the ADR 2025 Limited Quantity (LQ, Chapter 3.4) and Excepted Quantity (EQ, Chapter 3.5, codes E1–E5) reference limits for one or more UN numbers. For each item it looks up the substance's LQ/EQ value and reports whether the entered quantity is within_limit, exceeds_limit, or not_permitted, with the limit and a plain-language reason; EQ mode also checks the per-outer total via inner_packaging_qty. Returns an overall_status (qualifies / partial / does_not_qualify) plus a per-item breakdown. This is a reference-data comparison against published LQ/EQ limits, not a certification that a shipment is compliant — use it to pre-screen small-quantity consignments before formal classification.

• modestringrequiredCheck mode: 'lq' (Limited Quantity, ADR 3.4) or 'eq' (Excepted Quantity, ADR 3.5)
• itemsarrayrequiredItems to check (1–20 per call).

Estimate freight transport greenhouse-gas emissions (kgCO2e) for a shipment leg, per ISO 14083:2023 / GLEC Framework v3.2: emissions = mass × distance × a published emission-intensity factor (kgCO2e/tonne-km). Provide mass + distance_km + mode (road | rail | sea | air | inland_waterway); optionally choose sub_mode, region/authority (uk = DEFRA, us = EPA, fr = ADEME) and basis (wtw default, or ttw). Returns well-to-wheel AND tank-to-wheel emissions where the factor has both, the exact factor used (value, authority, edition), the tonne-km activity, and a _source citing BOTH the ISO method and the specific open factor. Use when an agent needs a carbon estimate for a known shipment whose mass and distance are already determined. Distinct from cbm_calculator / ldm_calculator / chargeable_weight_calculator (those size or bill a shipment; this one estimates its CO2e). Distance must be provided — this tool does NOT route, geocode, or compute distances. Best-effort reference estimate from open

• massnumberrequiredShipment mass, expressed in mass_unit. Example: 1000
• mass_unitstringUnit for mass (default: kg)
• distance_kmnumberrequiredTransport distance in kilometres — you provide it; the tool does not route or compute distance
• modestringrequiredTransport mode
• sub_modestringOptional sub-mode / vehicle class (e.g. "articulated", "container ship", "long-haul"). Omit for the representative default; an unknown value returns available:false with the covered list.
• regionstringFactor source/region: uk = DEFRA, us = EPA, fr = ADEME. Default is per-mode.
• basisstringEmissions basis: wtw = well-to-wheel incl. upstream energy (default), ttw = tank-to-wheel / operation only

Validate and parse freight identifiers by their public check-digit algorithms: shipping container numbers (ISO 6346), air waybill (AWB) numbers (IATA modulus-7) and IMO ship identification numbers. Two modes: pass text=<arbitrary string> to find and validate every identifier in it (e.g. a booking email line), OR pass value=<identifier>&type=<container|awb|imo> to validate one. Returns, per identifier found: type, the normalised form, valid (check-digit pass/fail), the expected vs actual check digit, and details (container → owner prefix + equipment category; AWB → airline prefix + the airline, resolved from the AWB-prefix dataset; IMO → the 7-digit number). Use when an agent needs to confirm a container/AWB/IMO number is well-formed, or to extract identifiers from a freeform string. STRUCTURAL ONLY — a valid check digit means well-formed, NOT that the container/shipment/vessel exists or is active; this is not a registry/tracking lookup. Distinct from container_lookup (that returns cont

• textstringArbitrary string to scan for container / AWB / IMO identifiers (parse mode). Provide this OR value+type.
• valuestringA single identifier to validate (typed mode). Requires type.
• typestringIdentifier type for value: container = ISO 6346, awb = IATA Air Waybill, imo = IMO ship number.

Check a goods description against the official EU ICS2 stop-words list — terms the European Commission deems too vague/generic to be accepted in an entry summary declaration (ENS) goods-description field (data element 18 05 000 000). Pass description=<goods description>; returns the flagged terms (each with a note on whether it is the standalone description = automatic rejection, or embedded = make the description more specific), a clean boolean, a caveat, and a _source citing the EU list + legal basis. Use to QA a goods description BEFORE filing an ENS — for customs/documentation teams, brokers, forwarders' documentation side, and agents building ENS/filing pipelines. STRICTLY a reference check: NOT an ENS filing, NOT a customs-compliance determination, NOT legal advice. The list is non-exhaustive and updated periodically; clean does NOT guarantee acceptance (the description must still be specific enough to identify the goods). No binary accepted/rejected verdict is returned. Distinct

• descriptionstringrequiredThe goods description to check against the EU ICS2 stop-words list.