# FreightUtils MCP Server MCP server 19 freight tools: ADR 2025+LQ/EQ, HS, airlines, UN/LOCODE, ULDs, duty, CBM/LDM, get_subscribe_link ## Links - Registry page: https://www.getdrio.com/mcp/io-github-soapyred-freightutils - Repository: https://github.com/SoapyRED/freightutils-mcp ## Install - Command: `npx -y freightutils-mcp` - Endpoint: https://www.freightutils.com/api/mcp - Auth: Not captured ## Setup notes - Package: Npm freightutils-mcp v2.3.0 - Remote endpoint: https://www.freightutils.com/api/mcp ## Tools - cbm_calculator - 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). Endpoint: https://www.freightutils.com/api/mcp - chargeable_weight_calculator - 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). Endpoint: https://www.freightutils.com/api/mcp - ldm_calculator - 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). Endpoint: https://www.freightutils.com/api/mcp - adr_lookup - 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. Endpoint: https://www.freightutils.com/api/mcp - adr_exemption_calculator - 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. Endpoint: https://www.freightutils.com/api/mcp - airline_lookup - 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). Endpoint: https://www.freightutils.com/api/mcp - airport_lookup (Airport Code Lookup) - Look up an airport by IATA code (3 letters, e.g. "LHR"), ICAO code (4 chars, e.g. "EGLL"), or free-text name / city search (e.g. "heathrow", "chicago"). Returns the full record: IATA + ICAO, name, type (large/medium/small/heliport/closed/seaplane), municipality, region, country, latitude/longitude and elevation. Optional type filter; ambiguous name searches return ranked candidates (exact codes first, then larger airports). Covers 85,555 airports worldwide (OurAirports, public domain, cross-checked vs OpenFlights + Wikidata). Use when an agent has an airport code or name and needs the airport's identity, location or codes. Distinct from airline_lookup (which searches CARRIERS / AWB prefixes, not airports) and unlocode_lookup (general UN/LOCODE transport locations — ports, rail, road — of which airports are only one function). Reference data only — not for navigation; verify current codes with IATA / ICAO. Endpoint: https://www.freightutils.com/api/mcp - nearest_airport (Nearest Airport) - Find the airports nearest to a caller-provided latitude/longitude, sorted by great-circle (haversine) distance with distance_km on each result. Inputs: latitude, longitude (required), optional radius_km, max_results (1–50, default 10) and type filter (e.g. large_airport only). Coordinates are INPUT only — nothing is stored or logged. Searches 85,555 airports (OurAirports, public domain). Use when an agent already has a coordinate (a port, warehouse, city centre, or the user's location) and needs the closest airport(s). This tool does NOT geocode place names and does NOT compute routes — pass coordinates you already hold. Distinct from airport_lookup (exact code / name lookup, no distance) and unlocode_lookup (named transport-location search). Endpoint: https://www.freightutils.com/api/mcp - container_lookup - 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. Endpoint: https://www.freightutils.com/api/mcp - hs_code_lookup - 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. Endpoint: https://www.freightutils.com/api/mcp - incoterms_lookup - 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). Endpoint: https://www.freightutils.com/api/mcp - pallet_fitting_calculator - Calculate how many boxes fit on a pallet with layers, rotation, and weight limits. Determines optimal arrangement and volume utilisation. Endpoint: https://www.freightutils.com/api/mcp - unit_converter - 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. Endpoint: https://www.freightutils.com/api/mcp - consignment_calculator - 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 dangerous-goods compliance advice — you remain responsible for classification, documentation, and carrier acceptance. Endpoint: https://www.freightutils.com/api/mcp - unlocode_lookup - 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. Endpoint: https://www.freightutils.com/api/mcp - uk_duty_calculator - 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. Endpoint: https://www.freightutils.com/api/mcp - shipment_summary - 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. Endpoint: https://www.freightutils.com/api/mcp - uld_lookup - 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. Endpoint: https://www.freightutils.com/api/mcp - vehicle_lookup - Look up road freight vehicle and trailer specs. 17 types: curtainsiders, rigids, vans, US trailers. Returns internal dimensions, payload limits, pallet capacity, and features. Endpoint: https://www.freightutils.com/api/mcp - get_subscribe_link - 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. Endpoint: https://www.freightutils.com/api/mcp - adr_lq_eq_check - 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. Endpoint: https://www.freightutils.com/api/mcp - emissions_calculator (Freight Emissions Calculator) - 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 factors (DEFRA / EPA / ADEME) — NOT a verified or audited carbon report. IMPORTANT: pass ACTUAL GROSS MASS, not chargeable/volumetric weight (a common air-freight mistake — see mass_basis). The fleet-average factor already includes average empty running (see empty_running) — do NOT add your own empty-return leg. Sea and air are low-representativeness generic defaults: real emissions vary materially by vessel/aircraft type, load factor and routing (see representativeness + the result summary). An unknown mode/sub_mode/region returns available:false with the covered options, never a fabricated factor. Endpoint: https://www.freightutils.com/api/mcp - validate (Freight Identifier Validator) - Find and validate every freight identifier inside an arbitrary string (e.g. a booking line or email) — or validate a single identifier by type — using the public check-digit algorithms for shipping container numbers (ISO 6346), air waybill (AWB) numbers (IATA modulus-7) and IMO ship identification numbers. Two modes: pass text= to find and validate every identifier in it (parse mode), OR pass value=&type= 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 container TYPE dimensions/specs) and airline_lookup (that searches airlines); this checks an identifier's check digit and, for an AWB, names the operating airline. Endpoint: https://www.freightutils.com/api/mcp - ics2_check (ICS2 Stop-Words Checker) - 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=; 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 from hs_code_lookup (commodity codes) and uk_duty_calculator (duty/VAT). Endpoint: https://www.freightutils.com/api/mcp ## Resources Not captured ## Prompts Not captured ## Metadata - Owner: io.github.SoapyRED - Version: 2.3.0 - Runtime: Npm - Transports: STDIO, HTTP - License: Not captured - Language: Not captured - Stars: Not captured - Updated: May 31, 2026 - Source: https://registry.modelcontextprotocol.io