Log inSubmit server
Freightutils MCP logo

Freightutils MCP

by SoapyRED

Freight planning MCP tools for shipment calculations, ADR checks, customs references, identifiers, locations, and transport equipment.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Freightutils MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "soapyred-freightutils-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "freightutils-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 25 tools correctly (26d ago).

Overview

SoapyRED/freightutils-mcp MCP server exposes freight calculation, lookup, validation, and reference tools through MCP. It covers road, air, and sea workflows, including CBM, chargeable weight, LDM, ADR dangerous goods, HS codes, UK duty estimates, locations, equipment, and identifiers. The npm package runs locally over stdio and calls FreightUtils REST endpoints; a remote MCP endpoint is also available. Reach for it when an agent needs deterministic freight calculations or source-cited logistics reference data rather than booking, tracking, or compliance decisions.

Use cases

  • Calculate shipment volume and mode-specific chargeable weight
  • Check ADR dangerous-goods quantities and exemption points
  • Estimate UK import duty and VAT from tariff data
  • Resolve freight identifiers and validate check digits
  • Find transport locations, vehicles, containers, or ULD specifications

Key features

  • CBM, LDM, pallet, weight, consignment, and emissions calculators
  • ADR 2025 lookup and quantity checks
  • HS code, UK tariff, Incoterms, and ICS2 references
  • Airline, airport, UN/LOCODE, vehicle, container, and ULD lookups
  • Freight identifier resolution and check-digit validation
  • Source metadata, confidence fields, and citations

Tools25

What Freightutils MCP lets your agent do. Expand a tool for its parameters.

Verified live~18.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

17/18 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · freightutils-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
npm downloads2.1kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed25Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Freightutils MCP works

What SoapyRED/freightutils-mcp MCP server does

SoapyRED/freightutils-mcp MCP server gives agents a set of freight-planning and logistics-reference operations for road, air, and sea shipments.

Calculation tools handle cubic metres, air chargeable weight, loading metres, pallet fitting, unit conversions, multi-line consignments, and emissions estimates. Reference tools cover ADR 2025 entries, HS 2022 codes, Incoterms 2020, UK tariff data, airlines, airports, UN/LOCODE locations, containers, ULDs, and vehicles. Validation and resolution tools can inspect container, AWB, IMO, and other freight identifiers.

Results use the FreightUtils response envelope. Depending on the tool, responses include a result object, confidence information, normalized input, warnings, source metadata, and citations. The calculations are deterministic for identical inputs, while reference and fuzzy-search tools report match or provenance information where applicable.

How it works

The local package communicates with FreightUtils API endpoints. Anonymous requests work without a credential and are limited to 25 requests per day per IP. Calls that exceed the limit return rate-limit information, including a retry interval; the get_subscribe_link tool provides the upgrade URL. A free or Pro API key can raise the available limits, with the key sent as a bearer token by the package.

The tools are reference and planning aids, not booking or filing systems. ADR, customs, Incoterms, ICS2, emissions, and equipment outputs include important boundaries: they do not replace legal advice, customs rulings, carrier confirmation, operational verification, or audited reporting. Several datasets identify pending or limited provenance, so operationally important values should be checked with the relevant authority or carrier.

Setup and configuration

Install the npm package with Node.js 18 or newer and add it to an MCP client configuration using the stdio command. For Claude Desktop or Claude Code, the README uses npx freightutils-mcp; when running non-interactively, use npx -y freightutils-mcp to avoid an installation prompt. Fully restart the MCP client after changing its configuration.

Set FREIGHTUTILS_API_KEY in the server environment when using a free or Pro API key. Leaving it unset preserves anonymous access. A remote client can connect to https://www.freightutils.com/api/mcp instead of running the package locally.

Tools and capabilities

  • Calculate CBM, cubic feet, litres, chargeable air weight, LDM, pallet fit, freight conversions, consignment totals, and transport emissions.
  • Look up ADR dangerous-goods data and evaluate ADR 1.1.3.6, Limited Quantity, and Excepted Quantity cases.
  • Search HS codes, estimate UK duty and VAT using live tariff data, inspect Incoterms, and check ICS2 description stop words.
  • Search airlines, airports, UN/LOCODEs, vehicles, containers, and air ULD specifications.
  • Resolve ambiguous freight identifiers and validate container, AWB, and IMO check digits.

Limitations and notes

The SoapyRED/freightutils-mcp MCP server does not file ENS declarations, book freight, track shipments, or establish regulatory compliance. Calculators use stated assumptions such as dimensions, divisors, and vehicle conventions; geometric packing does not model every loading or securing constraint. validate checks identifier structure only, and a clean ICS2 result does not mean an ENS will be accepted. Emissions are estimates based on published factors, while equipment and reference datasets may require confirmation against current carrier, authority, or tariff sources.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Freightutils MCP

Install it through npm with Node.js 18 or newer and configure the stdio command `npx -y freightutils-mcp` in the MCP client. The README also provides a remote endpoint at `https://www.freightutils.com/api/mcp`.

Yes. The README provides a Claude Desktop configuration using the `freightutils-mcp` npm package and says to fully quit and relaunch the client after editing its configuration.

No. Anonymous calls work without a key and are limited to 25 requests per day per IP. `FREIGHTUTILS_API_KEY` is available for users with a free or Pro FreightUtils key.

It supports CBM, air chargeable weight, loading metres, pallet fitting, unit conversion, mixed-consignment calculations, shipment summaries, and emissions estimates.

No. Its ADR, customs, ICS2, Incoterms, emissions, and equipment results are reference or planning outputs and must be verified against current authorities, carriers, or other responsible sources.

Related MCP servers

All in Travel & Transportation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFreightutils MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/soapyred-freightutils-mcp?style=directory)](https://allmcps.com/mcp/soapyred-freightutils-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/soapyred-freightutils-mcp"><img src="https://allmcps.com/api/badge/soapyred-freightutils-mcp?style=directory" alt="Freightutils MCP on AllMCPs" /></a>