EximAgent

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.

Input Schema

Name	Required	Description
`name`	No	company name (case-insensitive substring)
`limit`	No	max rows (1-1000, default 100)
`hsCode`	No	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).
`originCountry`	No	Origin (exporting) country, ISO2 code (e.g. VN).
`destinationCountry`	No	Destination (importing) country, ISO2 code (e.g. US, DE).

Output Schema

Name	Required	Description	Default
`data`	Yes
`stats`	No
`_debug`	No
`summary`	Yes
`warnings`	No
`nextActions`	Yes
`correlationId`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed58 schema fields changedOct 28, 2026

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"

Changed6 schema fields changedOct 14, 2026

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"
+}

Changed6 schema fields changedOct 14, 2026

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

Changed6 schema fields changedOct 14, 2026

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"
+}

Changed13 schema fields changedOct 13, 2026

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"
+}

First observedOct 9, 2026

TDQS

B3.4/5.0

Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so safety is covered. The description adds that results are row-level shipments, but omits the key behavioral constraint enforced by the schema's convoluted not/anyOf structure: at least one filter must be supplied and an unfiltered call fails. It also says nothing about the default row cap or result volume limits.

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?

Two short sentences with no filler and the filter set front-loaded. It is efficient, but the terseness comes at the cost of omitting the required-filter constraint, so it under-specifies rather than wastes words.

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 and annotations are present, so return-format explanation isn't needed. However, for a tool whose schema encodes a non-obvious 'at least one filter is required' rule in nested not/anyOf constructs, the description should surface that precondition in prose and give any guidance on combining filters; neither is present.

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 is genuinely informative (HS code family matching, no zero-padding, ISO2 country codes, 1-1000 limit with default 100). The description only restates the field names, adding no semantics beyond the schema, so the baseline 3 applies.

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?

States a specific verb ('searches') and resource ('shipment records') plus the filterable fields and the intent ('see individual shipments behind a market or company'). This distinguishes it from aggregate siblings like exim__analytics__query, though it never explicitly contrasts with exim__shipments__get, company__shipments or route__shipments.

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 clause 'use it to see individual shipments behind a market or company' gives an implied context, but there are no exclusions or named alternatives despite many overlapping siblings (exim__shipments__get for lookups, exim__company__shipments for a company timeline, exim__analytics__* for aggregates). Usage is inferred, not stated.

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

All EximAgent tools Inspect

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Search shipment records

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources