FreightUtils MCP Server
v2.27.0Neutral freight reference + validation layer for AI agents: ADR, HS, UN/LOCODE, freight math
Endpoint health
online- Last checked
- 11/20/2026, 5:15:39 AM
- Latency
- 317 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.SoapyRED%2Ffreightutils
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.SoapyRED/freightutils": {
"url": "https://www.freightutils.com/api/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
25 shown · authentication unknown
ADR Consignment Check
adr_consignment_check
One call on the consignment object for the ADR picture of a road load: the 1.1.3.6 small-load verdict, the limited / excepted quantity check of each line, the tunnel restriction code of the whole load against the tunnels on the route, each line's transport-document entry, mixed loading (7.5.2, with the foodstuffs precautions of 7.5.4), and the vehicle side — orange-coloured plates and placards (5.3), the documents, fire extinguishers and equipment on the transport unit (8.1), and driver training (8.2); and the UN packaging mark of each line (6.1.3.1). The rules are page-cited to the free UNECE ADR 2025 publication. For the 1.1.3.6 check alone use adr_exemption_calculator; LQ / EQ alone adr_lq_eq_check; a row's columns adr_lookup. Send lines[] (un_number, quantity {value, unit, basis} and, where they apply, packing_group / variant_index, packages with un_mark, inner_packaging) and optionally journey, vehicle and crew; journey.date is the default as_of, and an as_of that contradicts it is refused. A check whose input is not sent is conditional, the input named in missing_inputs — never assumed. status is pass | fail | conditional | insufficient_data; a relief that does not apply is not_applicable, not fail. edition ("2025" | "2027") and as_of choose the ADR edition; neither sent, ADR 2025 until 2027-01-01. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Not checked: whether the packaging kind is one the packing instruction allows, IBC / large-packaging marks, the vehicle approval of Part 9, the elevated temperature mark (5.3.3), handling and stowage (7.5.7). Not legal advice, verify against the current UNECE ADR text.
Schema valid · SHA-256 b7851f5c7c56…
View input schema
{ "type": "object", "properties": { "lines": { "minItems": 1, "maxItems": 50, "type": "array", "items": { "type": "object", "properties": { "description": { "description": "What the line is, at most 200 characters.", "type": "string", "maxLength": 200 }, "un_number": { "description": "UN number (\"1203\", \"UN1203\") or ID-prefixed air-only number (\"ID 8000\"); a line without one is not a dangerous-goods line.", "type": "string", "pattern": "^(?:(?:UN\\s?)?\\d{4}|ID\\s?\\d{4})$" }, "packing_group": { "description": "Packing group, to pin one ADR Table A row of a multi-row UN.", "type": "string", "enum": [ "I", "II", "III" ] }, "variant_index": { "description": "ADR Table A variant index (as adr_lookup returns it), to pin one row.", "type": "integer", "minimum": 0, "maximum": 1000 }, "quantity": { "description": "The dangerous-goods quantity (ADR 1.1.3.6.3).", "type": "object", "properties": { "value": { "description": "The dangerous-goods quantity for the whole line, all packages together; 0 = not carried.", "type": "number", "minimum": 0, "maximum": 1000000000 }, "unit": { "description": "L or kg, checked against the dimension ADR 1.1.3.6.3 counts.", "type": "string", "enum": [ "L", "kg" ] }, "basis": { "description": "\"net\" or \"gross\"; a gross mass on a mass-counted row is an upper bound.", "type": "string", "enum": [ "net", "gross" ] } }, "required": [ "value" ], "additionalProperties": false }, "packages": { "description": "The pieces; a line in packages is \"other carriage\" for the ADR 8.6.4 tunnel table.", "type": "object", "properties": { "count": { "type": "integer", "exclusiveMinimum": 0, "maximum": 100000 }, "type": { "type": "string", "maxLength": 40 }, "gross_kg": { "type": "number", "exclusiveMinimum": 0, "maximum": 1000000 }, "un_mark": { "description": "The UN packaging mark as printed (ADR 6.1.3.1), e.g. \"UN 4G/Y145/S/02/NL/VL823\".", "type": "string", "minLength": 1, "maxLength": 80 } }, "required": [ "count" ], "additionalProperties": false }, "hs_code": { "type": "string", "pattern": "^\\d{6,10}$" }, "value": { "type": "object", "properties": { "amount": { "type": "number", "minimum": 0, "maximum": 1000000000000 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount", "currency" ], "additionalProperties": false }, "dims": { "type": "object", "properties": { "l": { "type": "number", "exclusiveMinimum": 0, "maximum": 100000 }, "w": { "type": "number", "exclusiveMinimum": 0, "maximum": 100000 }, "h": { "type": "number", "exclusiveMinimum": 0, "maximum": 100000 }, "unit": { "type": "string", "enum": [ "mm", "cm", "m", "in" ] } }, "required": [ "l", "w", "h", "unit" ], "additionalProperties": false }, "stackable": { "type": "boolean" }, "icao_limited_quantity": { "description": "ID-prefixed line only: the packages are ICAO Technical Instructions limited quantities (3.4.8 mark / 3.4.10).", "type": "boolean" }, "inner_packaging": { "description": "The inner packaging, for the limited / excepted quantity check.", "type": "object", "properties": { "quantity": { "description": "The quantity in ONE inner packaging.", "type": "number", "exclusiveMinimum": 0, "maximum": 1000000 }, "unit": { "type": "string", "enum": [ "ml", "L", "g", "kg" ] }, "per_outer": { "description": "Inner packagings in one outer packaging (default 1) — the excepted-quantity outer limit.", "type": "integer", "minimum": 1, "maximum": 100000 }, "regime": { "description": "The exemption the line is meant to use (a stated regime that is missed fails); omitted, both are checked and a line that fits neither is not_applicable.", "type": "string", "enum": [ "lq", "eq" ] } }, "required": [ "quantity", "unit" ], "additionalProperties": false } }, "additionalProperties": false }, "description": "The lines of the load (1–50). Required." }, "journey": { "type": "object", "properties": { "origin": { "type": "string", "pattern": "^[A-Za-z]{2}(?:\\s?[A-Za-z2-9]{3})?$" }, "destination": { "type": "string", "pattern": "^[A-Za-z]{2}(?:\\s?[A-Za-z2-9]{3})?$" }, "date": { "description": "Date of carriage, YYYY-MM-DD — the default as_of.", "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "tunnels_on_route": { "description": "ADR tunnel categories on the route (A–E).", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E" ] } }, "mode": { "type": "string", "enum": [ "road", "air", "sea", "multimodal" ] } }, "additionalProperties": false }, "vehicle": { "description": "The vehicle-side inputs (ADR 5.3, 7.5.4, 8.1).", "type": "object", "properties": { "type": { "type": "string", "maxLength": 60 }, "max_mass_t": { "description": "The transport unit's maximum permissible mass, tonnes.", "type": "number", "exclusiveMinimum": 0, "maximum": 100 }, "axles": { "type": "integer", "minimum": 1, "maximum": 12 }, "foodstuffs_carried": { "description": "Foodstuffs or animal feeds are carried in the same vehicle or container (ADR 7.5.4).", "type": "boolean" }, "fire_extinguishers_kg": { "description": "Each portable fire extinguisher on board, kg (ADR 8.1.4).", "maxItems": 20, "type": "array", "items": { "type": "number", "exclusiveMinimum": 0, "maximum": 100 } }, "orange_plates_displayed": { "description": "The two orange-coloured plates are displayed.", "type": "boolean" }, "placards_displayed": { "description": "The placards ADR 5.3.1.5 requires are displayed.", "type": "boolean" }, "equipment_8_1_5": { "description": "The ADR 8.1.5 items on board; an item not listed is read as not on board.", "maxItems": 11, "type": "array", "items": { "type": "string", "enum": [ "wheel_chock", "warning_signs", "eye_rinsing_liquid", "warning_vest", "portable_lighting", "protective_gloves", "eye_protection", "emergency_escape_mask", "shovel", "drain_seal", "collecting_container" ] } }, "instructions_in_writing": { "description": "The ADR 5.4.3 instructions in writing are in the cab.", "type": "boolean" } }, "additionalProperties": false }, "crew": { "description": "The crew, for the driver-training and document checks. Facts only — no name.", "type": "object", "properties": { "adr_training_certificate": { "description": "The driver holds the ADR 8.2.1 training certificate.", "type": "boolean" }, "specialisations": { "description": "The specialisations on the certificate.", "maxItems": 3, "type": "array", "items": { "type": "string", "enum": [ "class_1", "class_7", "tanks" ] } }, "photo_identification": { "description": "Each crew member carries identification with a photograph (8.1.2.1 (d)).", "type": "boolean" }, "awareness_training_1_3": { "description": "The driver is trained according to Chapter 1.3 (8.2.3).", "type": "boolean" } }, "additionalProperties": false }, "options": { "description": "The consignment object's options; not read by this check.", "type": "object", "properties": { "air_volumetric_divisor": { "type": "number", "exclusiveMinimum": 0, "maximum": 10000 }, "container_number": { "type": "string", "maxLength": 20 }, "awb_number": { "type": "string", "maxLength": 20 }, "incoterm": { "type": "string", "enum": [ "EXW", "FCA", "FAS", "FOB", "CFR", "CIF", "CPT", "CIP", "DAP", "DPU", "DDP" ] }, "freight_cost": { "type": "object", "properties": { "amount": { "type": "number", "minimum": 0, "maximum": 1000000000000 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount", "currency" ], "additionalProperties": false }, "insurance_cost": { "type": "object", "properties": { "amount": { "type": "number", "minimum": 0, "maximum": 1000000000000 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount", "currency" ], "additionalProperties": false } }, "additionalProperties": false }, "edition": { "description": "ADR edition; wins over as_of. Omitted: as_of picks it.", "type": "string", "enum": [ "2025", "2027" ] }, "as_of": { "description": "The date the answer is for, YYYY-MM-DD (default today, UTC).", "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "lines" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false }
Connections
streamable-http
https://www.freightutils.com/api/mcp