Freightutils Mcp

Created By
SoapyRED2 days ago
Overview

FreightUtils MCP Server

npm version License: MIT FreightUtils MCP server

A Model Context Protocol server that gives AI agents access to 18 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 (18)

Calculators

ToolDescription
ldm_calculatorLoading metres for European and US road trailers
cbm_calculatorCubic metres for sea freight
chargeable_weight_calculatorAir freight chargeable weight (volumetric vs actual)
pallet_fitting_calculatorBox-on-pallet optimisation with rotation
container_lookupISO container specs (10 types) and loading calculation
unit_converterWeight, volume, length, and freight-specific conversions
consignment_calculatorMulti-item CBM, weight, LDM, chargeable weight

Dangerous Goods (ADR)

ToolDescription
adr_lookup2,939 UNECE ADR 2025 entries
adr_exemption_calculatorADR 1.1.3.6 small load exemption check
adr_lq_eq_checkLimited and Excepted Quantity eligibility

Customs & Tariff

ToolDescription
hs_code_lookup6,940 Harmonized System tariff codes (HS 2022)
uk_duty_calculatorUK import duty and VAT (live GOV.UK Trade Tariff data)
incoterms_lookupIncoterms 2020 — all 11 rules with risk/cost transfer points

Reference Data

ToolDescription
airline_lookup6,352 airlines with IATA/ICAO codes and AWB prefixes
unlocode_lookup116,129+ UN/LOCODE transport locations
uld_lookup15 air cargo ULD types (LD3, PMC, etc.)
vehicle_lookup17 road freight vehicles and trailers

Composite

ToolDescription
shipment_summaryChains CBM + weight + LDM + ADR + duty in one call

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.


License

MIT — see LICENSE.

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

Server Config

{
  "mcpServers": {
    "freightutils": {
      "url": "https://www.freightutils.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_FREIGHTUTILS_API_KEY>"
      }
    }
  }
}
Project Info
Created At
2 days ago
Updated At
2 days ago
Author Name
SoapyRED
Star
-
Language
-
License
-
Category
Tags

Recommend Servers

View All