Skip to main content
Glama
SoapyRED

FreightUtils MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
cbm_calculatorA

Calculate cubic metres (CBM) for a shipment.

CBM is the standard volume unit in international shipping. One CBM = 1m x 1m x 1m = 1,000 litres. Ocean freight carriers price per "freight tonne" (1 CBM or 1,000 kg, whichever is greater).

Use this tool when you need to:

  • Calculate the volume of a shipment for sea freight quoting

  • Convert dimensions to CBM, cubic feet, or litres

  • Determine freight tonnes for ocean shipping

Input dimensions in centimetres. Specify pieces to get total volume for multiple identical items.

chargeable_weight_calculatorA

Calculate air freight chargeable weight (volumetric vs actual).

Airlines charge by "chargeable weight" — the greater of actual weight or volumetric weight. The IATA standard volumetric factor is 6,000 (1 CBM = 166.67 kg). Some carriers use different factors (e.g., 5,000 for DHL).

Use this tool when you need to:

  • Quote air freight shipments

  • Determine if a shipment is charged by volume or weight

  • Compare volumetric factors across carriers

A ratio > 1.0 means the shipment is "volumetric" (light for its size). A ratio < 1.0 means it's "heavy" (dense cargo).

ldm_calculatorA

Calculate loading metres (LDM) for road freight shipments.

LDM measures how much of a trailer's length a pallet load occupies. European trailers are 13.6m long and 2.4m wide. LDM = (pallet_length x pallet_width x quantity) / (trailer_width x stack_factor).

Use this tool when you need to:

  • Quote European road freight (FTL/LTL)

  • Calculate trailer utilisation percentage

  • Check if pallets fit within vehicle weight/space limits

Supports pallet presets (euro, uk, half, quarter) or custom dimensions. Supports vehicles: artic (13.6m), rigid10, rigid75, luton, or custom length.

adr_lookupA

Look up dangerous goods (hazmat) information from the ADR 2025 database.

ADR is the European agreement for international carriage of dangerous goods by road. This tool searches 2,939 entries covering all 9 hazard classes.

Use this tool when you need to:

  • Find the hazard class, packing group, and labels for a UN number

  • Search dangerous goods by name (e.g., "petrol", "lithium batteries")

  • Get tunnel restriction codes and transport categories

  • Check limited quantity allowances

Provide a UN number for exact lookup, or a search term for name-based search.

adr_exemption_calculatorA

Calculate ADR 1.1.3.6 exemption thresholds for mixed hazardous loads.

ADR 1.1.3.6 allows reduced requirements when the total "points" of a mixed load are 1,000 or below. Each substance is assigned to a transport category (0-4) with a multiplier. Points = quantity x multiplier.

Use this tool when you need to:

  • Check if a load of dangerous goods qualifies for the small load exemption

  • Calculate total ADR points for a mixed load

  • Determine if full ADR compliance is required

For single substances, provide un_number + quantity. For mixed loads, use the items array.

adr_lq_eq_checkA

Check if dangerous goods qualify for ADR Limited Quantity (LQ) or Excepted Quantity (EQ) exemptions.

ADR 3.4 (Limited Quantities) allows reduced requirements for small quantities packed in inner packagings below a per-substance maximum. ADR 3.5 (Excepted Quantities, codes E1–E5) applies to very small quantities with even stricter per-inner limits.

Use this tool when you need to:

  • Check whether one or more items qualify for LQ transport (ADR 3.4)

  • Check whether one or more items qualify for EQ transport (ADR 3.5)

  • Work out the per-item LQ maximum or EQ code/limit for a UN number

  • Batch-check up to 20 items in a single call

Provide the mode ('lq' or 'eq') and an array of items with un_number, quantity, and unit. For EQ mode, optionally include inner_packaging_qty to validate the packaging arrangement.

airline_lookupA

Search 6,352 airlines by name, IATA/ICAO code, AWB prefix, or country.

Use this tool when you need to:

  • Find an airline's IATA code, ICAO code, or air waybill (AWB) prefix

  • Verify airline cargo capabilities

  • Look up airlines by country

