FreightUtils MCP Server

A Model Context Protocol server that gives AI agents access to 19 freight calculation and reference tools, covering road, air, and sea freight.

Built by an ADR-certified freight transport planner for AI agents, developers, and freight professionals.

Website: https://www.freightutils.com API Docs: https://www.freightutils.com/api-docs

---

Tools (19)

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, weight, LDM, chargeable weight

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

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

Reference Data

Tool	Description
airline_lookup	6,352 airlines with IATA/ICAO codes and AWB prefixes
unlocode_lookup	116,129+ UN/LOCODE transport locations
uld_lookup	15 air cargo ULD types (LD3, PMC, etc.)
vehicle_lookup	17 road freight vehicles and trailers

Composite

Tool	Description
shipment_summary	Chains CBM + weight + LDM + ADR + duty in one call

Subscription

Tool	Description
get_subscribe_link	URL to upgrade to FreightUtils Pro (50,000/month at £19/mo)

---

Installation

Claude Desktop / Claude Code (stdio)

Add to your MCP config (claude_desktop_config.json or .claude/settings.json):

{
  "mcpServers": {
    "freightutils": {
      "command": "npx",
      "args": ["freightutils-mcp"]
    }
  }
}

Remote HTTP / SSE

If your MCP client supports remote servers, use the canonical URL:

https://www.freightutils.com/api/mcp

The older URL https://www.freightutils.com/api/mcp/mcp still works for backwards compatibility with existing clients.

No authentication required for basic usage.

---

Rate Limits

All tools call the free FreightUtils API:

• Anonymous: 25 requests/day per IP
• Free API key: 100 requests/day (register at https://www.freightutils.com)
• Pro: 50,000 requests/month at £19/month

---

Example Prompts

Once connected, your AI agent can:

• "Calculate CBM for a box 120cm × 80cm × 100cm, 24 pieces"
• "Look up UN 1203 in the ADR database"
• "Check if 200L of petrol qualifies for ADR 1.1.3.6 exemption"
• "Find the HS code for lithium batteries"
• "What does FOB mean in shipping?"
• "How many boxes of 40×30×25cm fit on a euro pallet?"
• "Calculate loading metres for 26 euro pallets on an artic trailer"
• "What's the UK import duty on laptops from China?"

---

Data Sources

• ADR 2025 — UNECE (licensed from Labeline.com)
• HS 2022 — UN Comtrade (PDDL)
• Airlines — public IATA/ICAO data, cross-referenced
• UN/LOCODE — UNECE
• UK Duty — live GOV.UK Trade Tariff API
• Containers/ULD/Vehicles — ISO, IATA, and industry-standard specifications

---

Changelog

1.0.8 — 2026-04-23 (hotfix)

• Critical fix: revert list_prompts / list_resources stub handlers introduced in 1.0.7. The raw SDK asserts the corresponding capability must be declared before setRequestHandler is called — 1.0.7 threw Server does not support prompts at startup, crashing the MCP server on every run. 1.0.8 removes the stubs and restores boot.
• Server identity bumped: version: '1.0.7' → '1.0.8'.
• No other changes. 18 tools, annotations, shipment_summary descriptions, and smithery.yaml from 1.0.7 are preserved.

1.0.7 — 2026-04-22

• Add smithery.yaml with empty configSchema (Smithery Quality Score: config UX +25).
• Add read-only annotations to all 18 tools (readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false) with human-readable title (+7).
• Add missing parameter .describe(...) text to shipment_summary (+1).
• Add stub list_prompts / list_resources handlers so probes return { prompts: [] } / { resources: [] } instead of -32601 Method not found (+5).
• Fix server identity: name: 'FreightUtils' → 'freightutils-mcp', version: '1.0.0' → '1.0.7'.
• No breaking changes. Same 18 tools, same names, same behaviour.

1.0.6 — 2026-04-22

• Security: bump @modelcontextprotocol/sdk to 1.26.0 to patch CVE-2026-25536 (cross-client data leak via shared transport/server instance reuse). See GHSA-345p-7cg4-v4c7.
• No user-facing API changes. Same 18 tools.

---

Other ways to use FreightUtils

FreightUtils ships across multiple distribution surfaces. Pick the one that fits how you work:

• Website — interactive tools at freightutils.com
• REST API — 19 endpoints, free tier (100/day) and Pro tier (50K/month, £19/mo). API docs
• MCP server — for LLM agents and AI tooling. npm: freightutils-mcp · MCP Registry
• n8n custom node — for workflow automation. npm: n8n-nodes-freightutils

Same data, same compliance reference set (ADR 2025, HS 2022, IATA-regulated airline prefixes), every surface kept in sync.

---

License

MIT — see LICENSE.

Built by Marius Cristoiu, ADR-certified freight transport planner.