# FreightUtils — neutral freight reference + validation layer for AI agents

> FreightUtils — neutral freight reference + validation layer for AI agents. Every response cites its source: authority, edition, licence, last-verified date. Deterministic tools, not generated answers. Reference only — never filing, booking, or legal advice; results state when human review is required.

Authoritative 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, UN/LOCODE, OurAirports). Neutral by design: no freight to sell, no carrier to push. 23 tools · 23 REST endpoints · 24 MCP tools. Built by a UK ADR-certified freight transport planner.

## Connect

- **MCP (Streamable HTTP):** `https://www.freightutils.com/api/mcp` — the 24 MCP tools for AI agents (legacy alias: `/api/mcp/mcp`).
- **MCP (stdio):** npm package `freightutils-mcp` — for Claude Desktop / Cursor / Cline / local agents (`npx freightutils-mcp`). Version-agnostic — always resolves the latest published release.
- **REST:** base `https://www.freightutils.com/api` — 23 endpoints, JSON, CORS-enabled, no auth for anonymous use. OpenAPI 3.1 spec: https://www.freightutils.com/openapi.json
- **Custom GPT:** https://chatgpt.com/g/g-69fb8fdb0a5c819182c73f8d224cc3d0 — the FreightUtils GPT on the OpenAI GPT Store (backed by the same OpenAPI spec).
- **API key (optional):** `POST https://www.freightutils.com/api/keys/register`, then send the `x-api-key: <key>` header. Anonymous 25 requests/day per IP · free key 100 requests/day · Pro 50,000 requests/month (£19/mo).

## Tools

Each tool is a deterministic REST endpoint (and an MCP tool of the same capability) returning JSON with a `_source` citation. Listed as the capability an agent searches for.

### Freight calculators

