Skip to main content
Glama

Search shipment records

exim__shipments__search
Read-onlyIdempotent

Searches shipment records by HS code, origin, destination and company name. Use it to see individual shipments behind a market or company.

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": "exim__shipments__search"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameNocompany name (case-insensitive substring)
limitNomax rows (1-1000, default 100)
hsCodeNoHS code at 2, 4 or 6 digits; shorter codes match the whole family (0901 = all coffee). Do not pad with zeros (090100 matches nothing).
originCountryNoOrigin (exporting) country, ISO2 code (e.g. VN).
destinationCountryNoDestination (importing) country, ISO2 code (e.g. US, DE).

Output Schema

NameRequiredDescriptionDefault
dataYes
statsNo
_debugNo
summaryYes
warningsNo
nextActionsYes
correlationIdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / data / properties / context / anyOf
      Previous value: -[
      -  {
      -    "type": [
      -      "null",
      -      "boolean",
      -      "number",
      -      "string",
      -      "array",
      -      "object"
      -    ]
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "collection": {
      -        "$ref": "#/$defs/value8"
      -      },
      -      "sourceObservation": {
      -        "type": [
      -          "null",
      -          "boolean",
      -          "number",
      -          "string",
      -          "array",
      -          "object"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "sourceObservation"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "type": [
      +          "null",
      +          "boolean",
      +          "number",
      +          "string",
      +          "array",
      +          "object"
      +        ]
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "collection": {
      +            "$ref": "#/$defs/value8"
      +          },
      +          "sourceObservation": {
      +            "type": [
      +              "null",
      +              "boolean",
      +              "number",
      +              "string",
      +              "array",
      +              "object"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "sourceObservation"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "referenced": {
      +        "type": "boolean"
      +      },
      +      "rowCount": {
      +        "type": "integer"
      +      },
      +      "url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "referenced",
      +      "rowCount",
      +      "url"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / data / properties / items / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "anyOf": [
      -        {
      -          "$ref": "#/$defs/value0"
      -        },
      -        {
      -          "$ref": "#/$defs/value1"
      -        }
      -      ]
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "anyOf": [
      +        {
      +          "anyOf": [
      +            {
      +              "$ref": "#/$defs/value0"
      +            },
      +            {
      +              "$ref": "#/$defs/value1"
      +            }
      +          ]
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "exportUrl": {
      +              "type": "string"
      +            },
      +            "payloadBytes": {
      +              "type": "integer"
      +            },
      +            "rowCount": {
      +              "type": "integer"
      +            },
      +            "token": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "exportUrl",
      +            "payloadBytes",
      +            "rowCount",
      +            "token",
      +            "url"
      +          ],
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed58 schema fields changed
    • addedOutput schema / $defs / value1 / additionalProperties
      Added value: +false
    • removedOutput schema / $defs / value1 / anyOf
      Removed value: -[
      -  {
      -    "items": {
      -      "type": [
      -        "null",
      -        "boolean",
      -        "number",
      -        "string",
      -        "array",
      -        "object"
      -      ]
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / value1 / properties
      Added value: +{
      +  "company": {
      +    "anyOf": [
      +      {
      +        "$ref": "#/$defs/value3"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "fit": {
      +    "anyOf": [
      +      {
      +        "$ref": "#/$defs/value2"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "membership": {
      +    "anyOf": [
      +      {
      +        "$ref": "#/$defs/value4"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "pending": {
      +    "anyOf": [
      +      {
      +        "$ref": "#/$defs/value7"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  }
      +}
    • addedOutput schema / $defs / value1 / type
      Added value: +"object"
    • addedOutput schema / $defs / value10
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "$ref": "#/$defs/value11"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value11
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "command": {
      +      "type": "string"
      +    },
      +    "cost": {
      +      "type": "string"
      +    },
      +    "label": {
      +      "type": "string"
      +    },
      +    "rationale": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "command",
      +    "cost",
      +    "label",
      +    "rationale"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / $defs / value12
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": {
      +        "type": "number"
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value13
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "$ref": "#/$defs/value14"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value14
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "code": {
      +      "type": "string"
      +    },
      +    "message": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "code",
      +    "message"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / $defs / value15
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": {
      +        "type": [
      +          "null",
      +          "boolean",
      +          "number",
      +          "string",
      +          "array",
      +          "object"
      +        ]
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value2 / additionalProperties
      Added value: +false
    • removedOutput schema / $defs / value2 / anyOf
      Removed value: -[
      -  {
      -    "items": {
      -      "$ref": "#/$defs/value3"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / value2 / properties
      Added value: +{
      +  "company_id": {
      +    "anyOf": [
      +      {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "created_at": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "discovery_source": {
      +    "type": "string"
      +  },
      +  "evidence_tier": {
      +    "type": "integer"
      +  },
      +  "id": {
      +    "anyOf": [
      +      {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "match_reasons": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "priority": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "reasoning": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "score": {
      +    "anyOf": [
      +      {
      +        "type": "number"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "target_id": {
      +    "anyOf": [
      +      {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "target_kind": {
      +    "type": "string"
      +  },
      +  "updated_at": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "user_id": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / $defs / value2 / required
      Added value: +[
      +  "company_id",
      +  "created_at",
      +  "discovery_source",
      +  "evidence_tier",
      +  "id",
      +  "match_reasons",
      +  "priority",
      +  "reasoning",
      +  "score",
      +  "target_id",
      +  "target_kind",
      +  "updated_at",
      +  "user_id"
      +]
    • addedOutput schema / $defs / value2 / type
      Added value: +"object"
    • addedOutput schema / $defs / value3 / properties / address
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value3 / properties / base_url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value3 / properties / canonical_url
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / $defs / value3 / properties / command
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / $defs / value3 / properties / cost
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / $defs / value3 / properties / country
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value3 / properties / description
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value3 / properties / id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "format": "uuid",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value3 / properties / industry
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • removedOutput schema / $defs / value3 / properties / label
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / $defs / value3 / properties / name
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / $defs / value3 / properties / rationale
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / $defs / value3 / properties / resolution_source
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / $defs / value3 / properties / trade_potential
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value3 / properties / trade_potential_reasoning
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value3 / properties / updated_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / value3 / properties / url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / $defs / value3 / required
      Previous value: -[
      -  "command",
      -  "cost",
      -  "label",
      -  "rationale"
      -]New value: +[
      +  "address",
      +  "base_url",
      +  "canonical_url",
      +  "country",
      +  "description",
      +  "id",
      +  "industry",
      +  "name",
      +  "resolution_source",
      +  "trade_potential",
      +  "trade_potential_reasoning",
      +  "updated_at",
      +  "url"
      +]
    • addedOutput schema / $defs / value4 / additionalProperties
      Added value: +false
    • removedOutput schema / $defs / value4 / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": {
      -      "type": "number"
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / value4 / properties
      Added value: +{
      +  "ai_column_meta": {
      +    "type": [
      +      "null",
      +      "boolean",
      +      "number",
      +      "string",
      +      "array",
      +      "object"
      +    ]
      +  },
      +  "ai_column_values": {
      +    "$ref": "#/$defs/value6"
      +  },
      +  "canonical_url": {
      +    "type": "string"
      +  },
      +  "collection_id": {
      +    "anyOf": [
      +      {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "company_country": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "company_id": {
      +    "anyOf": [
      +      {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "company_name": {
      +    "type": "string"
      +  },
      +  "company_url": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "created_at": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "discovery_source": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "id": {
      +    "anyOf": [
      +      {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "keywords": {
      +    "$ref": "#/$defs/value5"
      +  },
      +  "match_reasons": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "outreach_stage": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "priority": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "reasoning": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "score": {
      +    "anyOf": [
      +      {
      +        "type": "number"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "updated_at": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  }
      +}
    • addedOutput schema / $defs / value4 / required
      Added value: +[
      +  "ai_column_meta",
      +  "ai_column_values",
      +  "canonical_url",
      +  "collection_id",
      +  "company_country",
      +  "company_id",
      +  "company_name",
      +  "company_url",
      +  "created_at",
      +  "discovery_source",
      +  "id",
      +  "keywords",
      +  "match_reasons",
      +  "outreach_stage",
      +  "priority",
      +  "reasoning",
      +  "score",
      +  "updated_at"
      +]
    • addedOutput schema / $defs / value4 / type
      Added value: +"object"
    • changedOutput schema / $defs / value5 / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "$ref": "#/$defs/value6"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / $defs / value6 / additionalProperties
      Removed value: -false
    • addedOutput schema / $defs / value6 / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / $defs / value6 / properties
      Removed value: -{
      -  "code": {
      -    "type": "string"
      -  },
      -  "message": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / $defs / value6 / required
      Removed value: -[
      -  "code",
      -  "message"
      -]
    • removedOutput schema / $defs / value6 / type
      Removed value: -"object"
    • addedOutput schema / $defs / value7 / additionalProperties
      Added value: +false
    • removedOutput schema / $defs / value7 / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": {
      -      "type": [
      -        "null",
      -        "boolean",
      -        "number",
      -        "string",
      -        "array",
      -        "object"
      -      ]
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / value7 / properties
      Added value: +{
      +  "displayName": {
      +    "type": "string"
      +  },
      +  "message": {
      +    "type": "string"
      +  },
      +  "pendingId": {
      +    "type": "string"
      +  },
      +  "reportingCountry": {
      +    "type": "string"
      +  },
      +  "status": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / $defs / value7 / required
      Added value: +[
      +  "displayName",
      +  "message",
      +  "pendingId",
      +  "reportingCountry",
      +  "status"
      +]
    • addedOutput schema / $defs / value7 / type
      Added value: +"object"
    • addedOutput schema / $defs / value8
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "id": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "id",
      +    "url"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / $defs / value9
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "type": [
      +          "null",
      +          "boolean",
      +          "number",
      +          "string",
      +          "array",
      +          "object"
      +        ]
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / _debug / $ref
      Previous value: -"#/$defs/value7"New value: +"#/$defs/value15"
    • addedOutput schema / properties / data / properties / context / anyOf
      Added value: +[
      +  {
      +    "type": [
      +      "null",
      +      "boolean",
      +      "number",
      +      "string",
      +      "array",
      +      "object"
      +    ]
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "collection": {
      +        "$ref": "#/$defs/value8"
      +      },
      +      "sourceObservation": {
      +        "type": [
      +          "null",
      +          "boolean",
      +          "number",
      +          "string",
      +          "array",
      +          "object"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "sourceObservation"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties / data / properties / context / type
      Removed value: -[
      -  "null",
      -  "boolean",
      -  "number",
      -  "string",
      -  "array",
      -  "object"
      -]
    • changedOutput schema / properties / data / properties / items / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "$ref": "#/$defs/value0"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "anyOf": [
      +        {
      +          "$ref": "#/$defs/value0"
      +        },
      +        {
      +          "$ref": "#/$defs/value1"
      +        }
      +      ]
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / nextActions / $ref
      Previous value: -"#/$defs/value2"New value: +"#/$defs/value10"
    • changedOutput schema / properties / stats / $ref
      Previous value: -"#/$defs/value4"New value: +"#/$defs/value12"
    • changedOutput schema / properties / warnings / $ref
      Previous value: -"#/$defs/value5"New value: +"#/$defs/value13"
  3. Changed6 schema fields changed
    • changedInput schema / not / anyOf
      Previous value: -[
      -  {
      -    "not": {
      -      "anyOf": [
      -        {
      -          "properties": {
      -            "hsCode": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "hsCode"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "hsCode": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "hsCode"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "origin": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "origin"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "dest": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "dest"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "name": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "name"
      -          ]
      -        }
      -      ]
      -    }
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "anyOf": [
      +        {
      +          "properties": {
      +            "hsCode": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hsCode"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "hsCode": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hsCode"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "originCountry": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "originCountry"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "destinationCountry": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "destinationCountry"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "name": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name"
      +          ]
      +        }
      +      ]
      +    }
      +  }
      +]
    • removedInput schema / properties / dest
      Removed value: -{
      -  "description": "Destination country (ISO 2)",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / destinationCountry
      Added value: +{
      +  "description": "Destination (importing) country, ISO2 code (e.g. US, DE).",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • changedInput schema / properties / hsCode / description
      Previous value: -"HS code (4/6/8/10 digit prefix)"New value: +"HS code at 2, 4 or 6 digits; shorter codes match the whole family (0901 = all coffee). Do not pad with zeros (090100 matches nothing)."
    • removedInput schema / properties / origin
      Removed value: -{
      -  "description": "Origin country (ISO 2)",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / originCountry
      Added value: +{
      +  "description": "Origin (exporting) country, ISO2 code (e.g. VN).",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
  4. Changed6 schema fields changed
    • changedInput schema / not / anyOf
      Previous value: -[
      -  {
      -    "not": {
      -      "anyOf": [
      -        {
      -          "properties": {
      -            "hsCode": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "hsCode"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "hsCode": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "hsCode"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "originCountry": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "originCountry"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "destinationCountry": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "destinationCountry"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "name": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "name"
      -          ]
      -        }
      -      ]
      -    }
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "anyOf": [
      +        {
      +          "properties": {
      +            "hsCode": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hsCode"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "hsCode": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hsCode"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "origin": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "origin"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "dest": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "dest"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "name": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name"
      +          ]
      +        }
      +      ]
      +    }
      +  }
      +]
    • addedInput schema / properties / dest
      Added value: +{
      +  "description": "Destination country (ISO 2)",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • removedInput schema / properties / destinationCountry
      Removed value: -{
      -  "description": "Destination (importing) country, ISO2 code (e.g. US, DE).",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • changedInput schema / properties / hsCode / description
      Previous value: -"HS code at 2, 4 or 6 digits; shorter codes match the whole family (0901 = all coffee). Do not pad with zeros (090100 matches nothing)."New value: +"HS code (4/6/8/10 digit prefix)"
    • addedInput schema / properties / origin
      Added value: +{
      +  "description": "Origin country (ISO 2)",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • removedInput schema / properties / originCountry
      Removed value: -{
      -  "description": "Origin (exporting) country, ISO2 code (e.g. VN).",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
  5. Changed6 schema fields changed
    • changedInput schema / not / anyOf
      Previous value: -[
      -  {
      -    "not": {
      -      "anyOf": [
      -        {
      -          "properties": {
      -            "hsCode": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "hsCode"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "hsCode": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "hsCode"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "origin": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "origin"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "dest": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "dest"
      -          ]
      -        },
      -        {
      -          "properties": {
      -            "name": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "name"
      -          ]
      -        }
      -      ]
      -    }
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "anyOf": [
      +        {
      +          "properties": {
      +            "hsCode": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hsCode"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "hsCode": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hsCode"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "originCountry": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "originCountry"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "destinationCountry": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "destinationCountry"
      +          ]
      +        },
      +        {
      +          "properties": {
      +            "name": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name"
      +          ]
      +        }
      +      ]
      +    }
      +  }
      +]
    • removedInput schema / properties / dest
      Removed value: -{
      -  "description": "Destination country (ISO 2)",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / destinationCountry
      Added value: +{
      +  "description": "Destination (importing) country, ISO2 code (e.g. US, DE).",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • changedInput schema / properties / hsCode / description
      Previous value: -"HS code (4/6/8/10 digit prefix)"New value: +"HS code at 2, 4 or 6 digits; shorter codes match the whole family (0901 = all coffee). Do not pad with zeros (090100 matches nothing)."
    • removedInput schema / properties / origin
      Removed value: -{
      -  "description": "Origin country (ISO 2)",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / originCountry
      Added value: +{
      +  "description": "Origin (exporting) country, ISO2 code (e.g. VN).",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
  6. Changed13 schema fields changed
    • addedInput schema / not
      Added value: +{
      +  "anyOf": [
      +    {
      +      "not": {
      +        "anyOf": [
      +          {
      +            "properties": {
      +              "hsCode": {
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "hsCode"
      +            ]
      +          },
      +          {
      +            "properties": {
      +              "hsCode": {
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "hsCode"
      +            ]
      +          },
      +          {
      +            "properties": {
      +              "origin": {
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "origin"
      +            ]
      +          },
      +          {
      +            "properties": {
      +              "dest": {
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "dest"
      +            ]
      +          },
      +          {
      +            "properties": {
      +              "name": {
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "name"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  ]
      +}
    • removedInput schema / properties / --dest
      Removed value: -{
      -  "description": "Destination country (ISO 2)",
      -  "type": "string"
      -}
    • removedInput schema / properties / --hs6
      Removed value: -{
      -  "description": "HS code (first 6 digits)",
      -  "type": "string"
      -}
    • removedInput schema / properties / --hsCode
      Removed value: -{
      -  "description": "HS code (4/6/8/10 digit prefix)",
      -  "type": "string"
      -}
    • removedInput schema / properties / --limit
      Removed value: -{
      -  "description": "max rows (1-1000, default 100)",
      -  "type": "integer"
      -}
    • removedInput schema / properties / --name
      Removed value: -{
      -  "description": "company name (case-insensitive substring)",
      -  "type": "string"
      -}
    • removedInput schema / properties / --origin
      Removed value: -{
      -  "description": "Origin country (ISO 2)",
      -  "type": "string"
      -}
    • addedInput schema / properties / dest
      Added value: +{
      +  "description": "Destination country (ISO 2)",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • addedInput schema / properties / hsCode
      Added value: +{
      +  "description": "HS code (4/6/8/10 digit prefix)",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "description": "max rows (1-1000, default 100)",
      +  "maximum": 1000,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / name
      Added value: +{
      +  "description": "company name (case-insensitive substring)",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • addedInput schema / properties / origin
      Added value: +{
      +  "description": "Origin country (ISO 2)",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "value0": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "arrivalDate": {
      +          "anyOf": [
      +            {
      +              "format": "date-time",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "billOfLading": {
      +          "type": "string"
      +        },
      +        "buyerDocumentId": {
      +          "type": "string"
      +        },
      +        "customsValueUsd": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "destinationCountry": {
      +          "type": "string"
      +        },
      +        "exporterName": {
      +          "type": "string"
      +        },
      +        "exporterTaxId": {
      +          "type": "string"
      +        },
      +        "fobUsd": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "hs6": {
      +          "type": "string"
      +        },
      +        "hsCode": {
      +          "type": "string"
      +        },
      +        "importerName": {
      +          "type": "string"
      +        },
      +        "importerTaxId": {
      +          "type": "string"
      +        },
      +        "normalizationConfidence": {
      +          "type": "number"
      +        },
      +        "originCountry": {
      +          "type": "string"
      +        },
      +        "portOfLoading": {
      +          "type": "string"
      +        },
      +        "portOfUnloading": {
      +          "type": "string"
      +        },
      +        "pricePerKg": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "productDescription": {
      +          "type": "string"
      +        },
      +        "quantity": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "quantityUnit": {
      +          "type": "string"
      +        },
      +        "recordId": {
      +          "type": "string"
      +        },
      +        "reportingCountry": {
      +          "type": "string"
      +        },
      +        "sellerTaxId": {
      +          "type": "string"
      +        },
      +        "shipmentDate": {
      +          "anyOf": [
      +            {
      +              "format": "date-time",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "source": {
      +          "type": "string"
      +        },
      +        "transportMode": {
      +          "type": "string"
      +        },
      +        "vesselName": {
      +          "type": "string"
      +        },
      +        "weightKg": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "arrivalDate",
      +        "billOfLading",
      +        "buyerDocumentId",
      +        "customsValueUsd",
      +        "destinationCountry",
      +        "exporterName",
      +        "exporterTaxId",
      +        "fobUsd",
      +        "hs6",
      +        "hsCode",
      +        "importerName",
      +        "importerTaxId",
      +        "normalizationConfidence",
      +        "originCountry",
      +        "portOfLoading",
      +        "portOfUnloading",
      +        "pricePerKg",
      +        "productDescription",
      +        "quantity",
      +        "quantityUnit",
      +        "recordId",
      +        "reportingCountry",
      +        "sellerTaxId",
      +        "shipmentDate",
      +        "source",
      +        "transportMode",
      +        "vesselName",
      +        "weightKg"
      +      ],
      +      "type": "object"
      +    },
      +    "value1": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "type": [
      +              "null",
      +              "boolean",
      +              "number",
      +              "string",
      +              "array",
      +              "object"
      +            ]
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value2": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "$ref": "#/$defs/value3"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value3": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "command": {
      +          "type": "string"
      +        },
      +        "cost": {
      +          "type": "string"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "rationale": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "command",
      +        "cost",
      +        "label",
      +        "rationale"
      +      ],
      +      "type": "object"
      +    },
      +    "value4": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {
      +            "type": "number"
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value5": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "$ref": "#/$defs/value6"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value6": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "code": {
      +          "type": "string"
      +        },
      +        "message": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "code",
      +        "message"
      +      ],
      +      "type": "object"
      +    },
      +    "value7": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {
      +            "type": [
      +              "null",
      +              "boolean",
      +              "number",
      +              "string",
      +              "array",
      +              "object"
      +            ]
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "additionalProperties": false,
      +  "properties": {
      +    "_debug": {
      +      "$ref": "#/$defs/value7"
      +    },
      +    "correlationId": {
      +      "type": "string"
      +    },
      +    "data": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "context": {
      +          "type": [
      +            "null",
      +            "boolean",
      +            "number",
      +            "string",
      +            "array",
      +            "object"
      +          ]
      +        },
      +        "cursor": {
      +          "type": "string"
      +        },
      +        "has_more": {
      +          "type": "boolean"
      +        },
      +        "items": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "$ref": "#/$defs/value0"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "context",
      +        "has_more",
      +        "items"
      +      ],
      +      "type": "object"
      +    },
      +    "nextActions": {
      +      "$ref": "#/$defs/value2"
      +    },
      +    "stats": {
      +      "$ref": "#/$defs/value4"
      +    },
      +    "summary": {
      +      "type": "string"
      +    },
      +    "warnings": {
      +      "$ref": "#/$defs/value5"
      +    }
      +  },
      +  "required": [
      +    "data",
      +    "nextActions",
      +    "summary"
      +  ],
      +  "type": "object"
      +}
  7. First observed

TDQS

B3.3/5.0
Behavior2/5

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

The annotations already establish readOnlyHint=true, idempotentHint=true, destructiveHint=false, and openWorldHint=false, so the safety profile is covered. Beyond that, the description adds no operational behavior such as whether at least one filter is required, how results are ordered, or how the default limit behaves; it only repeats searchable dimensions and gives a broad use context.

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

Conciseness5/5

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

The description is two sentences with no wasted wording, and it front-loads the core purpose before giving usage context. Both sentences earn their place.

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

Completeness3/5

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

An output schema exists and parameter descriptions are complete, so the description need not explain return values or parameter syntax. However, it omits the apparent at-least-one-filter precondition in the schema and does not help route between this tool and closely related shipment siblings, leaving key invocation context to inference.

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

Parameters3/5

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

Schema description coverage is 100%, and the schema itself explains HS code digit rules, ISO2 country codes, case-insensitive name matching, and limit bounds. The description only lists the same fields at a high level, adding no meaning beyond the schema, so the baseline of 3 is appropriate.

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

Purpose4/5

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

The description states a specific verb and resource: 'Searches shipment records' and lists HS code, origin, destination, and company name as search dimensions. It does not explicitly name a sibling tool to distinguish this from exim__shipments__get, exim__company__shipments, or exim__product__shipments, so it is clear but not fully differentiated.

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

Usage Guidelines3/5

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

The sentence 'Use it to see individual shipments behind a market or company' gives a usage context, but there is no explicit when-not guidance and no named alternatives among the many shipment-related siblings. An agent can infer this is for raw shipment inspection, but must still decide between this and tools like exim__company__shipments or exim__shipments__get.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.