AWB prefixes are 3-digit codes used on air waybills to identify the issuing carrier (e.g., 176 = Emirates).

container_lookupA

Get ISO shipping container specifications and calculate loading.

Covers 10 container types: 20ft standard, 40ft standard, 40ft high-cube, 20ft/40ft reefer, 20ft/40ft open-top, 20ft/40ft flat-rack, and 45ft high-cube.

Use this tool when you need to:

  • Get internal dimensions, capacity (CBM), and weight limits

  • Find how many euro/GMA pallets fit in a container

  • Calculate how many items of a given size fit inside

Provide a container type for specs. Add item dimensions (l, w, h in cm) to calculate loading.

hs_code_lookupA

Search 6,940 Harmonized System (HS) tariff codes.

HS codes are 6-digit international product classification codes used for customs declarations and duty calculations. The first 2 digits = chapter, 4 digits = heading, 6 digits = subheading.

Use this tool when you need to:

  • Find the HS code for a product (e.g., "laptop", "olive oil")

  • Get the tariff classification hierarchy (section → chapter → heading → subheading)

  • Browse HS sections (I through XXI)

Provide a search term for description-based search, or an exact HS code for detailed lookup.

incoterms_lookupA

Look up Incoterms 2020 trade rules.

Incoterms define who pays for what in international trade — transport, insurance, customs clearance, and risk transfer. There are 11 rules: 7 for any transport mode (EXW, FCA, CPT, CIP, DAP, DPU, DDP) and 4 for sea/inland waterway only (FAS, FOB, CFR, CIF).

Use this tool when you need to:

  • Explain what an Incoterm means (e.g., "What does FOB mean?")

  • Compare seller vs buyer responsibilities

  • Determine risk and cost transfer points

  • Check which Incoterms apply to sea freight vs any mode

pallet_fitting_calculatorA

Calculate how many boxes fit on a pallet (layers, rotation, weight limits).

This tool determines the optimal arrangement of identical boxes on a pallet, accounting for:

  • Layer-by-layer stacking up to the max height

  • 90-degree rotation to find the best fit

  • Weight capacity limits

  • Volume utilisation percentage

Use this tool when you need to:

  • Plan pallet loading for warehouse/shipping

  • Calculate total boxes per pallet

  • Check if weight limits will be reached before space runs out

unit_converterA

Convert between freight and logistics units.

Supports weight (kg, lbs, oz, tonnes, short_tons, long_tons), volume (cbm, cuft, cuin, litres, gal_us, gal_uk), length (cm, inches, m, feet, mm), and freight-specific conversions (cbm→chargeable_kg, cbm→freight_tonnes).

Use this tool when you need to:

  • Convert between metric and imperial units

  • Calculate freight tonnes from CBM (1 CBM = 1 freight tonne = 1,000 kg)

  • Convert CBM to chargeable weight for air freight quoting

Note: Short tons (US) = 2,000 lbs. Long tons (UK) = 2,240 lbs. Metric tonnes = 2,204.6 lbs.

consignment_calculatorA

Calculate total CBM, loading metres (LDM), volumetric and mode-specific chargeable weight for a multi-item mixed consignment — per-line and grand totals, plus objective advisory flags.

Provide a transport mode (sea | air | road) and either "lines" (canonical: each line has quantity, dims {l,w,h,unit}, weight {value,unit}, and optional description / hs_code / un_number / stackable) or the legacy flat "items" array (dimensions in cm, weight in kg). Air uses an IATA volumetric divisor (default 6000, settable via options.air_volumetric_divisor). Optionally pass options.container_number / options.awb_number for a check-digit sanity flag.

Flags are advisory only — implausible density, mode/option mismatch, dangerous-goods presence by UN number against the ADR 2025 reference, and container/AWB check-digit validity. They never state that a shipment is permitted or compliant. Best-effort deterministic calculation and reference data only; not regulatory, customs, or dangerous-goods compliance advice — you remain responsible for classification, documentation and carrier acceptance. Canonical schema: https://www.freightutils.com/schema/consignment.v1.json

