EximAgent

Shipments on a country route

exim__route__shipments

Read-onlyIdempotent

Lists shipments from one origin country to one destination country. Use it to sample trade on a specific lane.

Input Schema

Name	Required	Description
`limit`	No	max rows (1-1000, default 100)
`originCountry`	Yes	Origin (exporting) country, ISO2 code (e.g. VN).
`destinationCountry`	Yes	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.

Changed57 schema fields changedOct 28, 2026

removedOutput schema / $defs / value10 / additionalProperties
```
Removed value: -false
```

addedOutput schema / $defs / value10 / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / $defs / value10 / properties

Removed value: -{
-  "code": {
-    "type": "string"
-  },
-  "message": {
-    "type": "string"
-  }
-}

removedOutput schema / $defs / value10 / required
```
Removed value: -[
-  "code",
-  "message"
-]
```
removedOutput schema / $defs / value10 / type
```
Removed value: -"object"
```
addedOutput schema / $defs / value11 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value11 / anyOf

Removed value: -[
-  {
-    "additionalProperties": {
-      "type": [
-        "null",
-        "boolean",
-        "number",
-        "string",
-        "array",
-        "object"
-      ]
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / $defs / value11 / properties

Added value: +{
+  "displayName": {
+    "type": "string"
+  },
+  "message": {
+    "type": "string"
+  },
+  "pendingId": {
+    "type": "string"
+  },
+  "reportingCountry": {
+    "type": "string"
+  },
+  "status": {
+    "type": "string"
+  }
+}

addedOutput schema / $defs / value11 / required

Added value: +[
+  "displayName",
+  "message",
+  "pendingId",
+  "reportingCountry",
+  "status"
+]

addedOutput schema / $defs / value11 / type
```
Added value: +"object"
```

addedOutput schema / $defs / value12

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

addedOutput schema / $defs / value13

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": [
+          "null",
+          "boolean",
+          "number",
+          "string",
+          "array",
+          "object"
+        ]
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value14

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "$ref": "#/$defs/value15"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value15

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 / value16

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {
+        "type": "number"
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value17

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "$ref": "#/$defs/value18"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value18

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

addedOutput schema / $defs / value19

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {
+        "type": [
+          "null",
+          "boolean",
+          "number",
+          "string",
+          "array",
+          "object"
+        ]
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value5 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value5 / anyOf

Removed value: -[
-  {
-    "items": {
-      "type": [
-        "null",
-        "boolean",
-        "number",
-        "string",
-        "array",
-        "object"
-      ]
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / $defs / value5 / properties

Added value: +{
+  "company": {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value7"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "fit": {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value6"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "membership": {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value8"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "pending": {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value11"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  }
+}

addedOutput schema / $defs / value5 / type
```
Added value: +"object"
```
addedOutput schema / $defs / value6 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value6 / anyOf

Removed value: -[
-  {
-    "items": {
-      "$ref": "#/$defs/value7"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / $defs / value6 / 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 / value6 / 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 / value6 / type
```
Added value: +"object"
```

addedOutput schema / $defs / value7 / properties / address

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value7 / properties / base_url

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value7 / properties / canonical_url
```
Added value: +{
+  "type": "string"
+}
```
removedOutput schema / $defs / value7 / properties / command
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value7 / properties / cost
```
Removed value: -{
-  "type": "string"
-}
```

addedOutput schema / $defs / value7 / properties / country

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value7 / properties / description

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value7 / properties / id

Added value: +{
+  "anyOf": [
+    {
+      "format": "uuid",
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value7 / properties / industry

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

removedOutput schema / $defs / value7 / properties / label
```
Removed value: -{
-  "type": "string"
-}
```
addedOutput schema / $defs / value7 / properties / name
```
Added value: +{
+  "type": "string"
+}
```
removedOutput schema / $defs / value7 / properties / rationale
```
Removed value: -{
-  "type": "string"
-}
```
addedOutput schema / $defs / value7 / properties / resolution_source
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / $defs / value7 / properties / trade_potential

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value7 / properties / trade_potential_reasoning

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value7 / properties / updated_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / $defs / value7 / properties / url

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / $defs / value7 / 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 / value8 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value8 / anyOf

Removed value: -[
-  {
-    "additionalProperties": {
-      "type": "number"
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / $defs / value8 / properties

Added value: +{
+  "ai_column_meta": {
+    "type": [
+      "null",
+      "boolean",
+      "number",
+      "string",
+      "array",
+      "object"
+    ]
+  },
+  "ai_column_values": {
+    "$ref": "#/$defs/value10"
+  },
+  "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/value9"
+  },
+  "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 / value8 / 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 / value8 / type
```
Added value: +"object"
```

changedOutput schema / $defs / value9 / anyOf

Previous value: -[
-  {
-    "items": {
-      "$ref": "#/$defs/value10"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / _debug / $ref

Previous value: -"#/$defs/value11"New value: +"#/$defs/value19"

changedOutput schema / properties / data / properties / context / anyOf

Previous value: -[
-  {
-    "$ref": "#/$defs/value1"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value1"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "collection": {
+        "$ref": "#/$defs/value12"
+      },
+      "sourceObservation": {
+        "type": [
+          "null",
+          "boolean",
+          "number",
+          "string",
+          "array",
+          "object"
+        ]
+      }
+    },
+    "required": [
+      "sourceObservation"
+    ],
+    "type": "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/value5"
+        }
+      ]
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / nextActions / $ref

Previous value: -"#/$defs/value6"New value: +"#/$defs/value14"

changedOutput schema / properties / stats / $ref

Previous value: -"#/$defs/value8"New value: +"#/$defs/value16"

changedOutput schema / properties / warnings / $ref

Previous value: -"#/$defs/value9"New value: +"#/$defs/value17"

Changed5 schema fields changedOct 14, 2026

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

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

changedInput schema / required

Previous value: -[
-  "dest",
-  "origin"
-]New value: +[
+  "destinationCountry",
+  "originCountry"
+]

Changed5 schema fields changedOct 14, 2026

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

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

changedInput schema / required

Previous value: -[
-  "destinationCountry",
-  "originCountry"
-]New value: +[
+  "dest",
+  "origin"
+]

Changed5 schema fields changedOct 14, 2026

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

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

changedInput schema / required

Previous value: -[
-  "dest",
-  "origin"
-]New value: +[
+  "destinationCountry",
+  "originCountry"
+]

Changed8 schema fields changedOct 13, 2026

removedInput schema / properties / --dest

Removed value: -{
-  "description": "Destination country (ISO 2)",
-  "type": "string"
-}

removedInput schema / properties / --limit

Removed value: -{
-  "description": "max rows (1-1000, default 100)",
-  "type": "integer"
-}

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 / limit

Added value: +{
+  "description": "max rows (1-1000, default 100)",
+  "maximum": 1000,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / origin

Added value: +{
+  "description": "Origin country (ISO 2)",
+  "maxLength": 8000,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "--dest",
-  "--origin"
-]New value: +[
+  "dest",
+  "origin"
+]

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": {
+      "additionalProperties": false,
+      "properties": {
+        "coverage": {
+          "$ref": "#/$defs/value2"
+        }
+      },
+      "required": [
+        "coverage"
+      ],
+      "type": "object"
+    },
+    "value10": {
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ],
+      "type": "object"
+    },
+    "value11": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "type": [
+              "null",
+              "boolean",
+              "number",
+              "string",
+              "array",
+              "object"
+            ]
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value2": {
+      "additionalProperties": false,
+      "properties": {
+        "blindSpot": {
+          "type": "string"
+        },
+        "confidence": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "country": {
+          "$ref": "#/$defs/value3"
+        },
+        "display": {
+          "type": "string"
+        },
+        "period": {
+          "$ref": "#/$defs/value4"
+        },
+        "scope": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "confidence",
+        "country",
+        "display",
+        "period",
+        "status"
+      ],
+      "type": "object"
+    },
+    "value3": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value4": {
+      "additionalProperties": false,
+      "properties": {
+        "end": {
+          "type": "string"
+        },
+        "start": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "end",
+        "start"
+      ],
+      "type": "object"
+    },
+    "value5": {
+      "anyOf": [
+        {
+          "items": {
+            "type": [
+              "null",
+              "boolean",
+              "number",
+              "string",
+              "array",
+              "object"
+            ]
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value6": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value7"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value7": {
+      "additionalProperties": false,
+      "properties": {
+        "command": {
+          "type": "string"
+        },
+        "cost": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "rationale": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "command",
+        "cost",
+        "label",
+        "rationale"
+      ],
+      "type": "object"
+    },
+    "value8": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "type": "number"
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value9": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value10"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false,
+  "properties": {
+    "_debug": {
+      "$ref": "#/$defs/value11"
+    },
+    "correlationId": {
+      "type": "string"
+    },
+    "data": {
+      "additionalProperties": false,
+      "properties": {
+        "context": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/value1"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "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/value6"
+    },
+    "stats": {
+      "$ref": "#/$defs/value8"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "warnings": {
+      "$ref": "#/$defs/value9"
+    }
+  },
+  "required": [
+    "data",
+    "nextActions",
+    "summary"
+  ],
+  "type": "object"
+}

First observedOct 9, 2026

TDQS

A3.6/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, and an output schema exists, so the description is not carrying the safety or return-shape burden. It adds only the 'sampling trade on a lane' intent, with no mention of pagination, result ordering, or dataset coverage — useful but thin.

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?

Two short sentences, no filler, with the scope constraint ('one origin to one destination') front-loaded before the usage cue. Every sentence earns its place.

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

Completeness4/5

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

For a simple filtered read tool with rich annotations, full schema coverage and an output schema, the description covers what is needed to invoke it correctly. The only gap is routing guidance against the many overlapping shipment siblings, which is arguably a description-level concern.

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 coverage is 100%: both country parameters are described as ISO2 codes and limit is documented as 1-1000 with a default of 100. The description adds nothing about parameter formats or semantics, so the schema does all the work — the 3 baseline 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 ('Lists') and precise resource ('shipments') scoped to one origin and one destination country, which separates it from broad tools like exim__shipments__search or the company/product-scoped shipment tools. It does not name any sibling explicitly, so the differentiation is inferred rather than stated.

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?

Adds a usage hint ('Use it to sample trade on a specific lane') that implies the appropriate context, but gives no when-not conditions and never points to alternatives such as exim__shipments__search or exim__shipments__route-signals, which overlap heavily.

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.

Shipments on a country route

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources