FreightUtils MCP Server

Freight Identifier Validator

validate

Read-onlyIdempotent

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

Two modes: pass text= to find and validate every identifier in it (e.g. a booking-email line), OR pass value= + type=<container|awb|imo> to validate one.

Behavior: deterministic check-digit arithmetic; per identifier found it reports type, the normalised form, valid (pass/fail), expected vs actual check digit, and details (container: owner prefix + equipment category; 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; IMO: the 7-digit number); text mode with no identifiers found returns an empty found[] with a note. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.

Returns: found[] (each entry with its own _source naming the standard applied) and disclaimer under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).

Limitations: STRUCTURAL ONLY — a valid check digit means well-formed, NOT that the container, shipment or vessel exists or is active; not a registry or tracking lookup.

Related: container_lookup (container TYPE specs, not numbers), airline_lookup (the AWB-prefix dataset the airline resolution uses).

Input Schema

TableJSON Schema

Name	Required	Description
`text`	No	Arbitrary string to scan for container / AWB / IMO identifiers (parse mode). Provide this OR value+type.
`type`	No	Identifier type for value: container = ISO 6346, awb = IATA Air Waybill, imo = IMO ship number.
`value`	No	A single identifier to validate (typed mode). Requires type.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`ok`	Yes
`result`	Yes
`_source`	Yes
`citation`	Yes
`validity`	No
`warnings`	No
`confidence`	Yes
`blocking_errors`	No
`envelope_version`	Yes
`normalized_input`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 8, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```
Changed5 schema fields changedAug 11, 2026
- addedOutput schema / properties / _source / properties / authority_current_edition
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / _source / properties / checked_at
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / _source / properties / dataset_edition
```
Added value: +{
+  "type": "string"
+}
```
- removedOutput schema / properties / envelope_version / const
```
Removed value: -"1"
```
- addedOutput schema / properties / envelope_version / enum
```
Added value: +[
+  "1",
+  "1.1"
+]
```

Changed14 schema fields changedJul 9, 2026

addedOutput schema / properties / _source

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "checked": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "provenance_status": {
+      "enum": [
+        "verified",
+        "pending-verification",
+        "computed",
+        "live"
+      ],
+      "type": "string"
+    },
+    "source_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "name",
+    "checked",
+    "provenance_status"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / blocking_errors

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "recovery": {
+        "additionalProperties": false,
+        "properties": {
+          "action": {
+            "type": "string"
+          },
+          "params": {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "code",
+      "message",
+      "recovery"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / citation

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "qualifier": {
+      "type": "string"
+    },
+    "text": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "text"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / confidence

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "basis": {
+      "enum": [
+        "deterministic",
+        "provenance",
+        "match_quality",
+        "freshness"
+      ],
+      "type": "string"
+    },
+    "level": {
+      "enum": [
+        "high",
+        "medium",
+        "low"
+      ],
+      "type": "string"
+    },
+    "score": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    }
+  },
+  "required": [
+    "level",
+    "basis"
+  ],
+  "type": "object"
+}

removedOutput schema / properties / disclaimer

Removed value: -{
-  "description": "Structural-validation-only disclaimer",
-  "type": "string"
-}

addedOutput schema / properties / envelope_version

Added value: +{
+  "const": "1",
+  "type": "string"
+}

removedOutput schema / properties / found

Removed value: -{
-  "description": "Every identifier found + validated (ordered by position in the input)",
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "_source": {
-        "additionalProperties": false,
-        "description": "Methodology citation for the scheme",
-        "properties": {
-          "authority": {
-            "type": "string"
-          },
-          "computed_by": {
-            "type": "string"
-          },
-          "reference": {
-            "type": "string"
-          },
-          "source_url": {
-            "type": "string"
-          },
-          "standard": {
-            "type": "string"
-          },
-          "type": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "standard",
-          "reference",
-          "authority",
-          "source_url",
-          "computed_by"
-        ],
-        "type": "object"
-      },
-      "check_digit": {
-        "additionalProperties": false,
-        "description": "Expected vs actual check digit (null if malformed)",
-        "properties": {
-          "actual": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "expected": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "expected",
-          "actual"
-        ],
-        "type": "object"
-      },
-      "details": {
-        "additionalProperties": {},
-        "description": "Type-specific: owner_prefix/equipment_category (container), airline_prefix/serial/airline (awb), number (imo), or error (malformed)",
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "normalised": {
-        "description": "Canonical form (uppercased / dashed)",
-        "type": "string"
-      },
-      "raw": {
-        "description": "The candidate as found in the input",
-        "type": "string"
-      },
-      "type": {
-        "description": "container | awb | imo",
-        "type": "string"
-      },
-      "valid": {
-        "description": "Check-digit pass/fail (structural only)",
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "type",
-      "raw",
-      "normalised",
-      "valid",
-      "check_digit",
-      "details",
-      "_source"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

addedOutput schema / properties / normalized_input

Added value: +{
+  "additionalProperties": {},
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

removedOutput schema / properties / note

Removed value: -{
-  "description": "Present when nothing was found",
-  "type": "string"
-}

addedOutput schema / properties / ok
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / properties / result

Added value: +{
+  "additionalProperties": {},
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

addedOutput schema / properties / validity

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "as_of": {
+      "type": "string"
+    },
+    "effective_from": {
+      "type": "string"
+    },
+    "effective_to": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "as_of"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / warnings

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "details": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "code",
+      "message"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "found",
-  "disclaimer"
-]New value: +[
+  "envelope_version",
+  "ok",
+  "result",
+  "confidence",
+  "_source",
+  "citation"
+]

AddedJun 24, 2026

TDQS

Score is being calculated.

All FreightUtils MCP Server tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.