unlocode_lookupA

Search 116,129 UN/LOCODE transport locations worldwide.

UN/LOCODE identifies ports, airports, rail terminals, inland depots, and border crossings. Each code is 5 characters: 2-letter country code + 3-character location (e.g., GBLHR = London Heathrow, NLRTM = Rotterdam).

Use this tool when you need to:

  • Find a port, airport, or terminal by name

  • Look up a specific UN/LOCODE

  • Filter locations by country or function type (port, airport, rail, road, icd, border)

uk_duty_calculatorA

Estimate UK import duty and VAT for any commodity code.

Uses live GOV.UK Trade Tariff data. Calculates CIF value from goods value + freight + insurance, applies the appropriate duty rate, then calculates VAT (standard 20%) on the duty-inclusive value.

Use this tool when you need to:

  • Estimate import costs for UK-bound shipments

  • Check duty rates for specific HS/commodity codes

  • Compare landed costs for different origin countries

  • Determine if preferential rates apply

shipment_summaryA

Composite endpoint — chains CBM, weight, LDM/volumetric/W&M, ADR compliance, and UK duty estimation into one response.

The flagship composite tool. Accepts multiple items with a transport mode and returns comprehensive calculations. Road mode includes LDM, pallet spaces, and vehicle suggestion. Air mode includes volumetric weight. Sea mode includes revenue tonnes and container suggestion. All modes include ADR compliance checks and UK duty estimates when HS codes and customs values are provided.

Use this tool when you need a complete shipment analysis in one call.

uld_lookupA

Look up air freight ULD (Unit Load Device) specifications.

15 types including AKE (LD3), PMC main deck pallet, temperature-controlled containers, and more. Returns dimensions, weights, usable volume, compatible aircraft, and deck position.

Use this tool when you need to:

  • Find ULD specs by IATA code (e.g., "AKE", "PMC")

  • Compare container vs pallet ULD types

  • Check which ULDs fit on lower deck vs main deck

  • Find aircraft-compatible ULDs

vehicle_lookupA

Look up road freight vehicle and trailer specifications.

17 types covering articulated trailers (curtainsider, mega, box, reefer, double-deck, flatbed, low-loader, US 53ft/48ft), rigid trucks (7.5T to 26T), and vans (Luton, Transit, Sprinter). Returns internal dimensions, payload limits, pallet capacity, and features.

Use this tool when you need to:

  • Find vehicle specs by type (e.g., "standard-curtainsider")

  • Compare EU vs US trailer dimensions

  • Determine pallet capacity for vehicle selection

  • Check payload limits for heavy shipments

emissions_calculatorA

Estimate freight transport greenhouse-gas emissions (kgCO2e) for a shipment leg, per ISO 14083:2023 / GLEC Framework v3.2: emissions = mass × distance × a published emission-intensity factor (kgCO2e/tonne-km).

Provide mass + distance_km + mode (road | rail | sea | air | inland_waterway); optionally choose sub_mode, region/authority (uk = DEFRA, us = EPA, fr = ADEME) and basis (wtw default, or ttw). Returns well-to-wheel AND tank-to-wheel emissions where the factor has both, the exact factor used (value, authority, edition), the tonne-km activity, and a _source citing BOTH the ISO method and the specific open factor.

Use when you need a carbon estimate for a shipment whose mass and distance are already known. Distinct from cbm_calculator / ldm_calculator / chargeable_weight_calculator (those size or bill a shipment; this one estimates its CO2e). Distance must be provided — this tool does NOT route, geocode, or compute distances. Best-effort reference estimate from open factors (DEFRA / EPA / ADEME) — NOT a verified or audited carbon report. IMPORTANT: pass ACTUAL GROSS MASS, not chargeable/volumetric weight (a common air-freight mistake — see mass_basis). The fleet-average factor already includes average empty running (see empty_running) — do NOT add your own empty-return leg. Sea and air are low-representativeness generic defaults: real emissions vary materially by vessel/aircraft type, load factor and routing (see representativeness + the result summary). An unknown mode/sub_mode/region returns available:false with the covered options, never a fabricated factor.

