FreightUtils MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
|
| 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:
Use this tool when you need to:
|
| 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:
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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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