FreightUtils MCP Server — Claude Code MCP server
A reference and calculation layer for freight: your agent works out chargeable weight, LDM, duty and ADR eligibility, with a source citation on every answer.
claude mcp add --transport http freightutils https://www.freightutils.com/api/mcpWhat FreightUtils MCP Server does
The server exposes 25 tools spanning road, air and sea. Calculators cover loading metres, cubic metres, air chargeable weight, box-on-pallet fitting, ISO container specs, unit conversion and a consignment calculator that handles multi-item CBM, LDM and mode-specific chargeable weight. emissions_calculator returns CO2e using the ISO 14083 / GLEC distance-based method with open DEFRA, EPA and ADEME factors.
Dangerous goods and customs sit in their own group. adr_lookup searches 2,939 UNECE ADR 2025 entries, adr_exemption_calculator checks the 1.1.3.6 small load exemption, and adr_lq_eq_check covers Limited and Excepted Quantities. Tariff work runs through hs_code_lookup (6,940 HS 2022 codes), uk_duty_calculator on live GOV.UK Trade Tariff data and incoterms_lookup. Reference tools resolve airlines, airports, UN/LOCODE locations and ULD types; validate scans free text for ISO 6346 containers, AWB and IMO numbers and checks their check digits.
Answers are deterministic and carry a _source block naming the authority, edition, licence and verification status. This is reference material, not filing or legal advice: a clean ics2_check does not mean an ENS was accepted, and validate only does structural check-digit work. Anonymous calls are capped at 25 requests per day per IP, so steady use needs a key in FREIGHTUTILS_API_KEY — the package reads it from process.env and sends Authorization: Bearer <key> with each request.
What it helps with
- work out loading metres for a European or US trailer
- compare volumetric and actual weight for an air shipment
- check whether a consignment qualifies for the ADR 1.1.3.6 small load exemption
- find the HS code and estimate UK import duty and VAT
- catch container, AWB and IMO numbers with a bad check digit in a booking line
Example prompts for the agent
- Calculate chargeable weight for a 120×80×100 cm box at 45 kg, air freight
- Check whether UN 1789 can ship as a small load under ADR
- Look up the HS 2022 code for a coffee grinder and estimate UK import duty
How to install FreightUtils MCP Server
1Platform CLI: remote server
claude mcp add --transport http freightutils https://www.freightutils.com/api/mcp2Platform CLI
claude mcp add freightutils-mcp-server -- npx -y freightutils-mcp1Platform CLI: remote server
codex mcp add freightutils-mcp-server --url https://www.freightutils.com/api/mcp2Platform CLI
codex mcp add freightutils-mcp-server -- npx -y freightutils-mcpConfig file
{
"mcpServers": {
"freightutils-mcp-server": {
"url": "https://www.freightutils.com/api/mcp"
}
}
}{
"mcpServers": {
"freightutils-mcp-server": {
"command": "npx",
"args": [
"-y",
"freightutils-mcp"
]
}
}
}Config file
{
"servers": {
"freightutils-mcp-server": {
"type": "http",
"url": "https://www.freightutils.com/api/mcp"
}
}
}{
"servers": {
"freightutils-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"freightutils-mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http freightutils-mcp-server https://www.freightutils.com/api/mcp2Platform CLI
gemini mcp add freightutils-mcp-server npx -y freightutils-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about FreightUtils MCP Server
How do I install FreightUtils MCP Server in Claude Code?
Run claude mcp add --transport http freightutils https://www.freightutils.com/api/mcp to add the remote server. For a local npm process instead, use claude mcp add freightutils-mcp-server -- npx -y freightutils-mcp.
What does FreightUtils MCP Server do?
It gives an agent 25 freight tools: LDM, CBM, chargeable weight, container specs, ADR lookups, HS codes, duty, Incoterms, airports and UN/LOCODE. Every answer comes with a citation to its source.
Do I need an API key?
Anonymous calls work without one, capped at 25 requests per day per IP. Set FREIGHTUTILS_API_KEY in the environment running the server for a higher limit.