validateA

Validate and parse freight identifiers by their public check-digit algorithms: shipping container numbers (ISO 6346), air waybill (AWB) numbers (IATA modulus-7) and IMO ship identification numbers.

Two modes: pass text= to find and validate every identifier in it (e.g. a booking-email line), OR pass value= + type=<container|awb|imo> to validate one. Returns, per identifier found: type, the normalised form, valid (check-digit pass/fail), the expected vs actual check digit, and details (container → owner prefix + equipment category; AWB → airline prefix + the airline, resolved from the AWB-prefix dataset; IMO → the 7-digit number).

Use to confirm a container/AWB/IMO number is well-formed, or to extract identifiers from a freeform string. STRUCTURAL ONLY — a valid check digit means well-formed, NOT that the container/shipment/vessel exists or is active; not a registry/tracking lookup. Distinct from container_lookup (container TYPE specs) and airline_lookup (airline search); this checks an identifier's check digit and, for an AWB, names the operating airline.

ics2_checkA

Check a goods description against the official EU ICS2 stop-words list — terms the European Commission deems too vague/generic to be accepted in an entry summary declaration (ENS) goods-description field (data element 18 05 000 000).

Pass description=; returns the flagged terms (each with a note: standalone term = automatic rejection, embedded = make the description more specific), a clean boolean, a caveat, and a _source citing the EU list + legal basis.

Use to QA a goods description BEFORE filing an ENS — for customs/documentation teams, brokers, forwarders' documentation side, and agents building filing pipelines. STRICTLY a reference check: NOT an ENS filing, NOT a customs-compliance determination, NOT legal advice. The list is non-exhaustive and updated periodically; clean does NOT guarantee acceptance. No binary accepted/rejected verdict. Distinct from hs_code_lookup (commodity codes) and uk_duty_calculator (duty/VAT).

airport_lookupA

Look up an airport by IATA code (3 letters, e.g. "LHR"), ICAO code (4 chars, e.g. "EGLL"), or free-text name/city search (e.g. "heathrow"). Returns the full record: IATA + ICAO, name, type (large/medium/small/heliport/closed/seaplane), municipality, region, country, latitude/longitude and elevation. Provide one of iata, icao, or query; optional type filter. Ambiguous name searches return ranked candidates. Covers 85,555 airports worldwide (OurAirports, public domain, cross-checked vs OpenFlights + Wikidata). Use when an agent has an airport code or name and needs the airport's identity, location or codes. Distinct from airline_lookup (which searches CARRIERS / AWB prefixes, not airports) and unlocode_lookup (general UN/LOCODE transport locations of which airports are one function). Reference data only — not for navigation; verify current codes with IATA/ICAO.

nearest_airportA

Find the airports nearest to a caller-provided latitude/longitude, sorted by great-circle (haversine) distance with distance_km on each result. Inputs: latitude, longitude (required), optional radius_km, max_results (1-50, default 10) and type filter (e.g. large_airport only). Coordinates are INPUT only — nothing is stored or logged. Searches 85,555 airports (OurAirports, public domain). Use when an agent already holds a coordinate (a port, warehouse, city centre, or the user's location) and needs the closest airport(s). This tool does NOT geocode place names and does NOT compute routes — pass coordinates you already have. Distinct from airport_lookup (exact code / name lookup, no distance) and unlocode_lookup (named transport-location search).

get_subscribe_linkA

Get the URL where the user can subscribe to FreightUtils Pro for higher API limits.

Use this tool when:

  • The user asks how to upgrade or subscribe

  • The user hits a rate limit and asks how to get more requests

  • The user asks about pricing

Returns the subscription URL plus the tier/limit/price metadata. Agents must hand this URL to the user — DO NOT attempt to complete the subscription on the user's behalf.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SoapyRED/freightutils-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server