- [LDM Calculator](https://www.freightutils.com/ldm) — `GET /api/ldm` — loading metres for road trailers: pallet presets (euro / uk / half / quarter) or custom dimensions, EU + US vehicles, stacking, utilisation + fit check.
- [CBM Calculator](https://www.freightutils.com/cbm) — `GET /api/cbm` — cubic metres for sea + air freight, with cubic-feet / litres / container-fill equivalents.
- [Chargeable Weight](https://www.freightutils.com/chargeable-weight) — `GET /api/chargeable-weight` — air / sea chargeable weight: volumetric vs actual, settable IATA divisor (default 6000).
- [Pallet Fitting](https://www.freightutils.com/pallet) — `GET /api/pallet` — how many boxes fit a pallet: layers, 90° rotation, height + weight limits.
- [Container Capacity](https://www.freightutils.com/containers) — `GET /api/containers` — ISO 668 / 1496 specs for 10 container types + box-loading calculation.
- [Unit Converter](https://www.freightutils.com/convert) — `GET /api/convert` — freight weight / volume / length conversions, including CBM → chargeable kg and CBM → freight tonnes.
- [Consignment Calculator](https://www.freightutils.com/consignment-calculator) — `POST /api/consignment` — multi-item mixed consignment: per-line + grand-total CBM, LDM, volumetric and mode-specific chargeable weight (sea / air / road) + advisory flags.
- [Emissions Calculator](https://www.freightutils.com/emissions) — `GET /api/emissions` — ISO 14083 / GLEC distance-based CO2e estimate; returns the exact factor + authority + edition (DEFRA 2026 / EPA / ADEME), WTW + TTW, and flags low representativeness (sea / air). Estimate, not an audited report.

### Dangerous goods (ADR 2025, UNECE)

- [ADR Lookup](https://www.freightutils.com/adr) — `GET /api/adr` — UN number → proper shipping name, class, packing group, tunnel code, LQ/EQ, special provisions (ADR 2025, UNECE).
- [ADR Exemption Calculator](https://www.freightutils.com/adr-calculator) — `GET /api/adr-calculator` — ADR 1.1.3.6 transport-category points vs the 1,000-point threshold (single or mixed load).
- [ADR LQ/EQ Check](https://www.freightutils.com/adr/lq-eq-checker) — `POST /api/adr/lq-check` — Limited Quantity (3.4) / Excepted Quantity (3.5) eligibility for one or more UN numbers.

### Customs & trade

- [HS Code Lookup](https://www.freightutils.com/hs) — `GET /api/hs` — Harmonized System tariff codes (HS 2022, WCO): search by product description or code.
- [Incoterms 2020](https://www.freightutils.com/incoterms) — `GET /api/incoterms` — all 11 rules with risk / cost transfer points; any-mode vs sea-only.
- [UK Duty & VAT](https://www.freightutils.com/duty) — `POST /api/duty` — UK import duty + VAT estimate on live GOV.UK Trade Tariff data (CIF basis, preference rates).
- [ICS2 Stop-Words Checker](https://www.freightutils.com/ics2-check) — `GET /api/ics2-check` — flags EU ICS2 stop-words in an ENS goods description (EU CIRCABC list, in-force version). Reference only — a clean result ≠ acceptance.

### Reference data

- [Airline Codes & AWB Prefixes](https://www.freightutils.com/airlines) — `GET /api/airlines` — airline by IATA / ICAO code, AWB prefix, callsign or country (IATA-regulated prefixes).
- [UN/LOCODE Lookup](https://www.freightutils.com/unlocode) — `GET /api/unlocode` — UN/LOCODE transport locations (ports, airports, rail, road, ICDs) by name, code, country or function.
- [Airport Code Lookup](https://www.freightutils.com/airports) — `GET /api/airports` — airport by IATA / ICAO code, name or city (OurAirports, public domain) → full record incl. coordinates and elevation.
- [ULD Types](https://www.freightutils.com/uld) — `GET /api/uld` — air-cargo ULD specs (AKE / LD3, PMC, …): dimensions, weights, aircraft compatibility, deck position.
- [Vehicle & Trailer Types](https://www.freightutils.com/vehicles) — `GET /api/vehicles` — road freight vehicles / trailers (EU + US): internal dimensions, payload, pallet capacity.
- [Identifier Validator](https://www.freightutils.com/validate) — `GET /api/validate` — paste ANY text (a booking line, an email) and it finds + check-digit-validates every ISO 6346 container, IATA AWB, and IMO number in it; or validate a single identifier by type. Structural (check-digit) validation — not a registry lookup.

### API / MCP-only (no dedicated page)

- Shipment Summary — `POST /api/shipment/summary` — composite: chains CBM + chargeable weight + LDM + ADR compliance + UK duty in one call, per transport mode.
- Nearest Airport — `GET /api/nearest-airport` — nearest airports to a caller-provided latitude / longitude by great-circle distance (coordinates are input only, never stored or logged).
- `get_subscribe_link` (MCP only) — returns the FreightUtils Pro upgrade URL + tier metadata; agents hand the URL to the user and never attempt checkout.

## Agent-safety contract

- **Every response cites its source.** A `_source` block on every REST + MCP response carries the authority, edition/version, source URL, licence and — for computed tools — the method; emission factors also carry a `last_verified` date. Datasets still finishing a provenance audit carry `provenance_status: "pending-verification"` and assert no licence.
- **Edition-aware.** Reference data names its edition (ADR 2025, HS 2022, Incoterms 2020, ICS2 in-force list date) so an agent can tell the user exactly which version it answered from.
- **Open-data licensing.** ADR 2025/UNECE, HS 2022/WCO (UN Comtrade PDDL), UN/LOCODE, GOV.UK Trade Tariff (OGL v3.0), OurAirports (public domain); emission factors DEFRA (OGL v3.0) / EPA (US-Gov public domain) / ADEME (Licence Ouverte). Licensed source texts (IATA / IMDG) are never reproduced.
- **Explicit boundaries — what a clean/valid result does NOT mean:**
  - `validate` is **structural**: a valid check digit means the identifier is well-formed, NOT that the container / shipment / vessel exists or is active. It is not a registry or tracking lookup.
  - `ics2_check` clean means **no listed stop-word found**, NOT that an ENS will be accepted (the list is non-exhaustive and dynamic). It is not an ENS filing or a compliance determination.
  - `emissions_calculator` returns a **best-effort estimate** from open factors, NOT an audited carbon report; sea / air are low-representativeness screening defaults.
  - Reference and calculation only — never filing, booking, or legal advice. Results state when human review is required.

## Reference guides

- [ADR Tunnel Codes](https://www.freightutils.com/adr/tunnel-codes) · [ADR Limited Quantities](https://www.freightutils.com/adr/limited-quantities) · [ADR 2025 Changes](https://www.freightutils.com/adr/changes-2025) · [ADR Training Guide](https://www.freightutils.com/adr/training-guide)

## Platform

- [API Documentation](https://www.freightutils.com/api-docs): the 23 REST endpoints, MCP setup, and worked examples. JSON, CORS, no auth for anonymous use.
- [OpenAPI 3.1 Specification](https://www.freightutils.com/openapi.json): machine-readable spec — OpenAI Custom GPT Actions, Postman, Swagger.
- [Playground](https://www.freightutils.com/playground): try every endpoint live in the browser.
- [Pricing](https://www.freightutils.com/pricing): anonymous 25/day, free key 100/day, Pro £19/month for 50,000/month.
- [Long-form index (llms-full.txt)](https://www.freightutils.com/llms-full.txt) · [Changelog](https://www.freightutils.com/changelog) · [Status](https://www.freightutils.com/status)
- [npm: freightutils-mcp](https://www.npmjs.com/package/freightutils-mcp) · [npm: n8n-nodes-freightutils](https://www.npmjs.com/package/n8n-nodes-freightutils)

## About

- [About FreightUtils](https://www.freightutils.com/about): built by an ADR-certified UK freight transport planner.
- [For IT Departments](https://www.freightutils.com/for-it): hostnames, security posture, no-PII summary for whitelisting reviews.
- [Privacy Policy](https://www.freightutils.com/privacy) · [Terms of Service](https://www.freightutils.com/terms) · [Data Processing Agreement](https://www.freightutils.com/dpa)

## Optional

- [Roadmap](https://www.freightutils.com/roadmap) · [API Versioning Policy](https://www.freightutils.com/docs/versioning) · [Deprecation Policy](https://www.freightutils.com/docs/deprecation)