SoapyRED/freightutils-mcp

**The neutral freight reference layer for AI agents.**
FreightUtils is the neutral freight reference layer for AI agents — source-backed dangerous-goods, customs, location and freight-calculation data an agent can call and cite, from primary sources (ADR 2025 / UNECE, HS 2022 / WCO, IATA-regulated airline prefixes). Neutral by design: no freight to sell and no carrier to push — a lookup returns what the named source says, with the citation attached so an agent can inspect it rather than take our word for it, regardless of who carries the load.
This Model Context Protocol server gives AI agents access to 25 freight calculation and reference tools, covering road, air, and sea freight. Built by a UK ADR-certified freight transport planner.
Every response cites its source — a _source block with the authority, edition, licence where held, and a verification status an agent can read — and the tools are deterministic, not generated answers. Reference only: never filing, booking, or legal advice, and results state when human review is required (validate is structural check-digit validation only; a clean ics2_check is not ENS acceptance; emissions figures are estimates, not audited reports).
Since **2.11.0**, every tool also declares a typed outputSchema and returns structuredContent — the FreightUtils v1 response envelope: the answer under result, plus confidence, normalized_input, warnings, _source and a ready-to-use citation. The legacy flat JSON text channel is unchanged (byte-identical), so existing text-parsing consumers are unaffected.
**Website:** https://www.freightutils.com
**API Docs:** https://www.freightutils.com/api-docs
---
Tools (25)
Calculators
| Tool | Description |
|------|-------------|
| ldm_calculator | Loading metres for European and US road trailers |
| cbm_calculator | Cubic metres for sea freight |
| chargeable_weight_calculator | Air freight chargeable weight (volumetric vs actual) |
| pallet_fitting_calculator | Box-on-pallet optimisation with rotation |
| container_lookup | ISO container specs (10 types) and loading calculation |
| unit_converter | Weight, volume, length, and freight-specific conversions |
| consignment_calculator | Multi-item CBM, LDM, volumetric & mode-specific chargeable weight (sea/air/road) + advisory flags |
| emissions_calculator | Freight CO2e via the ISO 14083 / GLEC distance-based method — open DEFRA/EPA/ADEME factors (WTW + TTW); use actual gross mass (not chargeable/volumetric); result carries empty_running + representativeness (sea/air = low) + a summary |
Dangerous Goods (ADR)
| Tool | Description |
|------|-------------|
| adr_lookup | 2,939 UNECE ADR 2025 entries |
| adr_exemption_calculator | ADR 1.1.3.6 small load exemption check |
| adr_lq_eq_check | Limited and Excepted Quantity eligibility |
Some UN numbers have more than one ADR Table A row (packing groups, concentration bands). When a bare UN number matches rows that give different answers, the ADR tools never pick one: they withhold the verdict and return the candidate rows, and you pin one with packing_group or variant_index. The rules, with worked cases (UN 1789, UN 1790 PG I, UN 2215 PG III): the ADR 1.1.3.6 calculator in the API docs.
Customs & Tariff
| Tool | Description |
|------|-------------|
| hs_code_lookup | 6,940 Harmonized System tariff codes (HS 2022) |
| uk_duty_calculator | UK import duty and VAT (live GOV.UK Trade Tariff data) |
| incoterms_lookup | Incoterms 2020 — all 11 rules with risk/cost transfer points |
| ics2_check | Flag EU ICS2 unacceptable goods-description terms (stop-words) before filing an ENS — reference only |
Reference Data
| Tool | Description |
|------|-------------|
| resolve_reference | Resolve any freight identifier ("176", "UN1845", "NLRTM", "FOB") to typed, ranked, cited candidates when its type is unknown |
| airline_lookup | 6,356 airlines with IATA/ICAO codes and AWB prefixes |
| unlocode_lookup | 116,232+ UN/LOCODE transport locations |