FreightUtils MCP Server is an MCP server published by io.github.SoapyRED, hosted at www.freightutils.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 27 tools, including cbm_calculator, chargeable_weight_calculator, ldm_calculator, adr_lookup, adr_exemption_calculator.
Neutral freight reference + validation layer for AI agents: ADR, HS, UN/LOCODE, freight math
635 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Cubic metres (CBM) of a shipment from per-piece dimensions in cm and a piece count, with cubic feet, litres and cubic inches. Volume only: for air billing weight from the same dimensions use chargeable_weight_calculator, for multi-line totals consignment_calculator, for one unit conversion unit_converter, for a full composite analysis shipment_summary. Deterministic; totals are computed from unrounded figures and rounded only for display. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.
| Parameter | Type | Description |
|---|---|---|
| pieces | integer | Number of identical pieces. Default 1. |
| width_cm * | number | Width of one piece, cm. |
| height_cm * | number | Height of one piece, cm. |
| length_cm * |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| number |
| Length of one piece, cm. |
{
"name": "cbm_calculator",
"title": "CBM Calculator",
"description": "Cubic metres (CBM) of a shipment from per-piece dimensions in cm and a piece count, with cubic feet, litres and cubic inches. Volume only: for air billing weight from the same dimensions use chargeable_weight_calculator, for multi-line totals consignment_calculator, for one unit conversion unit_converter, for a full composite analysis shipment_summary. Deterministic; totals are computed from unrounded figures and rounded only for display. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"length_cm",
"width_cm",
"height_cm"
],
"properties": {
"pieces": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of identical pieces. Default 1.",
"exclusiveMinimum": 0
},
"width_cm": {
"type": "number",
"description": "Width of one piece, cm.",
"exclusiveMinimum": 0
},
"height_cm": {
"type": "number",
"description": "Height of one piece, cm.",
"exclusiveMinimum": 0
},
"length_cm": {
"type": "number",
"description": "Length of one piece, cm.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "CBM Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Air freight chargeable weight — the greater of actual gross weight and volumetric weight, which is what airlines bill. The dimensions are per piece and gross_weight_kg is the TOTAL for all pieces; factor is the volumetric divisor (default 6000, the IATA standard; express integrators typically use 5000). Air only: sea W/M is consignment_calculator with mode=sea; volume alone is cbm_calculator; multi-line loads in any mode consignment_calculator; the equipment the freight flies in uld_lookup. Deterministic; totals are computed from unrounded figures and rounded only for display. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.
| Parameter | Type | Description |
|---|---|---|
| factor | integer | Volumetric divisor, cm³/kg. Default 6000. |
| pieces | integer | Number of identical pieces. Default 1. |
| width_cm * | number | Width of one piece, cm. |
| height_cm * | number | Height of one piece, cm. |
| length_cm * | number | Length of one piece, cm. |
| gross_weight_kg * | number | Gross weight of the WHOLE shipment (all pieces), kg. |
{
"name": "chargeable_weight_calculator",
"title": "Chargeable Weight Calculator",
"description": "Air freight chargeable weight — the greater of actual gross weight and volumetric weight, which is what airlines bill. The dimensions are per piece and gross_weight_kg is the TOTAL for all pieces; factor is the volumetric divisor (default 6000, the IATA standard; express integrators typically use 5000). Air only: sea W/M is consignment_calculator with mode=sea; volume alone is cbm_calculator; multi-line loads in any mode consignment_calculator; the equipment the freight flies in uld_lookup. Deterministic; totals are computed from unrounded figures and rounded only for display. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"length_cm",
"width_cm",
"height_cm",
"gross_weight_kg"
],
"properties": {
"factor": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Volumetric divisor, cm³/kg. Default 6000.",
"exclusiveMinimum": 0
},
"pieces": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of identical pieces. Default 1.",
"exclusiveMinimum": 0
},
"width_cm": {
"type": "number",
"description": "Width of one piece, cm.",
"exclusiveMinimum": 0
},
"height_cm": {
"type": "number",
"description": "Height of one piece, cm.",
"exclusiveMinimum": 0
},
"length_cm": {
"type": "number",
"description": "Length of one piece, cm.",
"exclusiveMinimum": 0
},
"gross_weight_kg": {
"type": "number",
"description": "Gross weight of the WHOLE shipment (all pieces), kg.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Chargeable Weight Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Loading metres (LDM) for European road freight — how much trailer length a pallet load occupies (1 LDM = 1 linear metre of a 2.4 m-wide trailer; a standard artic is 13.6 LDM) — and whether it fits. Provide a pallet preset OR custom length_mm + width_mm; omitting both errors. fits is true only when the load fits the vehicle's length, its pallet floor positions and, when weight_kg is given, its max payload; without weight_kg the payload is not checked. For the trailer specs behind the presets use vehicle_lookup; for boxes onto one pallet pallet_fitting_calculator; for mixed lines consignment_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.
| Parameter | Type | Description |
|---|---|---|
| pallet | string | Pallet preset (euro 1200x800, uk 1200x1000, half 800x600, quarter 600x400 mm). Provide this OR length_mm + width_mm. |
| vehicle | string | Vehicle preset (default artic = 13.6m curtainsider; rigid75 = 7.5t rigid; luton = 3.5t Luton van; us53 / us48 = US trailers; custom needs vehicle_length_m). rigid10 is DEPRECATED (removal in 3.0.0). |
| quantity | integer | Number of pallets. Default: 1. |
| width_mm | number | Custom pallet width in millimetres. Example: 980. |
| length_mm | number | Custom pallet length, mm (with width_mm, instead of a preset). |
| stackable | boolean | Pallets can be stacked (2 or 3 high). Default false. |
| weight_kg | number | Weight per pallet in kg — enables the payload side of the fits check. |
| stack_height | integer | Stack height when stackable: 2 or 3. Default: 2. |
| vehicle_length_m | number | Custom vehicle load length in metres (required when vehicle=custom). |
{
"name": "ldm_calculator",
"title": "LDM Calculator",
"description": "Loading metres (LDM) for European road freight — how much trailer length a pallet load occupies (1 LDM = 1 linear metre of a 2.4 m-wide trailer; a standard artic is 13.6 LDM) — and whether it fits. Provide a pallet preset OR custom length_mm + width_mm; omitting both errors. fits is true only when the load fits the vehicle's length, its pallet floor positions and, when weight_kg is given, its max payload; without weight_kg the payload is not checked. For the trailer specs behind the presets use vehicle_lookup; for boxes onto one pallet pallet_fitting_calculator; for mixed lines consignment_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"pallet": {
"enum": [
"euro",
"uk",
"half",
"quarter"
],
"type": "string",
"description": "Pallet preset (euro 1200x800, uk 1200x1000, half 800x600, quarter 600x400 mm). Provide this OR length_mm + width_mm."
},
"vehicle": {
"enum": [
"artic",
"rigid10",
"rigid75",
"luton",
"us53",
"us48",
"custom"
],
"type": "string",
"description": "Vehicle preset (default artic = 13.6m curtainsider; rigid75 = 7.5t rigid; luton = 3.5t Luton van; us53 / us48 = US trailers; custom needs vehicle_length_m). rigid10 is DEPRECATED (removal in 3.0.0)."
},
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of pallets. Default: 1.",
"exclusiveMinimum": 0
},
"width_mm": {
"type": "number",
"description": "Custom pallet width in millimetres. Example: 980.",
"exclusiveMinimum": 0
},
"length_mm": {
"type": "number",
"description": "Custom pallet length, mm (with width_mm, instead of a preset).",
"exclusiveMinimum": 0
},
"stackable": {
"type": "boolean",
"description": "Pallets can be stacked (2 or 3 high). Default false."
},
"weight_kg": {
"type": "number",
"description": "Weight per pallet in kg — enables the payload side of the fits check.",
"exclusiveMinimum": 0
},
"stack_height": {
"type": "integer",
"maximum": 3,
"minimum": 2,
"description": "Stack height when stackable: 2 or 3. Default: 2."
},
"vehicle_length_m": {
"type": "number",
"description": "Custom vehicle load length in metres (required when vehicle=custom).",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "LDM Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Look up the full European road dangerous-goods (ADR 2025) Table A entry for a substance — all 20 columns, from class, packing group and labels through special provisions, limited/excepted quantities, packing instructions, tank codes, carriage provisions, transport category, tunnel restriction code and hazard identification number — and what each of those codes means (resolved_codes). 2,939 entries across all 9 classes, from UNECE ADR 2025. Provide exactly ONE of: un_number (every packing-group variant of it; "1203", "UN1203" and "un 1203" are equivalent; explosives keep their leading zero), search (partial proper shipping name), hazard_class, or un_numbers (batch). A search with no hits errors with the closest names. For an LQ/EQ quantity check use adr_lq_eq_check; for 1.1.3.6 small-load points adr_exemption_calculator; for an identifier of unknown kind resolve_reference. Editions: edition ("2025" | "2027") and as_of (YYYY-MM-DD) choose the ADR edition — edition wins, else the date picks it (ADR 2025 before 2027-01-01, ADR 2027 from then; ADR 2025 may still be applied until 2027-06-30). An answer on a named edition carries adr_edition; neither sent, the answer is ADR 2025 until 2027-01-01. 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. A factual compilation of the ADR table, not legal or compliance advice; classification remains the consignor's responsibility.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | The date the answer is for, YYYY-MM-DD (default today, UTC). |
| limit | integer | search / hazard_class only: rows per page (default and max 50 for a search, 100 for a class). |
| offset | integer | search / hazard_class only: rows to skip (default 0). The response gives total and next_offset. |
| search | string | Case-insensitive partial match on the proper shipping name (min 2 characters). Example: "acetone". |
| edition | string | ADR edition; wins over as_of. Omitted: as_of picks it. |
| un_number | string | Exact UN number, 4 digits, optionally "UN"-prefixed ("0004" keeps its zero). |
| un_numbers | array | Batch: up to 50 UN numbers. Send alone. |
| hazard_class | string | All entries in an ADR class (Table A column (3a)), e.g. "3", "6.1", "1" (explosives; "1.4S" is a classification_code). |
| include_codes | string | What each Table A code means (resolved_codes): compact, full or none. Default compact for un_number, none otherwise. Each meaning carries verification_status (e.g. paraphrase_unreviewed). |
| include_statements | boolean | true adds plain-word statements[] to every row. Default false. |
{
"name": "adr_lookup",
"title": "ADR Dangerous Goods Lookup",
"description": "Look up the full European road dangerous-goods (ADR 2025) Table A entry for a substance — all 20 columns, from class, packing group and labels through special provisions, limited/excepted quantities, packing instructions, tank codes, carriage provisions, transport category, tunnel restriction code and hazard identification number — and what each of those codes means (resolved_codes). 2,939 entries across all 9 classes, from UNECE ADR 2025. Provide exactly ONE of: un_number (every packing-group variant of it; \"1203\", \"UN1203\" and \"un 1203\" are equivalent; explosives keep their leading zero), search (partial proper shipping name), hazard_class, or un_numbers (batch). A search with no hits errors with the closest names. For an LQ/EQ quantity check use adr_lq_eq_check; for 1.1.3.6 small-load points adr_exemption_calculator; for an identifier of unknown kind resolve_reference. Editions: edition (\"2025\" | \"2027\") and as_of (YYYY-MM-DD) choose the ADR edition — edition wins, else the date picks it (ADR 2025 before 2027-01-01, ADR 2027 from then; ADR 2025 may still be applied until 2027-06-30). An answer on a named edition carries adr_edition; neither sent, the answer is ADR 2025 until 2027-01-01. 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. A factual compilation of the ADR table, not legal or compliance advice; classification remains the consignor's responsibility.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The date the answer is for, YYYY-MM-DD (default today, UTC)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "search / hazard_class only: rows per page (default and max 50 for a search, 100 for a class)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "search / hazard_class only: rows to skip (default 0). The response gives total and next_offset."
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "Case-insensitive partial match on the proper shipping name (min 2 characters). Example: \"acetone\"."
},
"edition": {
"enum": [
"2025",
"2027"
],
"type": "string",
"description": "ADR edition; wins over as_of. Omitted: as_of picks it."
},
"un_number": {
"type": "string",
"pattern": "^\\s*(?:UN\\s*)?\\d{4}\\s*$",
"description": "Exact UN number, 4 digits, optionally \"UN\"-prefixed (\"0004\" keeps its zero)."
},
"un_numbers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 12
},
"maxItems": 50,
"minItems": 1,
"description": "Batch: up to 50 UN numbers. Send alone."
},
"hazard_class": {
"type": "string",
"description": "All entries in an ADR class (Table A column (3a)), e.g. \"3\", \"6.1\", \"1\" (explosives; \"1.4S\" is a classification_code)."
},
"include_codes": {
"enum": [
"none",
"compact",
"full"
],
"type": "string",
"description": "What each Table A code means (resolved_codes): compact, full or none. Default compact for un_number, none otherwise. Each meaning carries verification_status (e.g. paraphrase_unreviewed)."
},
"include_statements": {
"type": "boolean",
"description": "true adds plain-word statements[] to every row. Default false."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "ADR Dangerous Goods Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}ADR 1.1.3.6 "small load" exemption points for a dangerous-goods road load, and whether it qualifies; points = quantity x the transport category multiplier. The rule (1.1.3.6.2), for dangerous goods carried in packages: goods of ONE transport category qualify when their TOTAL on the transport unit stays within that category's 1.1.3.6.3 column (3) maximum (category 1: 20, 2: 333, 3: 1,000 kg or L; 4 unlimited; 0: 0); goods of DIFFERENT categories qualify when the 1.1.3.6.4 points sum does not exceed 1,000. Transport category 0 can never use the exemption. For limited/excepted quantity relief use adr_lq_eq_check; for a substance's row and variant_index adr_lookup; for the whole ADR picture of a load (tunnels, documents, plates) adr_consignment_check. Send un_number + quantity for one substance OR items[] for a load — never both: a single-substance field sent beside items[] is refused, never dropped. Quantities are kg or litres per the substance's ADR unit; a quantity of 0 means not carried, and a load of nothing but zeros is refused. A UN number whose Table A rows disagree needs packing_group or variant_index, else that line has no verdict (AMBIGUOUS_UN_VARIANT with candidates[]) — never a guessed row. An ID-prefixed air-only number (e.g. "ID8000") is counted out of 1.1.3.6 only with icao_limited_quantity: true on that line, otherwise BLOCKED. Without that statement the ID line is BLOCKED (items[].entry_required true) and the load has no verdict unless the other lines settle it. A gross mass (basis "gross") is only an upper bound: send the net quantity. edition ("2025" | "2027") and as_of choose the ADR edition; neither sent, ADR 2025 until 2027-01-01. Such an answer headlines the transitional basis that clears the load, names it, gives basis_until (the last day it may be applied) and puts the strict ADR 2027 figure beside it (strict_adr_2027: basis, total_points, exempt, has_category_zero, has_quantity_exceedance). Fields are checked by name: a field the tool does not read is refused with a tool error naming it and listing the accepted ones, never ignored. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A calculation over reference data, not legal advice: 1.1.3.6 relieves goods carried in packages only (not in bulk or in tanks), and exempt loads keep core duties; verify against the current UNECE ADR text.
| Parameter | Type | Description |
|---|---|---|
| unit | string | The dimension quantity is stated in, checked against the one ADR 1.1.3.6.3 counts for the row (a mismatch gives no points). Omitted: taken as already on that basis. Single-substance form only. |
| as_of | string | The date the answer is for, YYYY-MM-DD (default today, UTC). |
| basis | string | net or gross; a gross mass is only an upper bound of the net (figure_basis upper_bound_gross; send the net quantity). Single-substance form only. |
| items | array | Mixed-load items, INSTEAD of un_number/quantity. |
| edition | string | ADR edition; wins over as_of. Omitted: as_of picks it. |
| quantity | number | Quantity in kg or litres per the substance's ADR unit. Single-substance form only. |
| un_number | string | UN number (4 digits, optionally "UN"-prefixed) or an ID-prefixed air-only number ("ID8000"). Single-substance form only. |
| consignment | object | The consignment object, instead of the other arguments. Send it alone. |
| packing_group | string | Packing group, to pin one row of a multi-row UN. Single-substance form only. |
| variant_index | integer | ADR Table A variant index (from adr_lookup), to pin one row. Single-substance form only. |
| icao_limited_quantity | boolean | ID-prefixed un_number only: true states the packages are ICAO Technical Instructions limited quantities (the 3.4.8 mark, or 3.4.10). |
{
"name": "adr_exemption_calculator",
"title": "ADR 1.1.3.6 Exemption Calculator",
"description": "ADR 1.1.3.6 \"small load\" exemption points for a dangerous-goods road load, and whether it qualifies; points = quantity x the transport category multiplier. The rule (1.1.3.6.2), for dangerous goods carried in packages: goods of ONE transport category qualify when their TOTAL on the transport unit stays within that category's 1.1.3.6.3 column (3) maximum (category 1: 20, 2: 333, 3: 1,000 kg or L; 4 unlimited; 0: 0); goods of DIFFERENT categories qualify when the 1.1.3.6.4 points sum does not exceed 1,000. Transport category 0 can never use the exemption. For limited/excepted quantity relief use adr_lq_eq_check; for a substance's row and variant_index adr_lookup; for the whole ADR picture of a load (tunnels, documents, plates) adr_consignment_check.\n\nSend un_number + quantity for one substance OR items[] for a load — never both: a single-substance field sent beside items[] is refused, never dropped. Quantities are kg or litres per the substance's ADR unit; a quantity of 0 means not carried, and a load of nothing but zeros is refused. A UN number whose Table A rows disagree needs packing_group or variant_index, else that line has no verdict (AMBIGUOUS_UN_VARIANT with candidates[]) — never a guessed row. An ID-prefixed air-only number (e.g. \"ID8000\") is counted out of 1.1.3.6 only with icao_limited_quantity: true on that line, otherwise BLOCKED. Without that statement the ID line is BLOCKED (items[].entry_required true) and the load has no verdict unless the other lines settle it. A gross mass (basis \"gross\") is only an upper bound: send the net quantity. edition (\"2025\" | \"2027\") and as_of choose the ADR edition; neither sent, ADR 2025 until 2027-01-01. Such an answer headlines the transitional basis that clears the load, names it, gives basis_until (the last day it may be applied) and puts the strict ADR 2027 figure beside it (strict_adr_2027: basis, total_points, exempt, has_category_zero, has_quantity_exceedance). Fields are checked by name: a field the tool does not read is refused with a tool error naming it and listing the accepted ones, never ignored. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A calculation over reference data, not legal advice: 1.1.3.6 relieves goods carried in packages only (not in bulk or in tanks), and exempt loads keep core duties; verify against the current UNECE ADR text.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"unit": {
"enum": [
"L",
"kg"
],
"type": "string",
"description": "The dimension quantity is stated in, checked against the one ADR 1.1.3.6.3 counts for the row (a mismatch gives no points). Omitted: taken as already on that basis. Single-substance form only."
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The date the answer is for, YYYY-MM-DD (default today, UTC)."
},
"basis": {
"enum": [
"net",
"gross"
],
"type": "string",
"description": "net or gross; a gross mass is only an upper bound of the net (figure_basis upper_bound_gross; send the net quantity). Single-substance form only."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"un_number",
"quantity"
],
"properties": {
"unit": {
"enum": [
"L",
"kg"
],
"type": "string",
"description": "The dimension quantity is stated in, checked against the one ADR 1.1.3.6.3 counts for the row (a mismatch gives no points). Omitted: taken as already on that basis."
},
"basis": {
"enum": [
"net",
"gross"
],
"type": "string",
"description": "net or gross; a gross mass is only an upper bound of the net."
},
"quantity": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Quantity in kg or litres per the substance's ADR unit; 0 = not carried (state EXCLUDED_NIL)."
},
"un_number": {
"type": "string",
"pattern": "^(?:\\s*(?:UN\\s*)?\\d{4}\\s*|\\s*ID\\s*[-:.]?\\s*\\d{4}\\s*)$",
"description": "UN number (4 digits, optionally \"UN\"-prefixed) or an ID-prefixed air-only number (\"ID8000\")."
},
"packing_group": {
"enum": [
"I",
"II",
"III"
],
"type": "string",
"description": "Packing group for a multi-variant UN."
},
"variant_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "ADR Table A variant index for a multi-variant UN."
},
"icao_limited_quantity": {
"type": "boolean",
"description": "OPTIONAL, ID-prefixed lines only: as the top-level icao_limited_quantity."
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Mixed-load items, INSTEAD of un_number/quantity."
},
"edition": {
"enum": [
"2025",
"2027"
],
"type": "string",
"description": "ADR edition; wins over as_of. Omitted: as_of picks it."
},
"quantity": {
"type": "number",
"maximum": 1000000000,
"description": "Quantity in kg or litres per the substance's ADR unit. Single-substance form only.",
"exclusiveMinimum": 0
},
"un_number": {
"type": "string",
"pattern": "^(?:\\s*(?:UN\\s*)?\\d{4}\\s*|\\s*ID\\s*[-:.]?\\s*\\d{4}\\s*)$",
"description": "UN number (4 digits, optionally \"UN\"-prefixed) or an ID-prefixed air-only number (\"ID8000\"). Single-substance form only."
},
"consignment": {
"type": "object",
"required": [
"lines"
],
"properties": {
"crew": {
"type": "object",
"properties": {
"specialisations": {
"type": "array",
"items": {
"enum": [
"class_1",
"class_7",
"tanks"
],
"type": "string"
},
"maxItems": 3
},
"photo_identification": {
"type": "boolean"
},
"awareness_training_1_3": {
"type": "boolean"
},
"adr_training_certificate": {
"type": "boolean"
}
},
"additionalProperties": false
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dims": {
"type": "object",
"required": [
"l",
"w",
"h",
"unit"
],
"properties": {
"h": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"l": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"w": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"unit": {
"enum": [
"mm",
"cm",
"m",
"in"
],
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"hs_code": {
"type": "string",
"pattern": "^\\d{6,10}$"
},
"packages": {
"type": "object",
"required": [
"count"
],
"properties": {
"type": {
"type": "string",
"maxLength": 40
},
"count": {
"type": "integer",
"maximum": 100000,
"exclusiveMinimum": 0
},
"un_mark": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"gross_kg": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"quantity": {
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"enum": [
"L",
"kg"
],
"type": "string"
},
"basis": {
"enum": [
"net",
"gross"
],
"type": "string"
},
"value": {
"type": "number",
"maximum": 1000000000,
"minimum": 0
}
},
"additionalProperties": false
},
"stackable": {
"type": "boolean"
},
"un_number": {
"type": "string",
"pattern": "^(?:(?:UN\\s?)?\\d{4}|ID\\s?\\d{4})$"
},
"description": {
"type": "string",
"maxLength": 200
},
"packing_group": {
"enum": [
"I",
"II",
"III"
],
"type": "string"
},
"variant_index": {
"type": "integer",
"maximum": 1000,
"minimum": 0
},
"inner_packaging": {
"type": "object",
"required": [
"quantity",
"unit"
],
"properties": {
"unit": {
"enum": [
"ml",
"L",
"g",
"kg"
],
"type": "string"
},
"regime": {
"enum": [
"lq",
"eq"
],
"type": "string"
},
"quantity": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
},
"per_outer": {
"type": "integer",
"maximum": 100000,
"minimum": 1
}
},
"additionalProperties": false
},
"icao_limited_quantity": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1
},
"journey": {
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"mode": {
"enum": [
"road",
"air",
"sea",
"multimodal"
],
"type": "string"
},
"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})?$"
},
"tunnels_on_route": {
"type": "array",
"items": {
"enum": [
"A",
"B",
"C",
"D",
"E"
],
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
},
"options": {
"type": "object",
"properties": {
"incoterm": {
"enum": [
"EXW",
"FCA",
"FAS",
"FOB",
"CFR",
"CIF",
"CPT",
"CIP",
"DAP",
"DPU",
"DDP"
],
"type": "string"
},
"awb_number": {
"type": "string",
"maxLength": 20
},
"freight_cost": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"insurance_cost": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"container_number": {
"type": "string",
"maxLength": 20
},
"air_volumetric_divisor": {
"type": "number",
"maximum": 10000,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"vehicle": {
"type": "object",
"properties": {
"type": {
"type": "string",
"maxLength": 60
},
"axles": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"max_mass_t": {
"type": "number",
"maximum": 100,
"exclusiveMinimum": 0
},
"equipment_8_1_5": {
"type": "array",
"items": {
"enum": [
"wheel_chock",
"warning_signs",
"eye_rinsing_liquid",
"warning_vest",
"portable_lighting",
"protective_gloves",
"eye_protection",
"emergency_escape_mask",
"shovel",
"drain_seal",
"collecting_container"
],
"type": "string"
},
"maxItems": 11
},
"foodstuffs_carried": {
"type": "boolean"
},
"placards_displayed": {
"type": "boolean"
},
"fire_extinguishers_kg": {
"type": "array",
"items": {
"type": "number",
"maximum": 100,
"exclusiveMinimum": 0
},
"maxItems": 20
},
"instructions_in_writing": {
"type": "boolean"
},
"orange_plates_displayed": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"description": "The consignment object, instead of the other arguments. Send it alone.",
"additionalProperties": false
},
"packing_group": {
"enum": [
"I",
"II",
"III"
],
"type": "string",
"description": "Packing group, to pin one row of a multi-row UN. Single-substance form only."
},
"variant_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "ADR Table A variant index (from adr_lookup), to pin one row. Single-substance form only."
},
"icao_limited_quantity": {
"type": "boolean",
"description": "ID-prefixed un_number only: true states the packages are ICAO Technical Instructions limited quantities (the 3.4.8 mark, or 3.4.10)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "ADR 1.1.3.6 Exemption Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find airlines (6,356) by name, IATA code, ICAO code, AWB prefix (the first 3 digits of an air waybill number, e.g. 176 = Emirates) or country. Provide ONE parameter: query is a ranked fuzzy search; iata / icao / prefix / country are exact filters. Searches carriers, not airports — for airports use airport_lookup; to check an AWB number's check digit use validate. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Provenance pending independent verification — confirm operationally critical codes with IATA/ICAO or the carrier.
| Parameter | Type | Description |
|---|---|---|
| full | boolean | Lists only: true returns full records instead of summary rows. |
| iata | string | Exact 2-character IATA code. |
| icao | string | Exact 3-letter ICAO code. |
| codes | array | Batch: up to 50 airline codes (IATA, ICAO or AWB prefix). Send alone. |
| limit | integer | Lists only: rows per page. |
| query | string | Ranked fuzzy search across names and codes. |
| offset | integer | Lists only: rows to skip (default 0). |
| prefix | string | Exact AWB prefix, 3 digits. |
| country | string | Country name filter. |
{
"name": "airline_lookup",
"title": "Airline / AWB Prefix Lookup",
"description": "Find airlines (6,356) by name, IATA code, ICAO code, AWB prefix (the first 3 digits of an air waybill number, e.g. 176 = Emirates) or country. Provide ONE parameter: query is a ranked fuzzy search; iata / icao / prefix / country are exact filters. Searches carriers, not airports — for airports use airport_lookup; to check an AWB number's check digit use validate. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Provenance pending independent verification — confirm operationally critical codes with IATA/ICAO or the carrier.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"full": {
"type": "boolean",
"description": "Lists only: true returns full records instead of summary rows."
},
"iata": {
"type": "string",
"pattern": "^[A-Za-z0-9]{2}$",
"description": "Exact 2-character IATA code."
},
"icao": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Exact 3-letter ICAO code."
},
"codes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 4
},
"maxItems": 50,
"minItems": 1,
"description": "Batch: up to 50 airline codes (IATA, ICAO or AWB prefix). Send alone."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Lists only: rows per page."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "Ranked fuzzy search across names and codes."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Lists only: rows to skip (default 0)."
},
"prefix": {
"type": "string",
"pattern": "^\\d{3}$",
"description": "Exact AWB prefix, 3 digits."
},
"country": {
"type": "string",
"minLength": 2,
"description": "Country name filter."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Airline / AWB Prefix Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Look up an airport by IATA code ("LHR"), ICAO code ("EGLL") or free-text name/city search (OurAirports, public domain). Covers 86,281 airports worldwide (OurAirports, public domain, cross-checked vs OpenFlights + Wikidata). Provide ONE of iata, icao or query; ambiguous name searches return ranked candidates; an unknown code errors. For airports near a coordinate use nearest_airport; for carriers and AWB prefixes airline_lookup; for general transport locations unlocode_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Reference data only — not for navigation.
| Parameter | Type | Description |
|---|---|---|
| iata | string | Exact 3-letter IATA code. |
| icao | string | Exact 4-character ICAO code / ident. |
| type | string | Optional filter by airport type. |
| codes | array | Batch: up to 50 airport codes (IATA or ICAO). Send alone. |
| query | string | Name or city search. |
{
"name": "airport_lookup",
"title": "Airport Code Lookup",
"description": "Look up an airport by IATA code (\"LHR\"), ICAO code (\"EGLL\") or free-text name/city search (OurAirports, public domain). Covers 86,281 airports worldwide (OurAirports, public domain, cross-checked vs OpenFlights + Wikidata). Provide ONE of iata, icao or query; ambiguous name searches return ranked candidates; an unknown code errors. For airports near a coordinate use nearest_airport; for carriers and AWB prefixes airline_lookup; for general transport locations unlocode_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Reference data only — not for navigation.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"iata": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Exact 3-letter IATA code."
},
"icao": {
"type": "string",
"pattern": "^[A-Za-z0-9]{4}$",
"description": "Exact 4-character ICAO code / ident."
},
"type": {
"enum": [
"large_airport",
"medium_airport",
"small_airport",
"heliport",
"closed",
"seaplane_base"
],
"type": "string",
"description": "Optional filter by airport type."
},
"codes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 4
},
"maxItems": 50,
"minItems": 1,
"description": "Batch: up to 50 airport codes (IATA or ICAO). Send alone."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "Name or city search."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Airport Code Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The airports nearest a latitude/longitude you provide, sorted by great-circle distance (distance_km on each). Searches 86,281 airports (OurAirports, public domain). By default only airports with scheduled airline service and an IATA code are ranked — never a heliport or a closed field; include_all: true ranks every type except closed fields. Does NOT geocode place names — pass coordinates you already hold; nothing is stored. For an exact code or name lookup use airport_lookup; for named transport locations unlocode_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Reference data only — not for navigation.
| Parameter | Type | Description |
|---|---|---|
| type | string | Optional filter by airport type. Example: "large_airport". |
| latitude * | number | Latitude, decimal degrees. |
| longitude * | number | Longitude, decimal degrees. |
| radius_km | number | Maximum distance in kilometres — omit for no radius cap. |
| include_all | boolean | true: every airport type except closed fields. Default false (scheduled service with an IATA code). |
| max_results | integer | Maximum results (1-50). Default: 10. |
{
"name": "nearest_airport",
"title": "Nearest Airport",
"description": "The airports nearest a latitude/longitude you provide, sorted by great-circle distance (distance_km on each). Searches 86,281 airports (OurAirports, public domain). By default only airports with scheduled airline service and an IATA code are ranked — never a heliport or a closed field; include_all: true ranks every type except closed fields. Does NOT geocode place names — pass coordinates you already hold; nothing is stored. For an exact code or name lookup use airport_lookup; for named transport locations unlocode_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Reference data only — not for navigation.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"latitude",
"longitude"
],
"properties": {
"type": {
"enum": [
"large_airport",
"medium_airport",
"small_airport",
"heliport",
"closed",
"seaplane_base"
],
"type": "string",
"description": "Optional filter by airport type. Example: \"large_airport\"."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, decimal degrees."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, decimal degrees."
},
"radius_km": {
"type": "number",
"description": "Maximum distance in kilometres — omit for no radius cap.",
"exclusiveMinimum": 0
},
"include_all": {
"type": "boolean",
"description": "true: every airport type except closed fields. Default false (scheduled service with an IATA code)."
},
"max_results": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum results (1-50). Default: 10."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Nearest Airport",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Resolve an arbitrary freight identifier — one opaque string in, typed and cited candidates out. Use when you hold one identifier-ish token ("176", "UN1845", "NLRTM", "FOB", "22G1", "MSKU1100810", "D/E", "TU9") and do not know what kind of identifier it is: each candidate names its entity type and carries the api_url and canonical_url of its full record. q is ONE identifier (max 32 chars), or an fu: identifier (fu_id or fu_version_id, up to 200 chars), which resolves to exactly its one record or to none. Colliding grammars return several ranked candidates, never a silent guess; zero candidates is a valid result. Single-token resolution, not free-text extraction — pass one identifier, not a manifest line. The lookups it resolves into: adr_lookup, airline_lookup, airport_lookup, unlocode_lookup, hs_code_lookup, incoterms_lookup, container_lookup, uld_lookup, validate. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.
| Parameter | Type | Description |
|---|---|---|
| q * | string | One freight identifier, or an fu: identifier from an answer (e.g. "fu:adr:un:1203:II:F1@2025"). |
{
"name": "resolve_reference",
"title": "Resolve Freight Reference",
"description": "Resolve an arbitrary freight identifier — one opaque string in, typed and cited candidates out. Use when you hold one identifier-ish token (\"176\", \"UN1845\", \"NLRTM\", \"FOB\", \"22G1\", \"MSKU1100810\", \"D/E\", \"TU9\") and do not know what kind of identifier it is: each candidate names its entity type and carries the api_url and canonical_url of its full record. q is ONE identifier (max 32 chars), or an fu: identifier (fu_id or fu_version_id, up to 200 chars), which resolves to exactly its one record or to none. Colliding grammars return several ranked candidates, never a silent guess; zero candidates is a valid result. Single-token resolution, not free-text extraction — pass one identifier, not a manifest line. The lookups it resolves into: adr_lookup, airline_lookup, airport_lookup, unlocode_lookup, hs_code_lookup, incoterms_lookup, container_lookup, uld_lookup, validate. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "One freight identifier, or an fu: identifier from an answer (e.g. \"fu:adr:un:1203:II:F1@2025\")."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Resolve Freight Reference",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}ISO shipping-container specifications for 10 types (20ft/40ft standard, 40ft and 45ft high-cube, reefer, open-top and flat-rack), with optional load-fit maths. type (a slug such as "40ft-high-cube", the ISO size-type code "45G1" or the short form "40HC") gives one record; omit it to list all 10; add item dimensions to compute how many items fit. For a container NUMBER's check digit use validate; for the air-freight equivalent uld_lookup; for the cargo volume cbm_calculator / consignment_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Manufacturer-typical specs, provenance pending — confirm against the carrier's equipment guide.
| Parameter | Type | Description |
|---|---|---|
| full | boolean | Lists only: true returns full records instead of summary rows. |
| type | string | Container slug ("40ft-high-cube"), ISO code or short form. Omit to list all. |
| limit | integer | Lists only: rows per page. |
| offset | integer | Lists only: rows to skip (default 0). |
| item_quantity | integer | Number of items to check against the container. |
| item_width_cm | number | Item width in cm. |
| item_height_cm | number | Item height in cm. |
| item_length_cm | number | Item length in cm — provide all three item dims to get a load-fit calculation. |
| item_weight_kg | number | Weight of ONE item, kg; caps the fit by max payload. |
{
"name": "container_lookup",
"title": "Container Lookup",
"description": "ISO shipping-container specifications for 10 types (20ft/40ft standard, 40ft and 45ft high-cube, reefer, open-top and flat-rack), with optional load-fit maths. type (a slug such as \"40ft-high-cube\", the ISO size-type code \"45G1\" or the short form \"40HC\") gives one record; omit it to list all 10; add item dimensions to compute how many items fit. For a container NUMBER's check digit use validate; for the air-freight equivalent uld_lookup; for the cargo volume cbm_calculator / consignment_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Manufacturer-typical specs, provenance pending — confirm against the carrier's equipment guide.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"full": {
"type": "boolean",
"description": "Lists only: true returns full records instead of summary rows."
},
"type": {
"type": "string",
"minLength": 2,
"description": "Container slug (\"40ft-high-cube\"), ISO code or short form. Omit to list all."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Lists only: rows per page."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Lists only: rows to skip (default 0)."
},
"item_quantity": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of items to check against the container.",
"exclusiveMinimum": 0
},
"item_width_cm": {
"type": "number",
"description": "Item width in cm.",
"exclusiveMinimum": 0
},
"item_height_cm": {
"type": "number",
"description": "Item height in cm.",
"exclusiveMinimum": 0
},
"item_length_cm": {
"type": "number",
"description": "Item length in cm — provide all three item dims to get a load-fit calculation.",
"exclusiveMinimum": 0
},
"item_weight_kg": {
"type": "number",
"minimum": 0,
"description": "Weight of ONE item, kg; caps the fit by max payload."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Container Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search the 6,936 codes of the WCO Harmonized System (HS 2022), the 6-digit international customs classification (2 digits chapter, 4 heading, 6 subheading). Provide ONE of: query (free-text description), code (2-6 digits, dots or spaces ignored; returns the code with its hierarchy) or section (Roman numeral I-XXI). Behavior: read-only; description search runs first against the HS 2022 descriptions (UN Comtrade H6), on whole words only (a word inside a longer word never matches); when none contains the words, or the best match is weak, it asks the UK Trade Tariff search references (HMRC's index of everyday goods names) and serves their answer, so "laptop" finds 847130, "computers" heading 8471 and "charger" heading 8504. A description search matches whole words, then asks HMRC's everyday goods names at medium confidence; count 0 with an empty results[] is a valid answer (NO_MATCH). For UK duty/VAT on a code use uk_duty_calculator; for ENS goods-description screening ics2_check. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. The 6-digit level only — national tariff lines and duty rates are set per country; indicative, not a binding ruling.
| Parameter | Type | Description |
|---|---|---|
| code | string | HS code or prefix, 2, 4 or 6 digits; dots and spaces ignored ("8471.30"). |
| codes | array | Batch: up to 50 HS codes. Send alone. |
| query | string | Search words, matched against the HS descriptions, then HMRC everyday goods names. |
| section | string | A section, Roman numeral I-XXI. |
{
"name": "hs_code_lookup",
"title": "HS Code Lookup",
"description": "Search the 6,936 codes of the WCO Harmonized System (HS 2022), the 6-digit international customs classification (2 digits chapter, 4 heading, 6 subheading). Provide ONE of: query (free-text description), code (2-6 digits, dots or spaces ignored; returns the code with its hierarchy) or section (Roman numeral I-XXI). Behavior: read-only; description search runs first against the HS 2022 descriptions (UN Comtrade H6), on whole words only (a word inside a longer word never matches); when none contains the words, or the best match is weak, it asks the UK Trade Tariff search references (HMRC's index of everyday goods names) and serves their answer, so \"laptop\" finds 847130, \"computers\" heading 8471 and \"charger\" heading 8504. A description search matches whole words, then asks HMRC's everyday goods names at medium confidence; count 0 with an empty results[] is a valid answer (NO_MATCH). For UK duty/VAT on a code use uk_duty_calculator; for ENS goods-description screening ics2_check. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. The 6-digit level only — national tariff lines and duty rates are set per country; indicative, not a binding ruling.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"code": {
"type": "string",
"description": "HS code or prefix, 2, 4 or 6 digits; dots and spaces ignored (\"8471.30\")."
},
"codes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 14
},
"maxItems": 50,
"minItems": 1,
"description": "Batch: up to 50 HS codes. Send alone."
},
"query": {
"type": "string",
"minLength": 2,
"description": "Search words, matched against the HS descriptions, then HMRC everyday goods names."
},
"section": {
"type": "string",
"pattern": "^[ivxIVX]{1,5}$",
"description": "A section, Roman numeral I-XXI."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "HS Code Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The 11 Incoterms 2020 rules — who pays for transport, insurance and customs clearance, and where risk transfers from seller to buyer. code gives one rule; category (any_mode | sea_only) filters; neither lists all 11. An unknown code errors with the valid list; DAT names its successor, DPU. Related: uk_duty_calculator (takes an incoterm when composing the CIF value), shipment_summary. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Summarised guidance; the ICC publication is the binding text.
| Parameter | Type | Description |
|---|---|---|
| code | string | Three-letter Incoterms 2020 code. |
| full | boolean | Lists only: true returns full records instead of summary rows. |
| limit | integer | Lists only: rows per page. |
| offset | integer | Lists only: rows to skip (default 0). |
| category | string | Filter the list: any_mode (7 rules) or sea_only (4 rules). |
{
"name": "incoterms_lookup",
"title": "Incoterms 2020 Lookup",
"description": "The 11 Incoterms 2020 rules — who pays for transport, insurance and customs clearance, and where risk transfers from seller to buyer. code gives one rule; category (any_mode | sea_only) filters; neither lists all 11. An unknown code errors with the valid list; DAT names its successor, DPU. Related: uk_duty_calculator (takes an incoterm when composing the CIF value), shipment_summary. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Summarised guidance; the ICC publication is the binding text.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Three-letter Incoterms 2020 code."
},
"full": {
"type": "boolean",
"description": "Lists only: true returns full records instead of summary rows."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Lists only: rows per page."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Lists only: rows to skip (default 0)."
},
"category": {
"enum": [
"any_mode",
"sea_only"
],
"type": "string",
"description": "Filter the list: any_mode (7 rules) or sea_only (4 rules)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Incoterms 2020 Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}How many identical boxes fit on one pallet: boxes per layer (trying 90-degree rotation when allowed), layers within the max height, totals, footprint and volume utilisation (volume_utilisation_percent), capped in whole layers by max_payload_kg. One box size in aligned rows — no interlocked or mixed patterns. For pallets into trailer length use ldm_calculator; pallet capacity per vehicle vehicle_lookup; pallets into containers container_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A theoretical best-effort fit — carton strength, overhang and load stability are not modelled.
| Parameter | Type | Description |
|---|---|---|
| box_width_cm * | number | Box width in cm. |
| box_height_cm * | number | Box height in cm. |
| box_length_cm * | number | Box length in cm. |
| box_weight_kg | number | Weight per box in kg — enables the weight-capping check. |
| allow_rotation | boolean | Try 90-degree box rotation for the best layer fit. Default: true. |
| max_payload_kg | number | Maximum pallet payload in kg. Example: 1000. |
| pallet_width_cm * | number | Pallet width, cm. |
| pallet_length_cm * | number | Pallet length, cm. |
| pallet_max_height_cm * | number | Maximum stack height in cm INCLUDING the pallet deck. |
| pallet_deck_height_cm | number | Pallet deck height in cm. Default: 15. |
{
"name": "pallet_fitting_calculator",
"title": "Pallet Fitting Calculator",
"description": "How many identical boxes fit on one pallet: boxes per layer (trying 90-degree rotation when allowed), layers within the max height, totals, footprint and volume utilisation (volume_utilisation_percent), capped in whole layers by max_payload_kg. One box size in aligned rows — no interlocked or mixed patterns. For pallets into trailer length use ldm_calculator; pallet capacity per vehicle vehicle_lookup; pallets into containers container_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A theoretical best-effort fit — carton strength, overhang and load stability are not modelled.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pallet_length_cm",
"pallet_width_cm",
"pallet_max_height_cm",
"box_length_cm",
"box_width_cm",
"box_height_cm"
],
"properties": {
"box_width_cm": {
"type": "number",
"description": "Box width in cm.",
"exclusiveMinimum": 0
},
"box_height_cm": {
"type": "number",
"description": "Box height in cm.",
"exclusiveMinimum": 0
},
"box_length_cm": {
"type": "number",
"description": "Box length in cm.",
"exclusiveMinimum": 0
},
"box_weight_kg": {
"type": "number",
"description": "Weight per box in kg — enables the weight-capping check.",
"exclusiveMinimum": 0
},
"allow_rotation": {
"type": "boolean",
"description": "Try 90-degree box rotation for the best layer fit. Default: true."
},
"max_payload_kg": {
"type": "number",
"description": "Maximum pallet payload in kg. Example: 1000.",
"exclusiveMinimum": 0
},
"pallet_width_cm": {
"type": "number",
"description": "Pallet width, cm.",
"exclusiveMinimum": 0
},
"pallet_length_cm": {
"type": "number",
"description": "Pallet length, cm.",
"exclusiveMinimum": 0
},
"pallet_max_height_cm": {
"type": "number",
"description": "Maximum stack height in cm INCLUDING the pallet deck.",
"exclusiveMinimum": 0
},
"pallet_deck_height_cm": {
"type": "number",
"description": "Pallet deck height in cm. Default: 15.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Pallet Fitting Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Convert freight weight, volume and length units, plus chargeable_kg (air volumetric weight at the IATA 6,000 divisor) and freight_tonnes (sea W/M, 1 CBM = 1 freight tonne), both only FROM cbm. Cross-dimension conversions (e.g. kg to litres) and a negative value are refused. For dimensions to volume use cbm_calculator; for air billing weight with pieces and a custom divisor chargeable_weight_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Target unit; chargeable_kg and freight_tonnes only from cbm. |
| from * | string | Source unit; the same dimension as "to". |
| value * | number | The value to convert, 0 or more. |
{
"name": "unit_converter",
"title": "Unit Converter",
"description": "Convert freight weight, volume and length units, plus chargeable_kg (air volumetric weight at the IATA 6,000 divisor) and freight_tonnes (sea W/M, 1 CBM = 1 freight tonne), both only FROM cbm. Cross-dimension conversions (e.g. kg to litres) and a negative value are refused. For dimensions to volume use cbm_calculator; for air billing weight with pieces and a custom divisor chargeable_weight_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"value",
"from",
"to"
],
"properties": {
"to": {
"enum": [
"kg",
"lbs",
"oz",
"tonnes",
"short_tons",
"long_tons",
"cbm",
"cuft",
"cuin",
"litres",
"gal_us",
"gal_uk",
"cm",
"inches",
"m",
"feet",
"mm",
"chargeable_kg",
"freight_tonnes"
],
"type": "string",
"description": "Target unit; chargeable_kg and freight_tonnes only from cbm."
},
"from": {
"enum": [
"kg",
"lbs",
"oz",
"tonnes",
"short_tons",
"long_tons",
"cbm",
"cuft",
"cuin",
"litres",
"gal_us",
"gal_uk",
"cm",
"inches",
"m",
"feet",
"mm"
],
"type": "string",
"description": "Source unit; the same dimension as \"to\"."
},
"value": {
"type": "number",
"description": "The value to convert, 0 or more."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Unit Converter",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Per-line and grand totals for a multi-item mixed consignment: CBM, loading metres, volumetric weight and the mode's chargeable figure (air chargeable weight, sea revenue tonnes, road LDM), plus advisory flags (implausible density, mode/option mismatch, dangerous goods by UN number, container/AWB check digits). Send mode (sea | air | road, default road) and lines[] (each line with its own dimension and weight units), or the legacy flat items[] in cm and kg. For a vehicle/container suggestion and duty estimates use shipment_summary; for one figure cbm_calculator / chargeable_weight_calculator / ldm_calculator; for what a flagged UN number is adr_lookup. 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. Flags are advisory and never state that a shipment is permitted or compliant; not regulatory, customs or dangerous-goods compliance advice.
| Parameter | Type | Description |
|---|---|---|
| mode | string | Transport mode: sea | air | road. Default: road. |
| as_of | string | The date the answer is for, YYYY-MM-DD (default today, UTC). |
| items | array | Legacy flat alias — dimensions in cm, weight in kg. Prefer lines. |
| lines | array | Canonical consignment lines (preferred, 1-50). Provide lines OR items. |
| edition | string | ADR edition; wins over as_of. Omitted: as_of picks it. |
| options | object | Optional settings. |
| consignment | object | The consignment object, instead of the other arguments. Send it alone. |
{
"name": "consignment_calculator",
"title": "Consignment Calculator",
"description": "Per-line and grand totals for a multi-item mixed consignment: CBM, loading metres, volumetric weight and the mode's chargeable figure (air chargeable weight, sea revenue tonnes, road LDM), plus advisory flags (implausible density, mode/option mismatch, dangerous goods by UN number, container/AWB check digits). Send mode (sea | air | road, default road) and lines[] (each line with its own dimension and weight units), or the legacy flat items[] in cm and kg. For a vehicle/container suggestion and duty estimates use shipment_summary; for one figure cbm_calculator / chargeable_weight_calculator / ldm_calculator; for what a flagged UN number is adr_lookup. 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. Flags are advisory and never state that a shipment is permitted or compliant; not regulatory, customs or dangerous-goods compliance advice.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"mode": {
"enum": [
"sea",
"air",
"road"
],
"type": "string",
"description": "Transport mode: sea | air | road. Default: road."
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The date the answer is for, YYYY-MM-DD (default today, UTC)."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"length",
"width",
"height",
"gross_weight"
],
"properties": {
"width": {
"type": "number",
"description": "Width in cm.",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"description": "Height in cm.",
"exclusiveMinimum": 0
},
"length": {
"type": "number",
"description": "Length in cm.",
"exclusiveMinimum": 0
},
"hs_code": {
"type": "string",
"description": "Optional HS commodity code"
},
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of pieces. Default: 1.",
"exclusiveMinimum": 0
},
"stackable": {
"type": "boolean",
"description": "Can the item be stacked?"
},
"un_number": {
"type": "string",
"description": "Optional UN number for dangerous-goods reference"
},
"description": {
"type": "string",
"description": "Item description."
},
"pallet_type": {
"enum": [
"none",
"euro",
"uk",
"us",
"custom"
],
"type": "string",
"description": "Pallet type (informational)."
},
"gross_weight": {
"type": "number",
"description": "Gross weight per piece in kg.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "Legacy flat alias — dimensions in cm, weight in kg. Prefer lines."
},
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"quantity",
"dims",
"weight"
],
"properties": {
"dims": {
"type": "object",
"required": [
"l",
"w",
"h",
"unit"
],
"properties": {
"h": {
"type": "number",
"description": "Height in the given unit.",
"exclusiveMinimum": 0
},
"l": {
"type": "number",
"description": "Length in the given unit.",
"exclusiveMinimum": 0
},
"w": {
"type": "number",
"description": "Width in the given unit.",
"exclusiveMinimum": 0
},
"unit": {
"enum": [
"mm",
"cm",
"m",
"in"
],
"type": "string",
"description": "Dimension unit."
}
},
"description": "Per-piece dimensions with unit.",
"additionalProperties": false
},
"weight": {
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"kg",
"g",
"t",
"lb"
],
"type": "string",
"description": "Weight unit."
},
"value": {
"type": "number",
"description": "Gross weight per piece.",
"exclusiveMinimum": 0
}
},
"description": "Per-piece weight with unit.",
"additionalProperties": false
},
"hs_code": {
"type": "string",
"pattern": "^\\d{6,10}$",
"description": "Optional HS commodity code (6-10 digits)."
},
"quantity": {
"type": "integer",
"maximum": 100000,
"description": "Number of identical pieces on this line.",
"exclusiveMinimum": 0
},
"stackable": {
"type": "boolean",
"description": "Stack two-high (halves the loading-metre footprint)."
},
"un_number": {
"type": "string",
"pattern": "^(UN)?\\d{4}$",
"description": "Optional UN number — triggers the dangerous-goods advisory flag."
},
"description": {
"type": "string",
"maxLength": 200,
"description": "Optional item label."
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "Canonical consignment lines (preferred, 1-50). Provide lines OR items."
},
"edition": {
"enum": [
"2025",
"2027"
],
"type": "string",
"description": "ADR edition; wins over as_of. Omitted: as_of picks it."
},
"options": {
"type": "object",
"properties": {
"awb_number": {
"type": "string",
"maxLength": 20,
"description": "IATA 11-digit air waybill number — check-digit validated into flags."
},
"container_number": {
"type": "string",
"maxLength": 20,
"description": "ISO 6346 container number — check-digit validated into flags."
},
"air_volumetric_divisor": {
"type": "number",
"maximum": 10000,
"description": "IATA volumetric divisor in cm³/kg. Default: 6000. Air mode only.",
"exclusiveMinimum": 0
}
},
"description": "Optional settings.",
"additionalProperties": false
},
"consignment": {
"type": "object",
"required": [
"lines"
],
"properties": {
"crew": {
"type": "object",
"properties": {
"specialisations": {
"type": "array",
"items": {
"enum": [
"class_1",
"class_7",
"tanks"
],
"type": "string"
},
"maxItems": 3
},
"photo_identification": {
"type": "boolean"
},
"awareness_training_1_3": {
"type": "boolean"
},
"adr_training_certificate": {
"type": "boolean"
}
},
"additionalProperties": false
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dims": {
"type": "object",
"required": [
"l",
"w",
"h",
"unit"
],
"properties": {
"h": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"l": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"w": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"unit": {
"enum": [
"mm",
"cm",
"m",
"in"
],
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"hs_code": {
"type": "string",
"pattern": "^\\d{6,10}$"
},
"packages": {
"type": "object",
"required": [
"count"
],
"properties": {
"type": {
"type": "string",
"maxLength": 40
},
"count": {
"type": "integer",
"maximum": 100000,
"exclusiveMinimum": 0
},
"un_mark": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"gross_kg": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"quantity": {
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"enum": [
"L",
"kg"
],
"type": "string"
},
"basis": {
"enum": [
"net",
"gross"
],
"type": "string"
},
"value": {
"type": "number",
"maximum": 1000000000,
"minimum": 0
}
},
"additionalProperties": false
},
"stackable": {
"type": "boolean"
},
"un_number": {
"type": "string",
"pattern": "^(?:(?:UN\\s?)?\\d{4}|ID\\s?\\d{4})$"
},
"description": {
"type": "string",
"maxLength": 200
},
"packing_group": {
"enum": [
"I",
"II",
"III"
],
"type": "string"
},
"variant_index": {
"type": "integer",
"maximum": 1000,
"minimum": 0
},
"inner_packaging": {
"type": "object",
"required": [
"quantity",
"unit"
],
"properties": {
"unit": {
"enum": [
"ml",
"L",
"g",
"kg"
],
"type": "string"
},
"regime": {
"enum": [
"lq",
"eq"
],
"type": "string"
},
"quantity": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
},
"per_outer": {
"type": "integer",
"maximum": 100000,
"minimum": 1
}
},
"additionalProperties": false
},
"icao_limited_quantity": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1
},
"journey": {
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"mode": {
"enum": [
"road",
"air",
"sea",
"multimodal"
],
"type": "string"
},
"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})?$"
},
"tunnels_on_route": {
"type": "array",
"items": {
"enum": [
"A",
"B",
"C",
"D",
"E"
],
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
},
"options": {
"type": "object",
"properties": {
"incoterm": {
"enum": [
"EXW",
"FCA",
"FAS",
"FOB",
"CFR",
"CIF",
"CPT",
"CIP",
"DAP",
"DPU",
"DDP"
],
"type": "string"
},
"awb_number": {
"type": "string",
"maxLength": 20
},
"freight_cost": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"insurance_cost": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"container_number": {
"type": "string",
"maxLength": 20
},
"air_volumetric_divisor": {
"type": "number",
"maximum": 10000,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"vehicle": {
"type": "object",
"properties": {
"type": {
"type": "string",
"maxLength": 60
},
"axles": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"max_mass_t": {
"type": "number",
"maximum": 100,
"exclusiveMinimum": 0
},
"equipment_8_1_5": {
"type": "array",
"items": {
"enum": [
"wheel_chock",
"warning_signs",
"eye_rinsing_liquid",
"warning_vest",
"portable_lighting",
"protective_gloves",
"eye_protection",
"emergency_escape_mask",
"shovel",
"drain_seal",
"collecting_container"
],
"type": "string"
},
"maxItems": 11
},
"foodstuffs_carried": {
"type": "boolean"
},
"placards_displayed": {
"type": "boolean"
},
"fire_extinguishers_kg": {
"type": "array",
"items": {
"type": "number",
"maximum": 100,
"exclusiveMinimum": 0
},
"maxItems": 20
},
"instructions_in_writing": {
"type": "boolean"
},
"orange_plates_displayed": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"description": "The consignment object, instead of the other arguments. Send it alone.",
"additionalProperties": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Consignment Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search 116,086 UN/LOCODE transport locations — ports, airports, rail and road terminals, inland container depots and border crossings (5 characters: country + location, e.g. NLRTM = Rotterdam; "GB LHR" reads as GBLHR). code gives an exact record; query searches names, narrowed by country and function_type; an unknown code errors. For airport records with ICAO codes use airport_lookup; for airports near a coordinate nearest_airport. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. An administrative code list — confirm operational status and coordinates with the port or authority.
| Parameter | Type | Description |
|---|---|---|
| code | string | Exact UN/LOCODE, 5 characters, optionally spaced ("GB LHR"). |
| codes | array | Batch: up to 50 UN/LOCODEs. Send alone. |
| limit | integer | Maximum results. Default: 20, max: 100. |
| query | string | Location name search. |
| country | string | 2-letter ISO country filter. |
| function_type | string | Filter by location function. |
{
"name": "unlocode_lookup",
"title": "UN/LOCODE Lookup",
"description": "Search 116,086 UN/LOCODE transport locations — ports, airports, rail and road terminals, inland container depots and border crossings (5 characters: country + location, e.g. NLRTM = Rotterdam; \"GB LHR\" reads as GBLHR). code gives an exact record; query searches names, narrowed by country and function_type; an unknown code errors. For airport records with ICAO codes use airport_lookup; for airports near a coordinate nearest_airport. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. An administrative code list — confirm operational status and coordinates with the port or authority.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"code": {
"type": "string",
"pattern": "^\\s*[A-Za-z]{2}[\\s-]?[A-Za-z0-9]{3}\\s*$",
"description": "Exact UN/LOCODE, 5 characters, optionally spaced (\"GB LHR\")."
},
"codes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 8
},
"maxItems": 50,
"minItems": 1,
"description": "Batch: up to 50 UN/LOCODEs. Send alone."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum results. Default: 20, max: 100."
},
"query": {
"type": "string",
"minLength": 2,
"description": "Location name search."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "2-letter ISO country filter."
},
"function_type": {
"enum": [
"port",
"airport",
"rail",
"road",
"icd",
"border"
],
"type": "string",
"description": "Filter by location function."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "UN/LOCODE Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Estimate UK import duty and VAT for a commodity code from the LIVE GOV.UK Trade Tariff: CIF = customs_value + freight_cost + insurance_cost (GBP); duty = CIF x the rate for the origin country; VAT on the duty-inclusive value. commodity_code must be the declarable 10 digits: a 6- or 8-digit code is refused — never padded with zeros — with the declarable codes beneath it. To find the code first use hs_code_lookup; for who pays these costs incoterms_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. An estimate, not a customs ruling — confirm with a customs broker or HMRC.
| Parameter | Type | Description |
|---|---|---|
| lines | array | Batch: up to 10 lines, each { commodity_code, origin_country, customs_value, freight_cost?, insurance_cost?, incoterm? }. Send alone. |
| incoterm | string | Incoterms 2020 basis of the customs_value — documents which costs are already included. |
| freight_cost | number | Freight cost in GBP, 0 or more — added to the CIF value. Default: 0. |
| customs_value | number | Goods value, GBP. Required unless lines[] is sent. |
| commodity_code | string | Required unless lines[] is sent. The declarable 10-digit UK commodity code, e.g. "8471300000". |
| insurance_cost | number | Insurance cost in GBP, 0 or more — added to the CIF value. Default: 0. |
| origin_country | string | Required unless lines[] is sent. ISO 2-letter country of origin. |
{
"name": "uk_duty_calculator",
"title": "UK Duty & VAT Calculator",
"description": "Estimate UK import duty and VAT for a commodity code from the LIVE GOV.UK Trade Tariff: CIF = customs_value + freight_cost + insurance_cost (GBP); duty = CIF x the rate for the origin country; VAT on the duty-inclusive value. commodity_code must be the declarable 10 digits: a 6- or 8-digit code is refused — never padded with zeros — with the declarable codes beneath it. To find the code first use hs_code_lookup; for who pays these costs incoterms_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. An estimate, not a customs ruling — confirm with a customs broker or HMRC.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"lines": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"maxItems": 10,
"minItems": 1,
"description": "Batch: up to 10 lines, each { commodity_code, origin_country, customs_value, freight_cost?, insurance_cost?, incoterm? }. Send alone."
},
"incoterm": {
"enum": [
"EXW",
"FCA",
"FAS",
"FOB",
"CFR",
"CIF",
"CPT",
"CIP",
"DAP",
"DPU",
"DDP"
],
"type": "string",
"description": "Incoterms 2020 basis of the customs_value — documents which costs are already included."
},
"freight_cost": {
"type": "number",
"minimum": 0,
"description": "Freight cost in GBP, 0 or more — added to the CIF value. Default: 0."
},
"customs_value": {
"type": "number",
"description": "Goods value, GBP. Required unless lines[] is sent.",
"exclusiveMinimum": 0
},
"commodity_code": {
"type": "string",
"pattern": "^[\\d\\s]{6,14}$",
"description": "Required unless lines[] is sent. The declarable 10-digit UK commodity code, e.g. \"8471300000\"."
},
"insurance_cost": {
"type": "number",
"minimum": 0,
"description": "Insurance cost in GBP, 0 or more — added to the CIF value. Default: 0."
},
"origin_country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Required unless lines[] is sent. ISO 2-letter country of origin."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "UK Duty & VAT Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Composite shipment analysis in one call: volume (CBM), gross and chargeable weight, and by mode road LDM with pallet floor positions and a suggested vehicle, air volumetric weight, or sea revenue tonnes with a suggested container; plus dangerous-goods presence for items with un_number and UK duty estimates for items with hs_code + customs_value. weight and customs_value are PER ITEM; adr_quantity is the TOTAL for the dangerous-goods line, all pieces together. An item with no stackable flag is not stacked. Sections that cannot run surface in warnings instead of failing the call. Its result uses camelCase field names (legacy shape). For canonical snake_case lines[] totals with advisory flags use consignment_calculator; single figures cbm_calculator, chargeable_weight_calculator, ldm_calculator; ldm_calculator, adr_lookup and uk_duty_calculator are the engines it calls. edition ("2025" | "2027") and as_of choose the ADR edition; neither sent, ADR 2025 until 2027-01-01. Fields are checked by name: a field the tool does not read is refused with a tool error naming it and listing the accepted ones, never ignored. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A planning summary, not a quotation or compliance determination.
| Parameter | Type | Description |
|---|---|---|
| mode | string | Transport mode — selects the mode-specific section of the result. Required unless consignment is sent. |
| as_of | string | The date the answer is for, YYYY-MM-DD (default today, UTC). |
| items | array | Required unless consignment is sent. Shipment items with dimensions, weight and optional HS/UN codes. |
| origin | object | Origin — ISO country code and optional UN/LOCODE. |
| edition | string | ADR edition; wins over as_of. Omitted: as_of picks it. |
| incoterm | string | Incoterms 2020 three-letter code. |
| consignment | object | The consignment object, instead of the other arguments. Send it alone. |
| destination | object | Destination — ISO country code and optional UN/LOCODE. |
| freight_cost | number | Freight cost in GBP for the duty calculation, 0 or more. Default: 0. |
| insurance_cost | number | Insurance cost in GBP for the duty calculation, 0 or more. Default: 0. |
{
"name": "shipment_summary",
"title": "Shipment Summary",
"description": "Composite shipment analysis in one call: volume (CBM), gross and chargeable weight, and by mode road LDM with pallet floor positions and a suggested vehicle, air volumetric weight, or sea revenue tonnes with a suggested container; plus dangerous-goods presence for items with un_number and UK duty estimates for items with hs_code + customs_value. weight and customs_value are PER ITEM; adr_quantity is the TOTAL for the dangerous-goods line, all pieces together. An item with no stackable flag is not stacked. Sections that cannot run surface in warnings instead of failing the call. Its result uses camelCase field names (legacy shape). For canonical snake_case lines[] totals with advisory flags use consignment_calculator; single figures cbm_calculator, chargeable_weight_calculator, ldm_calculator; ldm_calculator, adr_lookup and uk_duty_calculator are the engines it calls. edition (\"2025\" | \"2027\") and as_of choose the ADR edition; neither sent, ADR 2025 until 2027-01-01. Fields are checked by name: a field the tool does not read is refused with a tool error naming it and listing the accepted ones, never ignored. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A planning summary, not a quotation or compliance determination.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"mode": {
"enum": [
"road",
"air",
"sea",
"multimodal"
],
"type": "string",
"description": "Transport mode — selects the mode-specific section of the result. Required unless consignment is sent."
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The date the answer is for, YYYY-MM-DD (default today, UTC)."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"length",
"width",
"height",
"weight",
"quantity"
],
"properties": {
"width": {
"type": "number",
"description": "Width in cm.",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"description": "Height in cm.",
"exclusiveMinimum": 0
},
"length": {
"type": "number",
"description": "Length in cm.",
"exclusiveMinimum": 0
},
"weight": {
"type": "number",
"minimum": 0,
"description": "Gross weight in kg PER ITEM."
},
"hs_code": {
"type": "string",
"description": "HS code — enables the duty section together with customs_value."
},
"quantity": {
"type": "integer",
"maximum": 1000000,
"description": "Number of items.",
"exclusiveMinimum": 0
},
"stackable": {
"type": "boolean",
"description": "Whether this item can be stacked (affects pallet fitting)."
},
"un_number": {
"type": "string",
"description": "UN number — enables the dangerous-goods section."
},
"description": {
"type": "string",
"description": "Optional item label."
},
"pallet_type": {
"enum": [
"euro",
"uk",
"us",
"custom",
"none"
],
"type": "string",
"description": "Pallet standard the item sits on, if any."
},
"adr_quantity": {
"type": "number",
"maximum": 1000000000,
"description": "ADR 1.1.3.6.3 quantity of the dangerous goods, the TOTAL for the whole line (never per piece), in adr_quantity_unit; separate from weight.",
"exclusiveMinimum": 0
},
"customs_value": {
"type": "number",
"minimum": 0,
"description": "Customs value in GBP PER ITEM; enables the duty section with hs_code."
},
"adr_quantity_unit": {
"enum": [
"L",
"kg"
],
"type": "string",
"description": "Dimension of adr_quantity, checked against the one ADR 1.1.3.6.3 counts for the row."
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "Required unless consignment is sent. Shipment items with dimensions, weight and optional HS/UN codes."
},
"origin": {
"type": "object",
"required": [
"country"
],
"properties": {
"locode": {
"type": "string"
},
"country": {
"type": "string"
}
},
"description": "Origin — ISO country code and optional UN/LOCODE.",
"additionalProperties": false
},
"edition": {
"enum": [
"2025",
"2027"
],
"type": "string",
"description": "ADR edition; wins over as_of. Omitted: as_of picks it."
},
"incoterm": {
"type": "string",
"description": "Incoterms 2020 three-letter code."
},
"consignment": {
"type": "object",
"required": [
"lines"
],
"properties": {
"crew": {
"type": "object",
"properties": {
"specialisations": {
"type": "array",
"items": {
"enum": [
"class_1",
"class_7",
"tanks"
],
"type": "string"
},
"maxItems": 3
},
"photo_identification": {
"type": "boolean"
},
"awareness_training_1_3": {
"type": "boolean"
},
"adr_training_certificate": {
"type": "boolean"
}
},
"additionalProperties": false
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dims": {
"type": "object",
"required": [
"l",
"w",
"h",
"unit"
],
"properties": {
"h": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"l": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"w": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"unit": {
"enum": [
"mm",
"cm",
"m",
"in"
],
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"hs_code": {
"type": "string",
"pattern": "^\\d{6,10}$"
},
"packages": {
"type": "object",
"required": [
"count"
],
"properties": {
"type": {
"type": "string",
"maxLength": 40
},
"count": {
"type": "integer",
"maximum": 100000,
"exclusiveMinimum": 0
},
"un_mark": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"gross_kg": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"quantity": {
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"enum": [
"L",
"kg"
],
"type": "string"
},
"basis": {
"enum": [
"net",
"gross"
],
"type": "string"
},
"value": {
"type": "number",
"maximum": 1000000000,
"minimum": 0
}
},
"additionalProperties": false
},
"stackable": {
"type": "boolean"
},
"un_number": {
"type": "string",
"pattern": "^(?:(?:UN\\s?)?\\d{4}|ID\\s?\\d{4})$"
},
"description": {
"type": "string",
"maxLength": 200
},
"packing_group": {
"enum": [
"I",
"II",
"III"
],
"type": "string"
},
"variant_index": {
"type": "integer",
"maximum": 1000,
"minimum": 0
},
"inner_packaging": {
"type": "object",
"required": [
"quantity",
"unit"
],
"properties": {
"unit": {
"enum": [
"ml",
"L",
"g",
"kg"
],
"type": "string"
},
"regime": {
"enum": [
"lq",
"eq"
],
"type": "string"
},
"quantity": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
},
"per_outer": {
"type": "integer",
"maximum": 100000,
"minimum": 1
}
},
"additionalProperties": false
},
"icao_limited_quantity": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1
},
"journey": {
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"mode": {
"enum": [
"road",
"air",
"sea",
"multimodal"
],
"type": "string"
},
"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})?$"
},
"tunnels_on_route": {
"type": "array",
"items": {
"enum": [
"A",
"B",
"C",
"D",
"E"
],
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
},
"options": {
"type": "object",
"properties": {
"incoterm": {
"enum": [
"EXW",
"FCA",
"FAS",
"FOB",
"CFR",
"CIF",
"CPT",
"CIP",
"DAP",
"DPU",
"DDP"
],
"type": "string"
},
"awb_number": {
"type": "string",
"maxLength": 20
},
"freight_cost": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"insurance_cost": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"container_number": {
"type": "string",
"maxLength": 20
},
"air_volumetric_divisor": {
"type": "number",
"maximum": 10000,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"vehicle": {
"type": "object",
"properties": {
"type": {
"type": "string",
"maxLength": 60
},
"axles": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"max_mass_t": {
"type": "number",
"maximum": 100,
"exclusiveMinimum": 0
},
"equipment_8_1_5": {
"type": "array",
"items": {
"enum": [
"wheel_chock",
"warning_signs",
"eye_rinsing_liquid",
"warning_vest",
"portable_lighting",
"protective_gloves",
"eye_protection",
"emergency_escape_mask",
"shovel",
"drain_seal",
"collecting_container"
],
"type": "string"
},
"maxItems": 11
},
"foodstuffs_carried": {
"type": "boolean"
},
"placards_displayed": {
"type": "boolean"
},
"fire_extinguishers_kg": {
"type": "array",
"items": {
"type": "number",
"maximum": 100,
"exclusiveMinimum": 0
},
"maxItems": 20
},
"instructions_in_writing": {
"type": "boolean"
},
"orange_plates_displayed": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"description": "The consignment object, instead of the other arguments. Send it alone.",
"additionalProperties": false
},
"destination": {
"type": "object",
"required": [
"country"
],
"properties": {
"locode": {
"type": "string"
},
"country": {
"type": "string"
}
},
"description": "Destination — ISO country code and optional UN/LOCODE.",
"additionalProperties": false
},
"freight_cost": {
"type": "number",
"minimum": 0,
"description": "Freight cost in GBP for the duty calculation, 0 or more. Default: 0."
},
"insurance_cost": {
"type": "number",
"minimum": 0,
"description": "Insurance cost in GBP for the duty calculation, 0 or more. Default: 0."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Shipment Summary",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Air-cargo ULD (unit load device) specifications — 16 types: lower-deck containers (AKE/LD3 and family), main-deck pallets (PMC, PAG and family) and temperature-controlled units. type as an IATA code ("AKE"), slug ("ake-ld3") or the record's own name ("LD3" → AKE) gives one record; omit it to list all 16; category and deck filter. Pallet records have no internal dimensions — read max_build_up_height_cm, and do not multiply dimensions for a volume. For the sea-freight equivalent use container_lookup; for what the cargo inside is billed at chargeable_weight_calculator; for whose aircraft it flies on airline_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Provenance is pending, not verified (treat tare_weight with particular caution); confirm operationally critical dimensions with the carrier.
| Parameter | Type | Description |
|---|---|---|
| deck | string | Filter by deck position. |
| full | boolean | Lists only: true returns full records instead of summary rows. |
| type | string | IATA ULD code ("AKE") or slug. Omit to list all. |
| limit | integer | Lists only: rows per page. |
| offset | integer | Lists only: rows to skip (default 0). |
| category | string | Filter by ULD category. |
{
"name": "uld_lookup",
"title": "Air Cargo ULD Lookup",
"description": "Air-cargo ULD (unit load device) specifications — 16 types: lower-deck containers (AKE/LD3 and family), main-deck pallets (PMC, PAG and family) and temperature-controlled units. type as an IATA code (\"AKE\"), slug (\"ake-ld3\") or the record's own name (\"LD3\" → AKE) gives one record; omit it to list all 16; category and deck filter. Pallet records have no internal dimensions — read max_build_up_height_cm, and do not multiply dimensions for a volume. For the sea-freight equivalent use container_lookup; for what the cargo inside is billed at chargeable_weight_calculator; for whose aircraft it flies on airline_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Provenance is pending, not verified (treat tare_weight with particular caution); confirm operationally critical dimensions with the carrier.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"deck": {
"enum": [
"lower",
"main"
],
"type": "string",
"description": "Filter by deck position."
},
"full": {
"type": "boolean",
"description": "Lists only: true returns full records instead of summary rows."
},
"type": {
"type": "string",
"minLength": 2,
"description": "IATA ULD code (\"AKE\") or slug. Omit to list all."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Lists only: rows per page."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Lists only: rows to skip (default 0)."
},
"category": {
"enum": [
"container",
"pallet",
"special"
],
"type": "string",
"description": "Filter by ULD category."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Air Cargo ULD Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Road-freight vehicle and trailer specifications — 17 types: EU articulated trailers, US 53ft/48ft dry vans, rigid trucks (7.5-26 t) and vans; internal dimensions, payload and gross weights, pallet capacity, axles. slug gives one record; omit it to list all 17; category (articulated | rigid | van) and region (EU | US) filter. For whether a pallet load fits use ldm_calculator; also pallet_fitting_calculator and consignment_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Typical specs, provenance pending — legal payload is set by the vehicle's plated weights.
| Parameter | Type | Description |
|---|---|---|
| full | boolean | Lists only: true returns full records instead of summary rows. |
| slug | string | Vehicle slug ("standard-curtainsider"). Omit to list all. |
| limit | integer | Lists only: rows per page. |
| offset | integer | Lists only: rows to skip (default 0). |
| region | string | Filter by region. |
| category | string | Filter by vehicle category. |
{
"name": "vehicle_lookup",
"title": "Vehicle Lookup",
"description": "Road-freight vehicle and trailer specifications — 17 types: EU articulated trailers, US 53ft/48ft dry vans, rigid trucks (7.5-26 t) and vans; internal dimensions, payload and gross weights, pallet capacity, axles. slug gives one record; omit it to list all 17; category (articulated | rigid | van) and region (EU | US) filter. For whether a pallet load fits use ldm_calculator; also pallet_fitting_calculator and consignment_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Typical specs, provenance pending — legal payload is set by the vehicle's plated weights.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"full": {
"type": "boolean",
"description": "Lists only: true returns full records instead of summary rows."
},
"slug": {
"type": "string",
"minLength": 2,
"description": "Vehicle slug (\"standard-curtainsider\"). Omit to list all."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Lists only: rows per page."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Lists only: rows to skip (default 0)."
},
"region": {
"enum": [
"EU",
"US"
],
"type": "string",
"description": "Filter by region."
},
"category": {
"enum": [
"articulated",
"rigid",
"van"
],
"type": "string",
"description": "Filter by vehicle category."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Vehicle Lookup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Return the FreightUtils pricing page URL with the Pro plan's request limit (50,000 per month) and price. Use when the user asks about FreightUtils plans, pricing or API limits. A static local response — no API call, never rate-limited, no account or payment action; the user opens the URL in a browser.
| Parameter | Type | Description |
|---|---|---|
| tier | string | Tier to surface. Only "pro" is supported today. |
{
"name": "get_subscribe_link",
"title": "FreightUtils Plans & Pricing",
"description": "Return the FreightUtils pricing page URL with the Pro plan's request limit (50,000 per month) and price. Use when the user asks about FreightUtils plans, pricing or API limits. A static local response — no API call, never rate-limited, no account or payment action; the user opens the URL in a browser.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tier": {
"enum": [
"pro"
],
"type": "string",
"description": "Tier to surface. Only \"pro\" is supported today."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "FreightUtils Plans & Pricing",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Whether dangerous goods qualify for ADR Limited Quantity (LQ, ADR 3.4) or Excepted Quantity (EQ, ADR 3.5) relief, item by item. Send mode ("lq" or "eq") and 1-20 items, each with un_number, quantity per INNER packaging (not the whole load) and unit (ml or L for liquids, g or kg for solids); inner_packaging_qty adds the EQ per-outer check. A mass against a volume limit (or the reverse) cannot be compared: that item is inconclusive — send the unit given by lq_limit_unit. A UN number whose Table A rows disagree needs packing_group or variant_index, else no verdict for it (AMBIGUOUS_UN_VARIANT with candidates[]). For the 1.1.3.6 load-points route use adr_exemption_calculator; for the per-substance LQ/EQ values and variant_index adr_lookup. edition ("2025" | "2027") and as_of choose the ADR edition; neither sent, ADR 2025 until 2027-01-01. Fields are checked by name: a field the tool does not read is refused with a tool error naming it and listing the accepted ones, never ignored. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A quantity-threshold check only — packaging, marking and documentation conformity are not assessed; not legal advice, verify against the current UNECE ADR text.
| Parameter | Type | Description |
|---|---|---|
| mode * | string | lq (Limited Quantity, ADR 3.4) or eq (Excepted Quantity, ADR 3.5). |
| as_of | string | The date the answer is for, YYYY-MM-DD (default today, UTC). |
| items * | array | Items to check (1-20 per call). |
| edition | string | ADR edition; wins over as_of. Omitted: as_of picks it. |
{
"name": "adr_lq_eq_check",
"title": "ADR LQ / EQ Exemption Check",
"description": "Whether dangerous goods qualify for ADR Limited Quantity (LQ, ADR 3.4) or Excepted Quantity (EQ, ADR 3.5) relief, item by item. Send mode (\"lq\" or \"eq\") and 1-20 items, each with un_number, quantity per INNER packaging (not the whole load) and unit (ml or L for liquids, g or kg for solids); inner_packaging_qty adds the EQ per-outer check. A mass against a volume limit (or the reverse) cannot be compared: that item is inconclusive — send the unit given by lq_limit_unit. A UN number whose Table A rows disagree needs packing_group or variant_index, else no verdict for it (AMBIGUOUS_UN_VARIANT with candidates[]). For the 1.1.3.6 load-points route use adr_exemption_calculator; for the per-substance LQ/EQ values and variant_index adr_lookup. edition (\"2025\" | \"2027\") and as_of choose the ADR edition; neither sent, ADR 2025 until 2027-01-01. Fields are checked by name: a field the tool does not read is refused with a tool error naming it and listing the accepted ones, never ignored. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A quantity-threshold check only — packaging, marking and documentation conformity are not assessed; not legal advice, verify against the current UNECE ADR text.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mode",
"items"
],
"properties": {
"mode": {
"enum": [
"lq",
"eq"
],
"type": "string",
"description": "lq (Limited Quantity, ADR 3.4) or eq (Excepted Quantity, ADR 3.5)."
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The date the answer is for, YYYY-MM-DD (default today, UTC)."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"un_number",
"quantity",
"unit"
],
"properties": {
"unit": {
"enum": [
"ml",
"L",
"g",
"kg"
],
"type": "string",
"description": "Unit: \"ml\" or \"L\" for liquids, \"g\" or \"kg\" for solids."
},
"quantity": {
"type": "number",
"maximum": 1000000000,
"description": "Quantity per INNER packaging, in unit.",
"exclusiveMinimum": 0
},
"un_number": {
"type": "string",
"pattern": "^\\s*(?:UN\\s*)?\\d{4}\\s*$",
"description": "UN number, 4 digits, optionally \"UN\"-prefixed (\"0004\" keeps its zero)."
},
"packing_group": {
"enum": [
"I",
"II",
"III"
],
"type": "string",
"description": "Packing group, to pin one row of a multi-row UN."
},
"variant_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "ADR Table A variant index (from adr_lookup), to pin one row."
},
"inner_packaging_qty": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EQ mode only: inner packagings per outer package.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1,
"description": "Items to check (1-20 per call)."
},
"edition": {
"enum": [
"2025",
"2027"
],
"type": "string",
"description": "ADR edition; wins over as_of. Omitted: as_of picks it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "ADR LQ / EQ Exemption Check",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Estimate freight transport greenhouse-gas emissions (kgCO2e) for one shipment leg, per ISO 14083:2023 / GLEC Framework v3.2: mass x distance x a published emission-intensity factor (DEFRA, EPA or ADEME by region). Pass ACTUAL GROSS MASS, not chargeable/volumetric weight, and a distance you provide — this tool does NOT route, geocode or compute distances. The fleet-average factor already includes average empty running: do not add an empty-return leg. An unknown mode/sub_mode/region returns available:false with the covered options. Distinct from cbm_calculator / ldm_calculator / chargeable_weight_calculator, which size or bill a shipment. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A best-effort reference estimate, not a verified or audited carbon report.
| Parameter | Type | Description |
|---|---|---|
| mass * | number | Actual gross shipment mass, in mass_unit. |
| mode * | string | Transport mode. |
| basis | string | wtw = well-to-wheel (default), ttw = tank-to-wheel. |
| region | string | Factor source: uk = DEFRA, us = EPA, fr = ADEME. Default per mode. |
| sub_mode | string | Sub-mode / vehicle class (e.g. "articulated"); omit for the representative default. |
| mass_unit | string | Unit for mass. Default: kg. |
| distance_km * | number | Transport distance, km (you provide it). |
{
"name": "emissions_calculator",
"title": "Freight Emissions Calculator",
"description": "Estimate freight transport greenhouse-gas emissions (kgCO2e) for one shipment leg, per ISO 14083:2023 / GLEC Framework v3.2: mass x distance x a published emission-intensity factor (DEFRA, EPA or ADEME by region). Pass ACTUAL GROSS MASS, not chargeable/volumetric weight, and a distance you provide — this tool does NOT route, geocode or compute distances. The fleet-average factor already includes average empty running: do not add an empty-return leg. An unknown mode/sub_mode/region returns available:false with the covered options. Distinct from cbm_calculator / ldm_calculator / chargeable_weight_calculator, which size or bill a shipment. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A best-effort reference estimate, not a verified or audited carbon report.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mass",
"distance_km",
"mode"
],
"properties": {
"mass": {
"type": "number",
"description": "Actual gross shipment mass, in mass_unit.",
"exclusiveMinimum": 0
},
"mode": {
"enum": [
"road",
"rail",
"sea",
"air",
"inland_waterway"
],
"type": "string",
"description": "Transport mode."
},
"basis": {
"enum": [
"wtw",
"ttw"
],
"type": "string",
"description": "wtw = well-to-wheel (default), ttw = tank-to-wheel."
},
"region": {
"enum": [
"uk",
"us",
"fr"
],
"type": "string",
"description": "Factor source: uk = DEFRA, us = EPA, fr = ADEME. Default per mode."
},
"sub_mode": {
"type": "string",
"description": "Sub-mode / vehicle class (e.g. \"articulated\"); omit for the representative default."
},
"mass_unit": {
"enum": [
"kg",
"tonnes"
],
"type": "string",
"description": "Unit for mass. Default: kg."
},
"distance_km": {
"type": "number",
"description": "Transport distance, km (you provide it).",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Freight Emissions Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Validate freight identifiers by their public check-digit algorithms: shipping container numbers (ISO 6346), air waybill numbers (IATA modulus-7) and IMO ship numbers. text finds and validates every identifier in a string; value + type validates one (value without type is refused); type "consignment" with consignment validates a consignment object. An AWB names its airline only when one record holds the prefix; otherwise airline_candidates[] lists every holder, never a guessed carrier. AWB: airline prefix + the airline from the AWB-prefix dataset when ONE record holds the prefix — when several do (e.g. 020: Lufthansa and Lufthansa Cargo), airline is null and airline_candidates[] lists every holder with airline_note saying why, never a guessed carrier. For container TYPE specs use container_lookup; for the AWB-prefix dataset airline_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Structural only — a valid check digit means well-formed, NOT that the container, shipment or vessel exists.
| Parameter | Type | Description |
|---|---|---|
| text | string | Free text to scan for container / AWB / IMO identifiers. Provide this OR value + type. |
| type | string | Type of value: container (ISO 6346), awb, imo; or consignment with the consignment argument. |
| value | string | One identifier to validate; requires type. |
| consignment | object | With type "consignment": the consignment object to validate. |
{
"name": "validate",
"title": "Freight Identifier Validator",
"description": "Validate freight identifiers by their public check-digit algorithms: shipping container numbers (ISO 6346), air waybill numbers (IATA modulus-7) and IMO ship numbers. text finds and validates every identifier in a string; value + type validates one (value without type is refused); type \"consignment\" with consignment validates a consignment object. An AWB names its airline only when one record holds the prefix; otherwise airline_candidates[] lists every holder, never a guessed carrier. AWB: airline prefix + the airline from the AWB-prefix dataset when ONE record holds the prefix — when several do (e.g. 020: Lufthansa and Lufthansa Cargo), airline is null and airline_candidates[] lists every holder with airline_note saying why, never a guessed carrier. For container TYPE specs use container_lookup; for the AWB-prefix dataset airline_lookup. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Structural only — a valid check digit means well-formed, NOT that the container, shipment or vessel exists.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"text": {
"type": "string",
"description": "Free text to scan for container / AWB / IMO identifiers. Provide this OR value + type."
},
"type": {
"enum": [
"container",
"awb",
"imo",
"consignment"
],
"type": "string",
"description": "Type of value: container (ISO 6346), awb, imo; or consignment with the consignment argument."
},
"value": {
"type": "string",
"description": "One identifier to validate; requires type."
},
"consignment": {
"type": "object",
"description": "With type \"consignment\": the consignment object to validate.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Freight Identifier Validator",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check a goods description against the official EU ICS2 stop-words list — terms too vague or generic for an entry summary declaration (ENS) goods description. A standalone stop-word means automatic rejection, an embedded one means make the description more specific; clean=true means no listed term matched, not that it will be accepted. For commodity codes use hs_code_lookup; for duty/VAT uk_duty_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Strictly a reference check — not an ENS filing, not a customs-compliance determination, not legal advice.
| Parameter | Type | Description |
|---|---|---|
| description * | string | The goods description to check. |
{
"name": "ics2_check",
"title": "ICS2 Stop-Words Checker",
"description": "Check a goods description against the official EU ICS2 stop-words list — terms too vague or generic for an entry summary declaration (ENS) goods description. A standalone stop-word means automatic rejection, an embedded one means make the description more specific; clean=true means no listed term matched, not that it will be accepted. For commodity codes use hs_code_lookup; for duty/VAT uk_duty_calculator. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Strictly a reference check — not an ENS filing, not a customs-compliance determination, not legal advice.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"description"
],
"properties": {
"description": {
"type": "string",
"description": "The goods description to check."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "ICS2 Stop-Words Checker",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| crew | object | The crew, for the driver-training and document checks. Facts only — no name. |
| as_of | string | The date the answer is for, YYYY-MM-DD (default today, UTC). |
| lines * | array | The lines of the load (1–50). Required. |
| edition | string | ADR edition; wins over as_of. Omitted: as_of picks it. |
| journey | object | |
| options | object | The consignment object's options; not read by this check. |
| vehicle | object | The vehicle-side inputs (ADR 5.3, 7.5.4, 8.1). |
{
"name": "adr_consignment_check",
"title": "ADR Consignment Check",
"description": "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.\n\nSend 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"lines"
],
"properties": {
"crew": {
"type": "object",
"properties": {
"specialisations": {
"type": "array",
"items": {
"enum": [
"class_1",
"class_7",
"tanks"
],
"type": "string"
},
"maxItems": 3,
"description": "The specialisations on the certificate."
},
"photo_identification": {
"type": "boolean",
"description": "Each crew member carries identification with a photograph (8.1.2.1 (d))."
},
"awareness_training_1_3": {
"type": "boolean",
"description": "The driver is trained according to Chapter 1.3 (8.2.3)."
},
"adr_training_certificate": {
"type": "boolean",
"description": "The driver holds the ADR 8.2.1 training certificate."
}
},
"description": "The crew, for the driver-training and document checks. Facts only — no name.",
"additionalProperties": false
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The date the answer is for, YYYY-MM-DD (default today, UTC)."
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dims": {
"type": "object",
"required": [
"l",
"w",
"h",
"unit"
],
"properties": {
"h": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"l": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"w": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"unit": {
"enum": [
"mm",
"cm",
"m",
"in"
],
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"hs_code": {
"type": "string",
"pattern": "^\\d{6,10}$"
},
"packages": {
"type": "object",
"required": [
"count"
],
"properties": {
"type": {
"type": "string",
"maxLength": 40
},
"count": {
"type": "integer",
"maximum": 100000,
"exclusiveMinimum": 0
},
"un_mark": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The UN packaging mark as printed (ADR 6.1.3.1), e.g. \"UN 4G/Y145/S/02/NL/VL823\"."
},
"gross_kg": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
}
},
"description": "The pieces; a line in packages is \"other carriage\" for the ADR 8.6.4 tunnel table.",
"additionalProperties": false
},
"quantity": {
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"enum": [
"L",
"kg"
],
"type": "string",
"description": "L or kg, checked against the dimension ADR 1.1.3.6.3 counts."
},
"basis": {
"enum": [
"net",
"gross"
],
"type": "string",
"description": "\"net\" or \"gross\"; a gross mass on a mass-counted row is an upper bound."
},
"value": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "The dangerous-goods quantity for the whole line, all packages together; 0 = not carried."
}
},
"description": "The dangerous-goods quantity (ADR 1.1.3.6.3).",
"additionalProperties": false
},
"stackable": {
"type": "boolean"
},
"un_number": {
"type": "string",
"pattern": "^(?:(?:UN\\s?)?\\d{4}|ID\\s?\\d{4})$",
"description": "UN number (\"1203\", \"UN1203\") or ID-prefixed air-only number (\"ID 8000\"); a line without one is not a dangerous-goods line."
},
"description": {
"type": "string",
"maxLength": 200,
"description": "What the line is, at most 200 characters."
},
"packing_group": {
"enum": [
"I",
"II",
"III"
],
"type": "string",
"description": "Packing group, to pin one ADR Table A row of a multi-row UN."
},
"variant_index": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "ADR Table A variant index (as adr_lookup returns it), to pin one row."
},
"inner_packaging": {
"type": "object",
"required": [
"quantity",
"unit"
],
"properties": {
"unit": {
"enum": [
"ml",
"L",
"g",
"kg"
],
"type": "string"
},
"regime": {
"enum": [
"lq",
"eq"
],
"type": "string",
"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."
},
"quantity": {
"type": "number",
"maximum": 1000000,
"description": "The quantity in ONE inner packaging.",
"exclusiveMinimum": 0
},
"per_outer": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Inner packagings in one outer packaging (default 1) — the excepted-quantity outer limit."
}
},
"description": "The inner packaging, for the limited / excepted quantity check.",
"additionalProperties": false
},
"icao_limited_quantity": {
"type": "boolean",
"description": "ID-prefixed line only: the packages are ICAO Technical Instructions limited quantities (3.4.8 mark / 3.4.10)."
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "The lines of the load (1–50). Required."
},
"edition": {
"enum": [
"2025",
"2027"
],
"type": "string",
"description": "ADR edition; wins over as_of. Omitted: as_of picks it."
},
"journey": {
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date of carriage, YYYY-MM-DD — the default as_of."
},
"mode": {
"enum": [
"road",
"air",
"sea",
"multimodal"
],
"type": "string"
},
"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})?$"
},
"tunnels_on_route": {
"type": "array",
"items": {
"enum": [
"A",
"B",
"C",
"D",
"E"
],
"type": "string"
},
"maxItems": 20,
"description": "ADR tunnel categories on the route (A–E)."
}
},
"additionalProperties": false
},
"options": {
"type": "object",
"properties": {
"incoterm": {
"enum": [
"EXW",
"FCA",
"FAS",
"FOB",
"CFR",
"CIF",
"CPT",
"CIP",
"DAP",
"DPU",
"DDP"
],
"type": "string"
},
"awb_number": {
"type": "string",
"maxLength": 20
},
"freight_cost": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"insurance_cost": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"container_number": {
"type": "string",
"maxLength": 20
},
"air_volumetric_divisor": {
"type": "number",
"maximum": 10000,
"exclusiveMinimum": 0
}
},
"description": "The consignment object's options; not read by this check.",
"additionalProperties": false
},
"vehicle": {
"type": "object",
"properties": {
"type": {
"type": "string",
"maxLength": 60
},
"axles": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"max_mass_t": {
"type": "number",
"maximum": 100,
"description": "The transport unit's maximum permissible mass, tonnes.",
"exclusiveMinimum": 0
},
"equipment_8_1_5": {
"type": "array",
"items": {
"enum": [
"wheel_chock",
"warning_signs",
"eye_rinsing_liquid",
"warning_vest",
"portable_lighting",
"protective_gloves",
"eye_protection",
"emergency_escape_mask",
"shovel",
"drain_seal",
"collecting_container"
],
"type": "string"
},
"maxItems": 11,
"description": "The ADR 8.1.5 items on board; an item not listed is read as not on board."
},
"foodstuffs_carried": {
"type": "boolean",
"description": "Foodstuffs or animal feeds are carried in the same vehicle or container (ADR 7.5.4)."
},
"placards_displayed": {
"type": "boolean",
"description": "The placards ADR 5.3.1.5 requires are displayed."
},
"fire_extinguishers_kg": {
"type": "array",
"items": {
"type": "number",
"maximum": 100,
"exclusiveMinimum": 0
},
"maxItems": 20,
"description": "Each portable fire extinguisher on board, kg (ADR 8.1.4)."
},
"instructions_in_writing": {
"type": "boolean",
"description": "The ADR 5.4.3 instructions in writing are in the cab."
},
"orange_plates_displayed": {
"type": "boolean",
"description": "The two orange-coloured plates are displayed."
}
},
"description": "The vehicle-side inputs (ADR 5.3, 7.5.4, 8.1).",
"additionalProperties": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"status",
"missing_inputs",
"edition",
"as_of",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "ADR Consignment Check",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check a road booking before the job is created: from the booking's fields it returns three lists — MISSING (fields the booking lacks, each with the calculation that needs it), NEEDS (volume, gross and chargeable weight, loading metres, whether the load fits the booked vehicle, the ADR consignment check's result for dangerous goods) and STOPS (a code that does not resolve, a load the vehicle cannot take, a dangerous-goods check that fails or refuses) — and a verdict: no_blocker_found, missing_information or blocker_found. Use it as an intake agent's gate between reading a booking and creating the job; for dangerous goods alone use adr_consignment_check, for volume and chargeable weight alone consignment_calculator. Road only in this version. It composes the existing calculators and lookups and adds no rule; every line cites the engine it came from. Short by default; detail: true adds each engine's full answer. Nothing is stored; party names, addresses and free text are ignored and never echoed. Not a booking system, no rate, route, drivers' hours or legal clearance; a clean answer means no engine found a blocker in the fields sent. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.
| Parameter | Type | Description |
|---|---|---|
| date | string | Date of carriage (YYYY-MM-DD) for the dangerous-goods check; picks the ADR edition. |
| mode | string | Transport mode. This version answers "road" only. |
| detail | boolean | true adds each engine's full answer and the receipt's hashed fields. Default false (short). |
| origin | string | Origin as a UN/LOCODE (5 characters, e.g. GBMNC), an IATA airport code (3 letters) or an ISO 3166 country code (2 letters). |
| pieces | array | The pieces, 1–50 lines: { quantity, dims: { l, w, h, unit: mm|cm|m|in }, weight: { value, unit: kg|g|t|lb } per piece, stackable? }. A line without dims or weight is listed as missing. |
| vehicle | string | The booked vehicle, as a vehicle_lookup slug (e.g. standard-curtainsider, 7-5t-rigid, luton-van). Leave it out when none is booked. |
| destination | string | Destination, as origin. |
| dangerous_goods | array | Dangerous-goods lines, exactly as adr_consignment_check takes its lines[] (un_number, packing_group, quantity { value, unit, basis }, packages …). |
| tunnels_on_route | array | Tunnel categories on the route (B, C, D, E) for the dangerous-goods check. |
{
"name": "booking_check",
"title": "Booking Check",
"description": "Check a road booking before the job is created: from the booking's fields it returns three lists — MISSING (fields the booking lacks, each with the calculation that needs it), NEEDS (volume, gross and chargeable weight, loading metres, whether the load fits the booked vehicle, the ADR consignment check's result for dangerous goods) and STOPS (a code that does not resolve, a load the vehicle cannot take, a dangerous-goods check that fails or refuses) — and a verdict: no_blocker_found, missing_information or blocker_found. Use it as an intake agent's gate between reading a booking and creating the job; for dangerous goods alone use adr_consignment_check, for volume and chargeable weight alone consignment_calculator. Road only in this version. It composes the existing calculators and lookups and adds no rule; every line cites the engine it came from. Short by default; detail: true adds each engine's full answer. Nothing is stored; party names, addresses and free text are ignored and never echoed. Not a booking system, no rate, route, drivers' hours or legal clearance; a clean answer means no engine found a blocker in the fields sent. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"description": "Date of carriage (YYYY-MM-DD) for the dangerous-goods check; picks the ADR edition."
},
"mode": {
"type": "string",
"description": "Transport mode. This version answers \"road\" only."
},
"detail": {
"type": "boolean",
"description": "true adds each engine's full answer and the receipt's hashed fields. Default false (short)."
},
"origin": {
"type": "string",
"description": "Origin as a UN/LOCODE (5 characters, e.g. GBMNC), an IATA airport code (3 letters) or an ISO 3166 country code (2 letters)."
},
"pieces": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "The pieces, 1–50 lines: { quantity, dims: { l, w, h, unit: mm|cm|m|in }, weight: { value, unit: kg|g|t|lb } per piece, stackable? }. A line without dims or weight is listed as missing."
},
"vehicle": {
"type": "string",
"description": "The booked vehicle, as a vehicle_lookup slug (e.g. standard-curtainsider, 7-5t-rigid, luton-van). Leave it out when none is booked."
},
"destination": {
"type": "string",
"description": "Destination, as origin."
},
"dangerous_goods": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Dangerous-goods lines, exactly as adr_consignment_check takes its lines[] (un_number, packing_group, quantity { value, unit, basis }, packages …)."
},
"tunnels_on_route": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tunnel categories on the route (B, C, D, E) for the dangerous-goods check."
}
},
"additionalProperties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"envelope_version",
"ok",
"result",
"confidence",
"_source",
"citation"
],
"properties": {
"ok": {
"type": "boolean"
},
"_meta": {
"type": "object",
"properties": {
"receipt": {
"type": "object",
"required": [
"stored",
"reason",
"schema_version",
"receipt_hash",
"created_at"
],
"properties": {
"reason": {
"type": "string",
"const": "never_stored"
},
"stored": {
"type": "boolean",
"const": false
},
"created_at": {
"type": "string"
},
"receipt_hash": {
"type": "string"
},
"schema_version": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"additionalProperties": {}
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"ok",
"partial",
"not_found",
"unsupported",
"ambiguous"
],
"type": "string"
},
"_source": {
"type": "object",
"required": [
"name",
"checked",
"provenance_status"
],
"properties": {
"name": {
"type": "string"
},
"checked": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"dataset_edition": {
"type": "string"
},
"provenance_status": {
"enum": [
"verified",
"pending-verification",
"computed",
"live"
],
"type": "string"
},
"authority_current_edition": {
"type": "string"
}
},
"additionalProperties": false
},
"edition": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"applies_from",
"may_apply_until"
],
"properties": {
"name": {
"type": "string"
},
"applies_from": {
"type": [
"string",
"null"
]
},
"may_apply_until": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"qualifier": {
"type": "string"
}
},
"additionalProperties": false
},
"validity": {
"type": "object",
"required": [
"as_of"
],
"properties": {
"as_of": {
"type": "string"
},
"effective_to": {
"type": [
"string",
"null"
]
},
"effective_from": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "object",
"required": [
"level",
"basis"
],
"properties": {
"basis": {
"enum": [
"deterministic",
"provenance",
"match_quality",
"freshness"
],
"type": "string"
},
"level": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blocking_errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message",
"recovery"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"action"
],
"properties": {
"tool": {
"type": "string"
},
"action": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"envelope_version": {
"enum": [
"1",
"1.1",
"1.2"
],
"type": "string"
},
"normalized_input": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Booking Check",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Rules every FreightUtils tool shares: - structuredContent is the FreightUtils response envelope: the answer under result, plus confidence, _source and citation. - Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. - Fields are checked by name: a field the tool does not read is refused with a tool error naming it and listing the accepted ones, never ignored. - ADR editions: edition ("2025" | "2027") and as_of (YYYY-MM-DD) choose the ADR edition — edition wins, else the date picks it (ADR 2025 before 2027-01-01, ADR 2027 from then; ADR 2025 may still be applied until 2027-06-30). An answer on a named edition carries adr_edition; neither sent, the answer is ADR 2025 until 2027-01-01. - Identifiers: Each record carries fu_id, a stable FreightUtils identifier (and fu_version_id where the dataset has editions); resolve_reference resolves one to exactly its record. - Lists: A list (no single record asked for) returns summary rows with total, truncated, next_offset and detail_hint; full: true returns full records five per page, with offset / limit to page. - Batch arguments (codes, un_numbers, lines): send alone; answered as results[] in input order, each with its own status. One call against the daily limit, N against the Pro monthly allowance. - consignment: the consignment object (https://www.freightutils.com/schema/consignment-object.v1.json) may replace a tool's other arguments; send it alone; an input the tool needs and the object lacks comes back in missing_inputs.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.