EximAgent

Find growing importer prospects

exim__prospects__find

Read-onlyIdempotent

Lists importers of an HS code in a market, filtered by growth, deliverable email, supplier origin and exclusion of an existing collection.

Input Schema

Name	Required	Description
`limit`	No	max rows (1-1000, default 100)
`hsCode`	Yes	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).
`growing`	No	only importers whose recent value beats prior by minGrowth
`hasEmail`	No	only importers the corpus can supply a deliverable email for
`minGrowth`	No	min growth ratio (def 0.25)
`sinceMonths`	No	Lookback window in months, 1 to 120 (default 12).
`excludeCollection`	No	drop importers already in this collection, by name or id (the not-my-customer filter)
`destinationCountry`	No	Destination (importing) country, ISO2 code (e.g. US, DE).
`excludeSupplierCountry`	No	Drop importers whose top supplier is in this country (ISO2).

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 / value11 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value11 / anyOf

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

addedOutput schema / $defs / value11 / properties

Added value: +{
+  "company": {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value13"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "fit": {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value12"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "membership": {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value14"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "pending": {
+    "anyOf": [
+      {
+        "$ref": "#/$defs/value17"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  }
+}

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

removedOutput schema / $defs / value12 / anyOf

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

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

addedOutput schema / $defs / value13 / properties / address

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

addedOutput schema / $defs / value13 / properties / base_url

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

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

addedOutput schema / $defs / value13 / properties / country

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

addedOutput schema / $defs / value13 / properties / description

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

addedOutput schema / $defs / value13 / properties / id

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

addedOutput schema / $defs / value13 / properties / industry

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

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

addedOutput schema / $defs / value13 / properties / trade_potential

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

addedOutput schema / $defs / value13 / properties / trade_potential_reasoning

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

addedOutput schema / $defs / value13 / properties / updated_at

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

addedOutput schema / $defs / value13 / properties / url

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

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

removedOutput schema / $defs / value14 / anyOf

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

addedOutput schema / $defs / value14 / properties

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

changedOutput schema / $defs / value15 / anyOf

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

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

addedOutput schema / $defs / value16 / anyOf

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

removedOutput schema / $defs / value16 / properties

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

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

removedOutput schema / $defs / value17 / anyOf

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

addedOutput schema / $defs / value17 / properties

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

addedOutput schema / $defs / value17 / required

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

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

addedOutput schema / $defs / value18

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

addedOutput schema / $defs / value19

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

addedOutput schema / $defs / value20

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

addedOutput schema / $defs / value21

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

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

addedOutput schema / $defs / value23

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

addedOutput schema / $defs / value24

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

addedOutput schema / $defs / value25

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

changedOutput schema / properties / _debug / $ref

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

addedOutput schema / properties / data / properties / context / anyOf

Added value: +[
+  {
+    "type": [
+      "null",
+      "boolean",
+      "number",
+      "string",
+      "array",
+      "object"
+    ]
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "collection": {
+        "$ref": "#/$defs/value18"
+      },
+      "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/value11"
+        }
+      ]
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / nextActions / $ref

Previous value: -"#/$defs/value12"New value: +"#/$defs/value20"

changedOutput schema / properties / stats / $ref

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

changedOutput schema / properties / warnings / $ref

Previous value: -"#/$defs/value15"New value: +"#/$defs/value23"

Changed77 schema fields changedOct 14, 2026

addedInput schema / properties / destinationCountry

Added value: +{
+  "description": "Destination (importing) country, ISO2 code (e.g. US, DE).",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / excludeSupplierCountry

Added value: +{
+  "description": "Drop importers whose top supplier is in this country (ISO2).",
+  "maxLength": 8000,
+  "type": "string"
+}

changedInput schema / properties / growing / description

Previous value: -"only importers whose recent value beats prior by --min_growth"New value: +"only importers whose recent value beats prior by minGrowth"

removedInput schema / properties / hs6

Removed value: -{
-  "description": "HS code at ANY granularity — 2/4/6-digit; a shorter code is a broader family (e.g. 0901 = all coffee). Do NOT pad to 6 digits: 090100 matches nothing.",
-  "maxLength": 8000,
-  "type": "string"
-}

addedInput schema / properties / hsCode

Added value: +{
+  "description": "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).",
+  "maxLength": 8000,
+  "type": "string"
+}

removedInput schema / properties / market

Removed value: -{
-  "description": "destination market (ISO2) the importers ship into",
-  "maxLength": 8000,
-  "type": "string"
-}

removedInput schema / properties / since

Removed value: -{
-  "description": "number of lookback months, 1 to 120 (default 12)",
-  "maximum": 120,
-  "minimum": 1,
-  "type": "integer"
-}

addedInput schema / properties / sinceMonths

Added value: +{
+  "description": "Lookback window in months, 1 to 120 (default 12).",
+  "maximum": 120,
+  "minimum": 1,
+  "type": "integer"
+}

removedInput schema / properties / supplierNot

Removed value: -{
-  "description": "exclude importers whose top supplier originates in this ISO2",
-  "maxLength": 8000,
-  "type": "string"
-}

changedInput schema / required

Previous value: -[
-  "hs6"
-]New value: +[
+  "hsCode"
+]

changedOutput schema / $defs / value1 / properties / scope / $ref

Previous value: -"#/$defs/value2"New value: +"#/$defs/value3"

addedOutput schema / $defs / value1 / properties / valueEvidence

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

changedOutput schema / $defs / value10 / anyOf

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

changedOutput schema / $defs / value11 / anyOf

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

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

addedOutput schema / $defs / value12 / anyOf

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

removedOutput schema / $defs / value12 / properties

Removed value: -{
-  "command": {
-    "type": "string"
-  },
-  "cost": {
-    "type": "string"
-  },
-  "label": {
-    "type": "string"
-  },
-  "rationale": {
-    "type": "string"
-  }
-}

removedOutput schema / $defs / value12 / required

Removed value: -[
-  "command",
-  "cost",
-  "label",
-  "rationale"
-]

removedOutput schema / $defs / value12 / type
```
Removed value: -"object"
```
addedOutput schema / $defs / value13 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value13 / anyOf

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

addedOutput schema / $defs / value13 / properties

Added value: +{
+  "command": {
+    "type": "string"
+  },
+  "cost": {
+    "type": "string"
+  },
+  "label": {
+    "type": "string"
+  },
+  "rationale": {
+    "type": "string"
+  }
+}

addedOutput schema / $defs / value13 / required

Added value: +[
+  "command",
+  "cost",
+  "label",
+  "rationale"
+]

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

changedOutput schema / $defs / value14 / anyOf

Previous value: -[
-  {
-    "items": {
-      "$ref": "#/$defs/value15"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {
+      "type": "number"
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

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

addedOutput schema / $defs / value15 / anyOf

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

removedOutput schema / $defs / value15 / properties

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

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

removedOutput schema / $defs / value16 / anyOf

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

addedOutput schema / $defs / value16 / properties

Added value: +{
+  "code": {
+    "type": "string"
+  },
+  "message": {
+    "type": "string"
+  }
+}

addedOutput schema / $defs / value16 / required
```
Added value: +[
+  "code",
+  "message"
+]
```
addedOutput schema / $defs / value16 / type
```
Added value: +"object"
```

addedOutput schema / $defs / value17

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

removedOutput schema / $defs / value2 / properties / CompanyKeys
```
Removed value: -{
-  "$ref": "#/$defs/value3"
-}
```
removedOutput schema / $defs / value2 / properties / Destination
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / Empty
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / $defs / value2 / properties / From

Removed value: -{
-  "format": "date-time",
-  "type": "string"
-}

removedOutput schema / $defs / value2 / properties / GroupBy
```
Removed value: -{
-  "$ref": "#/$defs/value5"
-}
```
removedOutput schema / $defs / value2 / properties / HS2
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / HS6
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / NormalizedNames
```
Removed value: -{
-  "$ref": "#/$defs/value4"
-}
```
removedOutput schema / $defs / value2 / properties / Origin
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / Population
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / ReportingCountry
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / RetainedFilters
```
Removed value: -{
-  "$ref": "#/$defs/value7"
-}
```
removedOutput schema / $defs / value2 / properties / Role
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / Source
```
Removed value: -{
-  "type": "string"
-}
```

removedOutput schema / $defs / value2 / properties / To

Removed value: -{
-  "format": "date-time",
-  "type": "string"
-}

removedOutput schema / $defs / value2 / properties / Transport
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / Unsupported
```
Removed value: -{
-  "$ref": "#/$defs/value6"
-}
```
addedOutput schema / $defs / value2 / properties / shipmentsExcludedImplausible
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / value2 / properties / shipmentsUsed
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / value2 / properties / weightKg
```
Added value: +{
+  "type": "number"
+}
```

changedOutput schema / $defs / value2 / required

Previous value: -[
-  "CompanyKeys",
-  "Destination",
-  "Empty",
-  "From",
-  "GroupBy",
-  "HS2",
-  "HS6",
-  "NormalizedNames",
-  "Origin",
-  "Population",
-  "ReportingCountry",
-  "RetainedFilters",
-  "Role",
-  "Source",
-  "To",
-  "Transport",
-  "Unsupported"
-]New value: +[
+  "shipmentsExcludedImplausible",
+  "shipmentsUsed",
+  "weightKg"
+]

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

removedOutput schema / $defs / value3 / anyOf

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

addedOutput schema / $defs / value3 / properties

Added value: +{
+  "CompanyKeys": {
+    "$ref": "#/$defs/value4"
+  },
+  "Destination": {
+    "type": "string"
+  },
+  "Empty": {
+    "type": "boolean"
+  },
+  "From": {
+    "format": "date-time",
+    "type": "string"
+  },
+  "GroupBy": {
+    "$ref": "#/$defs/value6"
+  },
+  "HS2": {
+    "type": "string"
+  },
+  "HS6": {
+    "type": "string"
+  },
+  "NormalizedNames": {
+    "$ref": "#/$defs/value5"
+  },
+  "Origin": {
+    "type": "string"
+  },
+  "Population": {
+    "type": "string"
+  },
+  "ReportingCountry": {
+    "type": "string"
+  },
+  "RetainedFilters": {
+    "$ref": "#/$defs/value8"
+  },
+  "Role": {
+    "type": "string"
+  },
+  "Source": {
+    "type": "string"
+  },
+  "To": {
+    "format": "date-time",
+    "type": "string"
+  },
+  "Transport": {
+    "type": "string"
+  },
+  "Unsupported": {
+    "$ref": "#/$defs/value7"
+  }
+}

addedOutput schema / $defs / value3 / required

Added value: +[
+  "CompanyKeys",
+  "Destination",
+  "Empty",
+  "From",
+  "GroupBy",
+  "HS2",
+  "HS6",
+  "NormalizedNames",
+  "Origin",
+  "Population",
+  "ReportingCountry",
+  "RetainedFilters",
+  "Role",
+  "Source",
+  "To",
+  "Transport",
+  "Unsupported"
+]

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

changedOutput schema / $defs / value7 / anyOf

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

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

addedOutput schema / $defs / value8 / anyOf

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

removedOutput schema / $defs / value8 / properties

Removed value: -{
-  "Column": {
-    "type": "string"
-  },
-  "Prefix": {
-    "type": "boolean"
-  },
-  "Values": {
-    "$ref": "#/$defs/value9"
-  }
-}

removedOutput schema / $defs / value8 / required

Removed value: -[
-  "Column",
-  "Prefix",
-  "Values"
-]

removedOutput schema / $defs / value8 / type
```
Removed value: -"object"
```
addedOutput schema / $defs / value9 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value9 / anyOf

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

addedOutput schema / $defs / value9 / properties

Added value: +{
+  "Column": {
+    "type": "string"
+  },
+  "Prefix": {
+    "type": "boolean"
+  },
+  "Values": {
+    "$ref": "#/$defs/value10"
+  }
+}

addedOutput schema / $defs / value9 / required

Added value: +[
+  "Column",
+  "Prefix",
+  "Values"
+]

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

changedOutput schema / properties / _debug / $ref

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

changedOutput schema / properties / nextActions / $ref

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

changedOutput schema / properties / stats / $ref

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

changedOutput schema / properties / warnings / $ref

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

Changed77 schema fields changedOct 14, 2026

removedInput schema / properties / destinationCountry

Removed value: -{
-  "description": "Destination (importing) country, ISO2 code (e.g. US, DE).",
-  "maxLength": 8000,
-  "type": "string"
-}

removedInput schema / properties / excludeSupplierCountry

Removed value: -{
-  "description": "Drop importers whose top supplier is in this country (ISO2).",
-  "maxLength": 8000,
-  "type": "string"
-}

changedInput schema / properties / growing / description

Previous value: -"only importers whose recent value beats prior by minGrowth"New value: +"only importers whose recent value beats prior by --min_growth"

addedInput schema / properties / hs6

Added value: +{
+  "description": "HS code at ANY granularity — 2/4/6-digit; a shorter code is a broader family (e.g. 0901 = all coffee). Do NOT pad to 6 digits: 090100 matches nothing.",
+  "maxLength": 8000,
+  "type": "string"
+}

removedInput schema / properties / hsCode

Removed value: -{
-  "description": "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).",
-  "maxLength": 8000,
-  "type": "string"
-}

addedInput schema / properties / market

Added value: +{
+  "description": "destination market (ISO2) the importers ship into",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / since

Added value: +{
+  "description": "number of lookback months, 1 to 120 (default 12)",
+  "maximum": 120,
+  "minimum": 1,
+  "type": "integer"
+}

removedInput schema / properties / sinceMonths

Removed value: -{
-  "description": "Lookback window in months, 1 to 120 (default 12).",
-  "maximum": 120,
-  "minimum": 1,
-  "type": "integer"
-}

addedInput schema / properties / supplierNot

Added value: +{
+  "description": "exclude importers whose top supplier originates in this ISO2",
+  "maxLength": 8000,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "hsCode"
-]New value: +[
+  "hs6"
+]

changedOutput schema / $defs / value1 / properties / scope / $ref

Previous value: -"#/$defs/value3"New value: +"#/$defs/value2"

removedOutput schema / $defs / value1 / properties / valueEvidence

Removed value: -{
-  "anyOf": [
-    {
-      "$ref": "#/$defs/value2"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

changedOutput schema / $defs / value10 / anyOf

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

changedOutput schema / $defs / value11 / anyOf

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

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

removedOutput schema / $defs / value12 / anyOf

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

addedOutput schema / $defs / value12 / properties

Added value: +{
+  "command": {
+    "type": "string"
+  },
+  "cost": {
+    "type": "string"
+  },
+  "label": {
+    "type": "string"
+  },
+  "rationale": {
+    "type": "string"
+  }
+}

addedOutput schema / $defs / value12 / required

Added value: +[
+  "command",
+  "cost",
+  "label",
+  "rationale"
+]

addedOutput schema / $defs / value12 / type
```
Added value: +"object"
```
removedOutput schema / $defs / value13 / additionalProperties
```
Removed value: -false
```

addedOutput schema / $defs / value13 / anyOf

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

removedOutput schema / $defs / value13 / properties

Removed value: -{
-  "command": {
-    "type": "string"
-  },
-  "cost": {
-    "type": "string"
-  },
-  "label": {
-    "type": "string"
-  },
-  "rationale": {
-    "type": "string"
-  }
-}

removedOutput schema / $defs / value13 / required

Removed value: -[
-  "command",
-  "cost",
-  "label",
-  "rationale"
-]

removedOutput schema / $defs / value13 / type
```
Removed value: -"object"
```

changedOutput schema / $defs / value14 / anyOf

Previous value: -[
-  {
-    "additionalProperties": {
-      "type": "number"
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "$ref": "#/$defs/value15"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

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

removedOutput schema / $defs / value15 / anyOf

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

addedOutput schema / $defs / value15 / properties

Added value: +{
+  "code": {
+    "type": "string"
+  },
+  "message": {
+    "type": "string"
+  }
+}

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

addedOutput schema / $defs / value16 / anyOf

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

removedOutput schema / $defs / value16 / properties

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

removedOutput schema / $defs / value16 / required
```
Removed value: -[
-  "code",
-  "message"
-]
```
removedOutput schema / $defs / value16 / type
```
Removed value: -"object"
```

removedOutput schema / $defs / value17

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

addedOutput schema / $defs / value2 / properties / CompanyKeys
```
Added value: +{
+  "$ref": "#/$defs/value3"
+}
```
addedOutput schema / $defs / value2 / properties / Destination
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value2 / properties / Empty
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / $defs / value2 / properties / From

Added value: +{
+  "format": "date-time",
+  "type": "string"
+}

addedOutput schema / $defs / value2 / properties / GroupBy
```
Added value: +{
+  "$ref": "#/$defs/value5"
+}
```
addedOutput schema / $defs / value2 / properties / HS2
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value2 / properties / HS6
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value2 / properties / NormalizedNames
```
Added value: +{
+  "$ref": "#/$defs/value4"
+}
```
addedOutput schema / $defs / value2 / properties / Origin
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value2 / properties / Population
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value2 / properties / ReportingCountry
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value2 / properties / RetainedFilters
```
Added value: +{
+  "$ref": "#/$defs/value7"
+}
```
addedOutput schema / $defs / value2 / properties / Role
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value2 / properties / Source
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / $defs / value2 / properties / To

Added value: +{
+  "format": "date-time",
+  "type": "string"
+}

addedOutput schema / $defs / value2 / properties / Transport
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value2 / properties / Unsupported
```
Added value: +{
+  "$ref": "#/$defs/value6"
+}
```
removedOutput schema / $defs / value2 / properties / shipmentsExcludedImplausible
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / value2 / properties / shipmentsUsed
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / value2 / properties / weightKg
```
Removed value: -{
-  "type": "number"
-}
```

changedOutput schema / $defs / value2 / required

Previous value: -[
-  "shipmentsExcludedImplausible",
-  "shipmentsUsed",
-  "weightKg"
-]New value: +[
+  "CompanyKeys",
+  "Destination",
+  "Empty",
+  "From",
+  "GroupBy",
+  "HS2",
+  "HS6",
+  "NormalizedNames",
+  "Origin",
+  "Population",
+  "ReportingCountry",
+  "RetainedFilters",
+  "Role",
+  "Source",
+  "To",
+  "Transport",
+  "Unsupported"
+]

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

addedOutput schema / $defs / value3 / anyOf

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

removedOutput schema / $defs / value3 / properties

Removed value: -{
-  "CompanyKeys": {
-    "$ref": "#/$defs/value4"
-  },
-  "Destination": {
-    "type": "string"
-  },
-  "Empty": {
-    "type": "boolean"
-  },
-  "From": {
-    "format": "date-time",
-    "type": "string"
-  },
-  "GroupBy": {
-    "$ref": "#/$defs/value6"
-  },
-  "HS2": {
-    "type": "string"
-  },
-  "HS6": {
-    "type": "string"
-  },
-  "NormalizedNames": {
-    "$ref": "#/$defs/value5"
-  },
-  "Origin": {
-    "type": "string"
-  },
-  "Population": {
-    "type": "string"
-  },
-  "ReportingCountry": {
-    "type": "string"
-  },
-  "RetainedFilters": {
-    "$ref": "#/$defs/value8"
-  },
-  "Role": {
-    "type": "string"
-  },
-  "Source": {
-    "type": "string"
-  },
-  "To": {
-    "format": "date-time",
-    "type": "string"
-  },
-  "Transport": {
-    "type": "string"
-  },
-  "Unsupported": {
-    "$ref": "#/$defs/value7"
-  }
-}

removedOutput schema / $defs / value3 / required

Removed value: -[
-  "CompanyKeys",
-  "Destination",
-  "Empty",
-  "From",
-  "GroupBy",
-  "HS2",
-  "HS6",
-  "NormalizedNames",
-  "Origin",
-  "Population",
-  "ReportingCountry",
-  "RetainedFilters",
-  "Role",
-  "Source",
-  "To",
-  "Transport",
-  "Unsupported"
-]

removedOutput schema / $defs / value3 / type
```
Removed value: -"object"
```

changedOutput schema / $defs / value7 / anyOf

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

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

removedOutput schema / $defs / value8 / anyOf

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

addedOutput schema / $defs / value8 / properties

Added value: +{
+  "Column": {
+    "type": "string"
+  },
+  "Prefix": {
+    "type": "boolean"
+  },
+  "Values": {
+    "$ref": "#/$defs/value9"
+  }
+}

addedOutput schema / $defs / value8 / required

Added value: +[
+  "Column",
+  "Prefix",
+  "Values"
+]

addedOutput schema / $defs / value8 / type
```
Added value: +"object"
```
removedOutput schema / $defs / value9 / additionalProperties
```
Removed value: -false
```

addedOutput schema / $defs / value9 / anyOf

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

removedOutput schema / $defs / value9 / properties

Removed value: -{
-  "Column": {
-    "type": "string"
-  },
-  "Prefix": {
-    "type": "boolean"
-  },
-  "Values": {
-    "$ref": "#/$defs/value10"
-  }
-}

removedOutput schema / $defs / value9 / required

Removed value: -[
-  "Column",
-  "Prefix",
-  "Values"
-]

removedOutput schema / $defs / value9 / type
```
Removed value: -"object"
```

changedOutput schema / properties / _debug / $ref

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

changedOutput schema / properties / nextActions / $ref

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

changedOutput schema / properties / stats / $ref

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

changedOutput schema / properties / warnings / $ref

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

Changed77 schema fields changedOct 14, 2026

addedInput schema / properties / destinationCountry

Added value: +{
+  "description": "Destination (importing) country, ISO2 code (e.g. US, DE).",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / excludeSupplierCountry

Added value: +{
+  "description": "Drop importers whose top supplier is in this country (ISO2).",
+  "maxLength": 8000,
+  "type": "string"
+}

changedInput schema / properties / growing / description

Previous value: -"only importers whose recent value beats prior by --min_growth"New value: +"only importers whose recent value beats prior by minGrowth"

removedInput schema / properties / hs6

Removed value: -{
-  "description": "HS code at ANY granularity — 2/4/6-digit; a shorter code is a broader family (e.g. 0901 = all coffee). Do NOT pad to 6 digits: 090100 matches nothing.",
-  "maxLength": 8000,
-  "type": "string"
-}

addedInput schema / properties / hsCode

Added value: +{
+  "description": "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).",
+  "maxLength": 8000,
+  "type": "string"
+}

removedInput schema / properties / market

Removed value: -{
-  "description": "destination market (ISO2) the importers ship into",
-  "maxLength": 8000,
-  "type": "string"
-}

removedInput schema / properties / since

Removed value: -{
-  "description": "number of lookback months, 1 to 120 (default 12)",
-  "maximum": 120,
-  "minimum": 1,
-  "type": "integer"
-}

addedInput schema / properties / sinceMonths

Added value: +{
+  "description": "Lookback window in months, 1 to 120 (default 12).",
+  "maximum": 120,
+  "minimum": 1,
+  "type": "integer"
+}

removedInput schema / properties / supplierNot

Removed value: -{
-  "description": "exclude importers whose top supplier originates in this ISO2",
-  "maxLength": 8000,
-  "type": "string"
-}

changedInput schema / required

Previous value: -[
-  "hs6"
-]New value: +[
+  "hsCode"
+]

changedOutput schema / $defs / value1 / properties / scope / $ref

Previous value: -"#/$defs/value2"New value: +"#/$defs/value3"

addedOutput schema / $defs / value1 / properties / valueEvidence

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

changedOutput schema / $defs / value10 / anyOf

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

changedOutput schema / $defs / value11 / anyOf

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

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

addedOutput schema / $defs / value12 / anyOf

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

removedOutput schema / $defs / value12 / properties

Removed value: -{
-  "command": {
-    "type": "string"
-  },
-  "cost": {
-    "type": "string"
-  },
-  "label": {
-    "type": "string"
-  },
-  "rationale": {
-    "type": "string"
-  }
-}

removedOutput schema / $defs / value12 / required

Removed value: -[
-  "command",
-  "cost",
-  "label",
-  "rationale"
-]

removedOutput schema / $defs / value12 / type
```
Removed value: -"object"
```
addedOutput schema / $defs / value13 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value13 / anyOf

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

addedOutput schema / $defs / value13 / properties

Added value: +{
+  "command": {
+    "type": "string"
+  },
+  "cost": {
+    "type": "string"
+  },
+  "label": {
+    "type": "string"
+  },
+  "rationale": {
+    "type": "string"
+  }
+}

addedOutput schema / $defs / value13 / required

Added value: +[
+  "command",
+  "cost",
+  "label",
+  "rationale"
+]

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

changedOutput schema / $defs / value14 / anyOf

Previous value: -[
-  {
-    "items": {
-      "$ref": "#/$defs/value15"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {
+      "type": "number"
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

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

addedOutput schema / $defs / value15 / anyOf

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

removedOutput schema / $defs / value15 / properties

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

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

removedOutput schema / $defs / value16 / anyOf

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

addedOutput schema / $defs / value16 / properties

Added value: +{
+  "code": {
+    "type": "string"
+  },
+  "message": {
+    "type": "string"
+  }
+}

addedOutput schema / $defs / value16 / required
```
Added value: +[
+  "code",
+  "message"
+]
```
addedOutput schema / $defs / value16 / type
```
Added value: +"object"
```

addedOutput schema / $defs / value17

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

removedOutput schema / $defs / value2 / properties / CompanyKeys
```
Removed value: -{
-  "$ref": "#/$defs/value3"
-}
```
removedOutput schema / $defs / value2 / properties / Destination
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / Empty
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / $defs / value2 / properties / From

Removed value: -{
-  "format": "date-time",
-  "type": "string"
-}

removedOutput schema / $defs / value2 / properties / GroupBy
```
Removed value: -{
-  "$ref": "#/$defs/value5"
-}
```
removedOutput schema / $defs / value2 / properties / HS2
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / HS6
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / NormalizedNames
```
Removed value: -{
-  "$ref": "#/$defs/value4"
-}
```
removedOutput schema / $defs / value2 / properties / Origin
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / Population
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / ReportingCountry
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / RetainedFilters
```
Removed value: -{
-  "$ref": "#/$defs/value7"
-}
```
removedOutput schema / $defs / value2 / properties / Role
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / Source
```
Removed value: -{
-  "type": "string"
-}
```

removedOutput schema / $defs / value2 / properties / To

Removed value: -{
-  "format": "date-time",
-  "type": "string"
-}

removedOutput schema / $defs / value2 / properties / Transport
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / value2 / properties / Unsupported
```
Removed value: -{
-  "$ref": "#/$defs/value6"
-}
```
addedOutput schema / $defs / value2 / properties / shipmentsExcludedImplausible
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / value2 / properties / shipmentsUsed
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / value2 / properties / weightKg
```
Added value: +{
+  "type": "number"
+}
```

changedOutput schema / $defs / value2 / required

Previous value: -[
-  "CompanyKeys",
-  "Destination",
-  "Empty",
-  "From",
-  "GroupBy",
-  "HS2",
-  "HS6",
-  "NormalizedNames",
-  "Origin",
-  "Population",
-  "ReportingCountry",
-  "RetainedFilters",
-  "Role",
-  "Source",
-  "To",
-  "Transport",
-  "Unsupported"
-]New value: +[
+  "shipmentsExcludedImplausible",
+  "shipmentsUsed",
+  "weightKg"
+]

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

removedOutput schema / $defs / value3 / anyOf

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

addedOutput schema / $defs / value3 / properties

Added value: +{
+  "CompanyKeys": {
+    "$ref": "#/$defs/value4"
+  },
+  "Destination": {
+    "type": "string"
+  },
+  "Empty": {
+    "type": "boolean"
+  },
+  "From": {
+    "format": "date-time",
+    "type": "string"
+  },
+  "GroupBy": {
+    "$ref": "#/$defs/value6"
+  },
+  "HS2": {
+    "type": "string"
+  },
+  "HS6": {
+    "type": "string"
+  },
+  "NormalizedNames": {
+    "$ref": "#/$defs/value5"
+  },
+  "Origin": {
+    "type": "string"
+  },
+  "Population": {
+    "type": "string"
+  },
+  "ReportingCountry": {
+    "type": "string"
+  },
+  "RetainedFilters": {
+    "$ref": "#/$defs/value8"
+  },
+  "Role": {
+    "type": "string"
+  },
+  "Source": {
+    "type": "string"
+  },
+  "To": {
+    "format": "date-time",
+    "type": "string"
+  },
+  "Transport": {
+    "type": "string"
+  },
+  "Unsupported": {
+    "$ref": "#/$defs/value7"
+  }
+}

addedOutput schema / $defs / value3 / required

Added value: +[
+  "CompanyKeys",
+  "Destination",
+  "Empty",
+  "From",
+  "GroupBy",
+  "HS2",
+  "HS6",
+  "NormalizedNames",
+  "Origin",
+  "Population",
+  "ReportingCountry",
+  "RetainedFilters",
+  "Role",
+  "Source",
+  "To",
+  "Transport",
+  "Unsupported"
+]

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

changedOutput schema / $defs / value7 / anyOf

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

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

addedOutput schema / $defs / value8 / anyOf

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

removedOutput schema / $defs / value8 / properties

Removed value: -{
-  "Column": {
-    "type": "string"
-  },
-  "Prefix": {
-    "type": "boolean"
-  },
-  "Values": {
-    "$ref": "#/$defs/value9"
-  }
-}

removedOutput schema / $defs / value8 / required

Removed value: -[
-  "Column",
-  "Prefix",
-  "Values"
-]

removedOutput schema / $defs / value8 / type
```
Removed value: -"object"
```
addedOutput schema / $defs / value9 / additionalProperties
```
Added value: +false
```

removedOutput schema / $defs / value9 / anyOf

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

addedOutput schema / $defs / value9 / properties

Added value: +{
+  "Column": {
+    "type": "string"
+  },
+  "Prefix": {
+    "type": "boolean"
+  },
+  "Values": {
+    "$ref": "#/$defs/value10"
+  }
+}

addedOutput schema / $defs / value9 / required

Added value: +[
+  "Column",
+  "Prefix",
+  "Values"
+]

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

changedOutput schema / properties / _debug / $ref

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

changedOutput schema / properties / nextActions / $ref

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

changedOutput schema / properties / stats / $ref

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

changedOutput schema / properties / warnings / $ref

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

Changed20 schema fields changedOct 13, 2026

removedInput schema / properties / --excludeCollection

Removed value: -{
-  "description": "drop importers already in this collection, by name or id (the not-my-customer filter)",
-  "type": "string"
-}

removedInput schema / properties / --growing

Removed value: -{
-  "description": "only importers whose recent value beats prior by --min_growth",
-  "type": "boolean"
-}

removedInput schema / properties / --hasEmail

Removed value: -{
-  "description": "only importers the corpus can supply a deliverable email for",
-  "type": "boolean"
-}

removedInput schema / properties / --hs6

Removed value: -{
-  "description": "HS code at ANY granularity — 2/4/6-digit; a shorter code is a broader family (e.g. 0901 = all coffee). Do NOT pad to 6 digits: 090100 matches nothing.",
-  "type": "string"
-}

removedInput schema / properties / --limit

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

removedInput schema / properties / --market

Removed value: -{
-  "description": "destination market (ISO2) the importers ship into",
-  "type": "string"
-}

removedInput schema / properties / --minGrowth

Removed value: -{
-  "description": "min growth ratio (def 0.25)",
-  "type": "number"
-}

removedInput schema / properties / --since

Removed value: -{
-  "description": "number of lookback months, 1 to 120 (default 12)",
-  "type": "integer"
-}

removedInput schema / properties / --supplierNot

Removed value: -{
-  "description": "exclude importers whose top supplier originates in this ISO2",
-  "type": "string"
-}

addedInput schema / properties / excludeCollection

Added value: +{
+  "description": "drop importers already in this collection, by name or id (the not-my-customer filter)",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / growing

Added value: +{
+  "description": "only importers whose recent value beats prior by --min_growth",
+  "type": "boolean"
+}

addedInput schema / properties / hasEmail

Added value: +{
+  "description": "only importers the corpus can supply a deliverable email for",
+  "type": "boolean"
+}

addedInput schema / properties / hs6

Added value: +{
+  "description": "HS code at ANY granularity — 2/4/6-digit; a shorter code is a broader family (e.g. 0901 = all coffee). Do NOT pad to 6 digits: 090100 matches nothing.",
+  "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 / market

Added value: +{
+  "description": "destination market (ISO2) the importers ship into",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / minGrowth

Added value: +{
+  "description": "min growth ratio (def 0.25)",
+  "type": "number"
+}

addedInput schema / properties / since

Added value: +{
+  "description": "number of lookback months, 1 to 120 (default 12)",
+  "maximum": 120,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / supplierNot

Added value: +{
+  "description": "exclude importers whose top supplier originates in this ISO2",
+  "maxLength": 8000,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "--hs6"
-]New value: +[
+  "hs6"
+]

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$defs": {
+    "value0": {
+      "additionalProperties": false,
+      "properties": {
+        "activeMonths": {
+          "type": "integer"
+        },
+        "companyKey": {
+          "type": "string"
+        },
+        "country": {
+          "type": "string"
+        },
+        "enrichmentHistory": {
+          "$ref": "#/$defs/value1"
+        },
+        "growthRatio": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "hasEmail": {
+          "type": "boolean"
+        },
+        "lastSeen": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "priorValueUsd": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "recentValueUsd": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "shipmentCount": {
+          "type": "integer"
+        },
+        "taxId": {
+          "type": "string"
+        },
+        "topSupplier": {
+          "type": "string"
+        },
+        "topSupplierOrigin": {
+          "type": "string"
+        },
+        "totalValueUsd": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "activeMonths",
+        "companyKey",
+        "country",
+        "enrichmentHistory",
+        "growthRatio",
+        "hasEmail",
+        "lastSeen",
+        "name",
+        "priorValueUsd",
+        "recentValueUsd",
+        "shipmentCount",
+        "taxId",
+        "topSupplier",
+        "topSupplierOrigin",
+        "totalValueUsd"
+      ],
+      "type": "object"
+    },
+    "value1": {
+      "additionalProperties": false,
+      "properties": {
+        "action": {
+          "type": "string"
+        },
+        "builtAt": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "correctionsThrough": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "factsThrough": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "scope": {
+          "$ref": "#/$defs/value2"
+        },
+        "state": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "builtAt",
+        "correctionsThrough",
+        "factsThrough",
+        "reason",
+        "scope",
+        "state"
+      ],
+      "type": "object"
+    },
+    "value10": {
+      "anyOf": [
+        {
+          "items": {
+            "type": [
+              "null",
+              "boolean",
+              "number",
+              "string",
+              "array",
+              "object"
+            ]
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value11": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value12"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value12": {
+      "additionalProperties": false,
+      "properties": {
+        "command": {
+          "type": "string"
+        },
+        "cost": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "rationale": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "command",
+        "cost",
+        "label",
+        "rationale"
+      ],
+      "type": "object"
+    },
+    "value13": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "type": "number"
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value14": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value15"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value15": {
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ],
+      "type": "object"
+    },
+    "value16": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "type": [
+              "null",
+              "boolean",
+              "number",
+              "string",
+              "array",
+              "object"
+            ]
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value2": {
+      "additionalProperties": false,
+      "properties": {
+        "CompanyKeys": {
+          "$ref": "#/$defs/value3"
+        },
+        "Destination": {
+          "type": "string"
+        },
+        "Empty": {
+          "type": "boolean"
+        },
+        "From": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "GroupBy": {
+          "$ref": "#/$defs/value5"
+        },
+        "HS2": {
+          "type": "string"
+        },
+        "HS6": {
+          "type": "string"
+        },
+        "NormalizedNames": {
+          "$ref": "#/$defs/value4"
+        },
+        "Origin": {
+          "type": "string"
+        },
+        "Population": {
+          "type": "string"
+        },
+        "ReportingCountry": {
+          "type": "string"
+        },
+        "RetainedFilters": {
+          "$ref": "#/$defs/value7"
+        },
+        "Role": {
+          "type": "string"
+        },
+        "Source": {
+          "type": "string"
+        },
+        "To": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "Transport": {
+          "type": "string"
+        },
+        "Unsupported": {
+          "$ref": "#/$defs/value6"
+        }
+      },
+      "required": [
+        "CompanyKeys",
+        "Destination",
+        "Empty",
+        "From",
+        "GroupBy",
+        "HS2",
+        "HS6",
+        "NormalizedNames",
+        "Origin",
+        "Population",
+        "ReportingCountry",
+        "RetainedFilters",
+        "Role",
+        "Source",
+        "To",
+        "Transport",
+        "Unsupported"
+      ],
+      "type": "object"
+    },
+    "value3": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value4": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value5": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value6": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value7": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value8"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value8": {
+      "additionalProperties": false,
+      "properties": {
+        "Column": {
+          "type": "string"
+        },
+        "Prefix": {
+          "type": "boolean"
+        },
+        "Values": {
+          "$ref": "#/$defs/value9"
+        }
+      },
+      "required": [
+        "Column",
+        "Prefix",
+        "Values"
+      ],
+      "type": "object"
+    },
+    "value9": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false,
+  "properties": {
+    "_debug": {
+      "$ref": "#/$defs/value16"
+    },
+    "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/value11"
+    },
+    "stats": {
+      "$ref": "#/$defs/value13"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "warnings": {
+      "$ref": "#/$defs/value14"
+    }
+  },
+  "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/openWorld=false, so the safety profile is covered. The description adds filter semantics and hints at corpus email deliverability, but says nothing about result limits behavior, pagination, or ordering beyond what the schema conveys. Appropriate additive value for the annotation coverage.

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?

A single tight sentence that front-loads the core action and enumerates the filter axes. Zero waste, though it packs several filters into one clause rather than structuring them.

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?

With an output schema present, return values needn't be explained, and the schema fully documents the 9 parameters. However, for a prospect-discovery tool with many filter combinations, the description gives no usage context for how the filters interact (growing vs minGrowth, excludeCollection semantics) or what a realistic call looks like.

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%, so each parameter is already documented with types, ranges, and semantics (e.g. HS code padding, ISO2 codes). The description merely names the filter dimensions and adds no syntax or example detail beyond the schema, so 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-and-resource ('Lists importers of an HS code in a market') with the filter dimensions it supports. An agent can tell it produces a prospect list rather than analytics or company profiles. It doesn't explicitly name a sibling it replaces/overlaps, so it stops short of 5.

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 filter set implies the use case (building a growing-importer prospect list), but there's no explicit 'use this when / not when' guidance or pointer to alternatives like companies__list or search__run. Context for choosing this tool over siblings is left to inference.

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.

Find growing importer prospects

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources