Skip to main content
Glama
FreightUtils MCP Server

FreightUtils MCP Server

container_lookup

Read-onlyIdempotent

Look up ISO shipping-container specifications for 10 common types and calculate how many items fit using item dimensions and weight.

Instructions

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.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "container_lookup"
  }
}

Input Schema

NameRequiredDescriptionDefault
fullNoLists only: true returns full records instead of summary rows.
typeNoContainer slug ("40ft-high-cube"), ISO code or short form. Omit to list all.
limitNoLists only: rows per page.
offsetNoLists only: rows to skip (default 0).
item_quantityNoNumber of items to check against the container.
item_width_cmNoItem width in cm.
item_height_cmNoItem height in cm.
item_length_cmNoItem length in cm — provide all three item dims to get a load-fit calculation.
item_weight_kgNoWeight of ONE item, kg; caps the fit by max payload.

Output Schema

NameRequiredDescriptionDefault
okYes
_metaNo
as_ofNo
resultYes
statusNo
_sourceYes
editionNo
citationYes
validityNo
warningsNo
confidenceYes
missing_inputsNo
blocking_errorsNo
envelope_versionYes
normalized_inputNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changedv2.34.4
    • changedInput schema / properties / full / description
      Previous value: -"Lists only: true returns full records (provenance, sources, rationale) instead of summary rows, five per page by default. A single-record call always returns the full record."New value: +"Lists only: true returns full records instead of summary rows."
    • changedInput schema / properties / item_weight_kg / description
      Previous value: -"Weight of ONE item in kg — caps the fit by max payload. 0 or omitted: no weight check."New value: +"Weight of ONE item, kg; caps the fit by max payload."
    • changedInput schema / properties / limit / description
      Previous value: -"Lists only: rows per page (default: every summary row; 5 with full: true)."New value: +"Lists only: rows per page."
    • changedInput schema / properties / offset / description
      Previous value: -"Lists only: rows to skip (default 0). The response gives total and next_offset."New value: +"Lists only: rows to skip (default 0)."
    • changedInput schema / properties / type / description
      Previous value: -"Container slug. Examples: \"20ft-standard\", \"40ft-high-cube\", \"20ft-reefer\". Omit to list all 10 types."New value: +"Container slug (\"40ft-high-cube\"), ISO code or short form. Omit to list all."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / kind / description
      Removed value: -"watched (its upstream is fetched daily) or checksum-only (no upstream of its own)."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / last_success / description
      Removed value: -"The last day (YYYY-MM-DD) the upstream check succeeded; null when none is recorded."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / reason / description
      Removed value: -"Why the state is unknown."
    • removedOutput schema / properties / _meta / properties / upstream / properties / stale / description
      Removed value: -"True only when a dataset below missed its upstream check window (window_missed)."
    • removedOutput schema / properties / _meta / properties / upstream / properties / state / description
      Removed value: -"The worst state of the datasets below."
    • removedOutput schema / properties / _meta / properties / upstream / properties / state_read_at / description
      Removed value: -"When the site upstream check recorded the state (ISO 8601); null when it could not be read."
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "audited_at": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "capacity_cbm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "containers": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "count": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "door_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "door_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "euro_pallets": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "external_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "external_length_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "external_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "fu_id": {
      -        "anyOf": [
      -          {
      -            "description": "Stable FreightUtils identifier of this record, fu:<namespace>:<key> — the same across editions; resolve_reference resolves it to exactly this record.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "fu_version_id": {
      -        "anyOf": [
      -          {
      -            "description": "This record in one dataset edition, fu_id@<edition>. Present only where the dataset has editions (absent on airlines, ULDs, containers, vehicles).",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "gma_pallets": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "internal_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "internal_length_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "internal_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "iso_code": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "loading": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "max_gross_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "max_payload_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "notes": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "slug": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tare_weight_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "verified": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "audited_at": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "capacity_cbm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "containers": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "door_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "door_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "euro_pallets": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "external_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "external_length_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "external_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "fu_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "fu_version_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "gma_pallets": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "internal_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "internal_length_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "internal_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "iso_code": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "loading": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "max_gross_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "max_payload_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "notes": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "slug": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tare_weight_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "verified": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
  2. Changed3 schema fields changedv2.34.0
    • addedOutput schema / properties / _meta / properties / ids
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "pattern": {
      +      "type": "string"
      +    },
      +    "scheme": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "scheme",
      +    "pattern"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / _meta / properties / upstream
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "datasets": {
      +      "additionalProperties": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "kind": {
      +            "description": "watched (its upstream is fetched daily) or checksum-only (no upstream of its own).",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "last_success": {
      +            "description": "The last day (YYYY-MM-DD) the upstream check succeeded; null when none is recorded.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "reason": {
      +            "description": "Why the state is unknown.",
      +            "type": "string"
      +          },
      +          "stale": {
      +            "type": "boolean"
      +          },
      +          "state": {
      +            "enum": [
      +              "in_step",
      +              "changed_upstream",
      +              "schema_drift",
      +              "unreachable",
      +              "window_missed",
      +              "unknown"
      +            ],
      +            "type": "string"
      +          },
      +          "window_days": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "state",
      +          "kind",
      +          "last_success",
      +          "window_days",
      +          "stale"
      +        ],
      +        "type": "object"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "stale": {
      +      "description": "True only when a dataset below missed its upstream check window (window_missed).",
      +      "type": "boolean"
      +    },
      +    "state": {
      +      "description": "The worst state of the datasets below.",
      +      "enum": [
      +        "in_step",
      +        "changed_upstream",
      +        "schema_drift",
      +        "unreachable",
      +        "window_missed",
      +        "unknown"
      +      ],
      +      "type": "string"
      +    },
      +    "state_read_at": {
      +      "description": "When the site upstream check recorded the state (ISO 8601); null when it could not be read.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "state",
      +    "stale",
      +    "state_read_at",
      +    "datasets"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "audited_at": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "capacity_cbm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "containers": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "count": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "door_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "door_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "euro_pallets": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "external_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "external_length_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "external_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "gma_pallets": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "internal_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "internal_length_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "internal_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "iso_code": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "loading": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "max_gross_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "max_payload_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "notes": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "slug": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tare_weight_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "verified": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "audited_at": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "capacity_cbm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "containers": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "door_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "door_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "euro_pallets": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "external_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "external_length_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "external_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "fu_id": {
      +        "anyOf": [
      +          {
      +            "description": "Stable FreightUtils identifier of this record, fu:<namespace>:<key> — the same across editions; resolve_reference resolves it to exactly this record.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "fu_version_id": {
      +        "anyOf": [
      +          {
      +            "description": "This record in one dataset edition, fu_id@<edition>. Present only where the dataset has editions (absent on airlines, ULDs, containers, vehicles).",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "gma_pallets": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "internal_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "internal_length_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "internal_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "iso_code": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "loading": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "max_gross_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "max_payload_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "notes": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "slug": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tare_weight_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "verified": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
  3. Changed2 schema fields changedv2.31.0
    • removedOutput schema / properties / _meta / properties / receipt / properties / reason / const
      Removed value: -"key_required"
    • addedOutput schema / properties / _meta / properties / receipt / properties / reason / enum
      Added value: +[
      +  "key_required",
      +  "quota"
      +]
  4. Changed4 schema fields changedv2.27.0
    • addedOutput schema / properties / _meta / properties / check_id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _meta / properties / edition_basis
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _meta / properties / receipt
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "created_at": {
      +      "type": "string"
      +    },
      +    "dataset_version": {
      +      "additionalProperties": {
      +        "type": "string"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "engine_version": {
      +      "type": "string"
      +    },
      +    "inputs": {},
      +    "reason": {
      +      "const": "key_required",
      +      "type": "string"
      +    },
      +    "receipt_hash": {
      +      "type": "string"
      +    },
      +    "result": {
      +      "additionalProperties": {},
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "schema_version": {
      +      "type": "string"
      +    },
      +    "stored": {
      +      "const": false,
      +      "type": "boolean"
      +    },
      +    "tool": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "stored",
      +    "reason",
      +    "schema_version",
      +    "receipt_hash",
      +    "created_at",
      +    "tool",
      +    "inputs",
      +    "dataset_version",
      +    "engine_version",
      +    "result"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / _meta / properties / receipt_url
      Added value: +{
      +  "type": "string"
      +}
  5. Changed10 schema fields changedv2.24.0
    • addedOutput schema / properties / _meta
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "identify": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / as_of
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / blocking_errors / items / properties / recovery / properties / params / propertyNames
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / edition
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "applies_from": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "may_apply_until": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "applies_from",
      +        "may_apply_until"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / envelope_version / enum
      Previous value: -[
      -  "1",
      -  "1.1"
      -]New value: +[
      +  "1",
      +  "1.1",
      +  "1.2"
      +]
    • addedOutput schema / properties / missing_inputs
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / normalized_input / propertyNames
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "audited_at": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "capacity_cbm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "containers": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "count": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "door_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "door_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "euro_pallets": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "external_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "external_length_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "external_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "gma_pallets": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "internal_height_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "internal_length_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "internal_width_cm": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "iso_code": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "loading": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "max_gross_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "max_payload_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "notes": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "slug": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tare_weight_kg": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "verified": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "audited_at": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "capacity_cbm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "containers": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "door_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "door_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "euro_pallets": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "external_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "external_length_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "external_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "gma_pallets": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "internal_height_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "internal_length_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "internal_width_cm": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "iso_code": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "loading": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "max_gross_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "max_payload_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "notes": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "slug": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tare_weight_kg": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "verified": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
    • addedOutput schema / properties / status
      Added value: +{
      +  "enum": [
      +    "ok",
      +    "partial",
      +    "not_found",
      +    "unsupported",
      +    "ambiguous"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / warnings / items / properties / details / propertyNames
      Added value: +{
      +  "type": "string"
      +}
  6. Changed7 schema fields changedv2.22.3
    • addedInput schema / properties / full
      Added value: +{
      +  "description": "Lists only: true returns full records (provenance, sources, rationale) instead of summary rows, five per page by default. A single-record call always returns the full record.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / item_quantity / maximum
      Added value: +9007199254740991
    • changedInput schema / properties / item_weight_kg / description
      Previous value: -"Item weight in kg — caps the fit by max payload."New value: +"Weight of ONE item in kg — caps the fit by max payload. 0 or omitted: no weight check."
    • removedInput schema / properties / item_weight_kg / exclusiveMinimum
      Removed value: -0
    • addedInput schema / properties / item_weight_kg / minimum
      Added value: +0
    • addedInput schema / properties / limit
      Added value: +{
      +  "description": "Lists only: rows per page (default: every summary row; 5 with full: true).",
      +  "maximum": 100,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / offset
      Added value: +{
      +  "description": "Lists only: rows to skip (default 0). The response gives total and next_offset.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  7. Changed5 schema fields changedv2.17.2
    • 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"
      +]
  8. Changed7 schema fields changedv2.11.0
    • changedInput schema / properties / item_height_cm / description
      Previous value: -"Item height in cm"New value: +"Item height in cm."
    • changedInput schema / properties / item_length_cm / description
      Previous value: -"Item length in cm (for loading calculation)"New value: +"Item length in cm — provide all three item dims to get a load-fit calculation."
    • changedInput schema / properties / item_quantity / description
      Previous value: -"Number of items"New value: +"Number of items to check against the container."
    • changedInput schema / properties / item_weight_kg / description
      Previous value: -"Item weight in kg"New value: +"Item weight in kg — caps the fit by max payload."
    • changedInput schema / properties / item_width_cm / description
      Previous value: -"Item width in cm"New value: +"Item width in cm."
    • changedInput schema / properties / type / description
      Previous value: -"Container slug (e.g., \"20ft-standard\", \"40ft-high-cube\"). Omit to list all types."New value: +"Container slug. Examples: \"20ft-standard\", \"40ft-high-cube\", \"20ft-reefer\". Omit to list all 10 types."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "_source": {
      +      "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"
      +    },
      +    "blocking_errors": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "recovery": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "action": {
      +                "type": "string"
      +              },
      +              "params": {
      +                "additionalProperties": {},
      +                "type": "object"
      +              },
      +              "tool": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "action"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "recovery"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "citation": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "qualifier": {
      +          "type": "string"
      +        },
      +        "text": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "text"
      +      ],
      +      "type": "object"
      +    },
      +    "confidence": {
      +      "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"
      +    },
      +    "envelope_version": {
      +      "const": "1",
      +      "type": "string"
      +    },
      +    "normalized_input": {
      +      "additionalProperties": {},
      +      "type": "object"
      +    },
      +    "ok": {
      +      "type": "boolean"
      +    },
      +    "result": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": true,
      +          "properties": {
      +            "audited_at": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "capacity_cbm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "containers": {
      +              "anyOf": [
      +                {
      +                  "items": {},
      +                  "type": "array"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "count": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "description": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "door_height_cm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "door_width_cm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "euro_pallets": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "external_height_cm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "external_length_cm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "external_width_cm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "gma_pallets": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "internal_height_cm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "internal_length_cm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "internal_width_cm": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "iso_code": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "loading": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": {},
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "max_gross_kg": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "max_payload_kg": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "name": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "notes": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "slug": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "tare_weight_kg": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "verified": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            }
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": {},
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "validity": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "as_of": {
      +          "type": "string"
      +        },
      +        "effective_from": {
      +          "type": "string"
      +        },
      +        "effective_to": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "as_of"
      +      ],
      +      "type": "object"
      +    },
      +    "warnings": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "details": {
      +            "additionalProperties": {},
      +            "type": "object"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "envelope_version",
      +    "ok",
      +    "result",
      +    "confidence",
      +    "_source",
      +    "citation"
      +  ],
      +  "type": "object"
      +}
  9. Changed1 schema field changedv2.5.0
    • addedInput schema / properties / type / minLength
      Added value: +2
  10. First observedv1.0.0

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, non-destructive and closed-world, so the safety profile is known. The description still adds behavior beyond them: rate limiting with a specific error shape ('a limit error carries reset_at, the UTC time the allowance resets') and a data-quality caveat ('Manufacturer-typical specs, provenance pending — confirm against the carrier's equipment guide'). It stops short of describing result structure, but an output schema exists to cover that.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three front-loaded sentences, each carrying distinct load (modes, sibling routing, operational caveats) with no filler. The compression is heavy — multiple clauses chained with semicolons — which costs a little readability but not content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 9-parameter read-only lookup with an output schema, the description covers all the decisions an agent must make: which mode, which input forms, which sibling to prefer, rate-limit failure handling, and the reliability caveat on the returned specs. Nothing needed for correct invocation is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description supplies cross-parameter meaning the schema documents only piecemeal: the accepted 'type' forms ('40ft-high-cube', '45G1', '40HC'), that omitting it lists all 10, and that the mode switches to load-fit only when item dimensions are added. That mode-selection logic is the key semantic an agent needs and is not stated as a single rule in any property description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific resource and scope: '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.' It then enumerates its three modes (single record by type, list all 10, load-fit calculation), which an agent can distinguish without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It names explicit alternatives with the condition that selects each: 'For a container NUMBER's check digit use validate; for the air-freight equivalent uld_lookup; for the cargo volume cbm_calculator / consignment_calculator.' That routes the agent away from this tool for adjacent tasks instead of leaving it to infer.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.