Freightutils MCP Server

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

Dangerous Goods (ADR)

Customs & Tariff

Reference Data

Composite

---

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.

---

Links

• Main site: https://www.freightutils.com
• API documentation: https://www.freightutils.com/api-docs
• GitHub (this repo): https://github.com/SoapyRED/freightutils-mcp
• npm: https://www.npmjs.com/package/freightutils-mcp
• Issues: https://github.com/SoapyRED/freightutils-mcp/issues

---

License

MIT — see LICENSE.

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