EximAgent

List companies in collection

exim__collection__items__list

Read-onlyIdempotent

Lists company rows in a collection with score, priority, country, contacts and outreach stage, with filters and paging.

Input Schema

Name	Required	Description
`q`	No	Search recorded company names across the full collection
`name`	No	Collection name (alternative to collectionId)
`limit`	No	Max rows to return per page (default 50, max 500). For full enumeration, pass the previous response cursor.
`order`	No	Captured row order; defaults to change_seq_asc
`stage`	No	Saved company stage or unstaged; omit for all stages
`value`	No	Value that column must equal
`column`	No	Narrow to rows whose column equals value
`cursor`	No	Opaque cursor from the previous response; omit for the first page
`profile`	No	Unsupported during reads; invoke ranking separately to store fits
`priority`	No	Filter to this priority only
`collectionId`	No	Collection to list — accepts the collectionId returned by search/recipe outputs OR the collection name. Same arg name as every other collection/email/enrich command. Use this when chaining from a recipe.

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.

Changed39 schema fields changedOct 22, 2026

addedOutput schema / $defs / value18 / properties / change_seq
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / value18 / properties / generation
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value18 / properties / has_more
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / $defs / value18 / properties / matchedTotal
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / value18 / properties / order
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / value18 / properties / pendingCompanies
```
Added value: +{
+  "$ref": "#/$defs/value19"
+}
```
addedOutput schema / $defs / value18 / properties / pendingCount
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / value18 / properties / pendingTotal
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / value18 / properties / totalItems
```
Added value: +{
+  "type": "integer"
+}
```

changedOutput schema / $defs / value18 / required

Previous value: -[
-  "collectionId"
-]New value: +[
+  "change_seq",
+  "collectionId",
+  "generation",
+  "has_more",
+  "matchedTotal",
+  "order",
+  "pendingCompanies",
+  "pendingCount",
+  "pendingTotal",
+  "totalItems"
+]

changedOutput schema / $defs / value19 / anyOf

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

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

removedOutput schema / $defs / value20 / anyOf

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

addedOutput schema / $defs / value20 / properties

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

addedOutput schema / $defs / value20 / required

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

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

addedOutput schema / $defs / value21 / anyOf

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

removedOutput schema / $defs / value21 / properties

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

removedOutput schema / $defs / value21 / required

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

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

changedOutput schema / $defs / value22 / anyOf

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

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

removedOutput schema / $defs / value23 / anyOf

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

addedOutput schema / $defs / value23 / properties

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

addedOutput schema / $defs / value23 / required

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

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

addedOutput schema / $defs / value24 / anyOf

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

removedOutput schema / $defs / value24 / properties

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

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

changedOutput schema / $defs / value25 / anyOf

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

addedOutput schema / $defs / value26

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

addedOutput schema / $defs / value27

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

changedOutput schema / properties / _debug / $ref

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

changedOutput schema / properties / nextActions / $ref

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

changedOutput schema / properties / stats / $ref

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

changedOutput schema / properties / warnings / $ref

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

Changed2 schema fields changedOct 14, 2026

changedInput schema / properties / column / description

Previous value: -"Narrow to rows whose column equals --value"New value: +"Narrow to rows whose column equals value"

changedInput schema / properties / name / description

Previous value: -"Collection name (alternative to --collectionId)"New value: +"Collection name (alternative to collectionId)"

Changed2 schema fields changedOct 14, 2026

changedInput schema / properties / column / description

Previous value: -"Narrow to rows whose column equals value"New value: +"Narrow to rows whose column equals --value"

changedInput schema / properties / name / description

Previous value: -"Collection name (alternative to collectionId)"New value: +"Collection name (alternative to --collectionId)"

Changed2 schema fields changedOct 14, 2026

changedInput schema / properties / column / description

Previous value: -"Narrow to rows whose column equals --value"New value: +"Narrow to rows whose column equals value"

changedInput schema / properties / name / description

Previous value: -"Collection name (alternative to --collectionId)"New value: +"Collection name (alternative to collectionId)"

Changed21 schema fields changedOct 13, 2026

removedInput schema / properties / --collectionId

Removed value: -{
-  "description": "Collection to list — accepts the collectionId returned by search/recipe outputs OR the collection name. Same arg name as every other collection/email/enrich command. Use this when chaining from a recipe.",
-  "type": "string"
-}

removedInput schema / properties / --column

Removed value: -{
-  "description": "Narrow to rows whose column equals --value",
-  "type": "string"
-}

removedInput schema / properties / --cursor

Removed value: -{
-  "description": "Opaque cursor from the previous response; omit for the first page",
-  "pattern": "^[A-Za-z0-9_-]{76}$",
-  "type": "string"
-}

removedInput schema / properties / --limit

Removed value: -{
-  "description": "Max rows to return per page (default 50, max 500). For full enumeration, pass the previous response cursor.",
-  "type": "integer"
-}

removedInput schema / properties / --name

Removed value: -{
-  "description": "Collection name (alternative to --collectionId)",
-  "type": "string"
-}

removedInput schema / properties / --order

Removed value: -{
-  "description": "Captured row order; defaults to change_seq_asc",
-  "enum": [
-    "change_seq_asc",
-    "stored_fit"
-  ],
-  "type": "string"
-}

removedInput schema / properties / --priority

Removed value: -{
-  "description": "Filter to this priority only",
-  "enum": [
-    "high",
-    "medium",
-    "low"
-  ],
-  "type": "string"
-}

removedInput schema / properties / --profile

Removed value: -{
-  "description": "Unsupported during reads; invoke ranking separately to store fits",
-  "type": "string"
-}

removedInput schema / properties / --value

Removed value: -{
-  "description": "Value that column must equal",
-  "type": "string"
-}

addedInput schema / properties / collectionId

Added value: +{
+  "description": "Collection to list — accepts the collectionId returned by search/recipe outputs OR the collection name. Same arg name as every other collection/email/enrich command. Use this when chaining from a recipe.",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / column

Added value: +{
+  "description": "Narrow to rows whose column equals --value",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / cursor

Added value: +{
+  "description": "Opaque cursor from the previous response; omit for the first page",
+  "maxLength": 76,
+  "pattern": "^[A-Za-z0-9_-]{76}$",
+  "type": "string"
+}

addedInput schema / properties / limit

Added value: +{
+  "description": "Max rows to return per page (default 50, max 500). For full enumeration, pass the previous response cursor.",
+  "maximum": 500,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / name

Added value: +{
+  "description": "Collection name (alternative to --collectionId)",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / order

Added value: +{
+  "description": "Captured row order; defaults to change_seq_asc",
+  "enum": [
+    "change_seq_asc",
+    "stored_fit"
+  ],
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / priority

Added value: +{
+  "description": "Filter to this priority only",
+  "enum": [
+    "high",
+    "medium",
+    "low"
+  ],
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / profile

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 120,
+      "type": "string"
+    },
+    {
+      "type": [
+        "null",
+        "boolean",
+        "number",
+        "string",
+        "array",
+        "object"
+      ]
+    }
+  ],
+  "contentSchema": {
+    "type": [
+      "null",
+      "boolean",
+      "number",
+      "string",
+      "array",
+      "object"
+    ]
+  },
+  "description": "Unsupported during reads; invoke ranking separately to store fits"
+}

addedInput schema / properties / q

Added value: +{
+  "description": "Search recorded company names across the full collection",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / stage

Added value: +{
+  "description": "Saved company stage or unstaged; omit for all stages",
+  "maxLength": 8000,
+  "type": "string"
+}

addedInput schema / properties / value

Added value: +{
+  "description": "Value that column must equal",
+  "maxLength": 8000,
+  "type": "string"
+}

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$defs": {
+    "value0": {
+      "additionalProperties": false,
+      "properties": {
+        "activities": {
+          "$ref": "#/$defs/value5"
+        },
+        "assignee": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "cells": {
+          "$ref": "#/$defs/value7"
+        },
+        "companyId": {
+          "type": "string"
+        },
+        "companyName": {
+          "type": "string"
+        },
+        "contacts": {
+          "$ref": "#/$defs/value1"
+        },
+        "country": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "fit": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/value9"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "itemId": {
+          "type": "string"
+        },
+        "lastActivityAt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "leadVersion": {
+          "type": "string"
+        },
+        "mails": {
+          "$ref": "#/$defs/value8"
+        },
+        "nextAction": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "nextActionDue": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "nextActionOverdue": {
+          "type": "boolean"
+        },
+        "note": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "outreachStage": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "priority": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "roleNote": {
+          "type": "string"
+        },
+        "score": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "url": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "assignee",
+        "cells",
+        "companyId",
+        "companyName",
+        "country",
+        "itemId",
+        "lastActivityAt",
+        "leadVersion",
+        "mails",
+        "nextAction",
+        "nextActionDue",
+        "nextActionOverdue",
+        "note",
+        "outreachStage",
+        "priority",
+        "roleNote",
+        "score",
+        "url",
+        "version"
+      ],
+      "type": "object"
+    },
+    "value1": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value2"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value10": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value11"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value11": {
+      "additionalProperties": false,
+      "properties": {
+        "dimension": {
+          "type": "string"
+        },
+        "matched": {
+          "$ref": "#/$defs/value12"
+        },
+        "missing": {
+          "$ref": "#/$defs/value13"
+        },
+        "score": {
+          "type": "number"
+        },
+        "weight": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "dimension",
+        "score",
+        "weight"
+      ],
+      "type": "object"
+    },
+    "value12": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value13": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value14": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value15": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value16": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value17": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value18": {
+      "additionalProperties": false,
+      "properties": {
+        "collectionId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "collectionId"
+      ],
+      "type": "object"
+    },
+    "value19": {
+      "anyOf": [
+        {
+          "items": {
+            "type": [
+              "null",
+              "boolean",
+              "number",
+              "string",
+              "array",
+              "object"
+            ]
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value2": {
+      "additionalProperties": false,
+      "properties": {
+        "city": {
+          "type": "string"
+        },
+        "country": {
+          "type": "string"
+        },
+        "emails": {
+          "$ref": "#/$defs/value3"
+        },
+        "person": {
+          "type": "string"
+        },
+        "phones": {
+          "$ref": "#/$defs/value4"
+        },
+        "role": {
+          "type": "string"
+        },
+        "sourceRow": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "emails",
+        "person",
+        "phones",
+        "role"
+      ],
+      "type": "object"
+    },
+    "value20": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value21"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value21": {
+      "additionalProperties": false,
+      "properties": {
+        "command": {
+          "type": "string"
+        },
+        "cost": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "rationale": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "command",
+        "cost",
+        "label",
+        "rationale"
+      ],
+      "type": "object"
+    },
+    "value22": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "type": "number"
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value23": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value24"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value24": {
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ],
+      "type": "object"
+    },
+    "value25": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "type": [
+              "null",
+              "boolean",
+              "number",
+              "string",
+              "array",
+              "object"
+            ]
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value3": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value4": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value5": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/value6"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value6": {
+      "additionalProperties": false,
+      "properties": {
+        "actor": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "occurredAt": {
+          "type": "string"
+        },
+        "sourceRow": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "actor",
+        "id",
+        "kind",
+        "occurredAt"
+      ],
+      "type": "object"
+    },
+    "value7": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value8": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "value9": {
+      "additionalProperties": false,
+      "properties": {
+        "candidateCompanyId": {
+          "type": "string"
+        },
+        "candidateCompanyName": {
+          "type": "string"
+        },
+        "candidateWebsite": {
+          "type": "string"
+        },
+        "confidence": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "evidence": {
+          "$ref": "#/$defs/value17"
+        },
+        "fitLabel": {
+          "type": "string"
+        },
+        "idealProfileName": {
+          "type": "string"
+        },
+        "matchedAttributes": {
+          "$ref": "#/$defs/value14"
+        },
+        "missingAttributes": {
+          "$ref": "#/$defs/value15"
+        },
+        "negativeSignals": {
+          "$ref": "#/$defs/value16"
+        },
+        "newRank": {
+          "type": "integer"
+        },
+        "originalRank": {
+          "type": "integer"
+        },
+        "recommendedNextAction": {
+          "type": "string"
+        },
+        "signals": {
+          "$ref": "#/$defs/value10"
+        },
+        "similarityScore": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "candidateCompanyName",
+        "fitLabel",
+        "newRank",
+        "signals",
+        "similarityScore"
+      ],
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "properties": {
+    "_debug": {
+      "$ref": "#/$defs/value25"
+    },
+    "correlationId": {
+      "type": "string"
+    },
+    "data": {
+      "additionalProperties": false,
+      "properties": {
+        "context": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/value18"
+            },
+            {
+              "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/value20"
+    },
+    "stats": {
+      "$ref": "#/$defs/value22"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "warnings": {
+      "$ref": "#/$defs/value23"
+    }
+  },
+  "required": [
+    "data",
+    "nextActions",
+    "summary"
+  ],
+  "type": "object"
+}

First observedOct 9, 2026

TDQS

A3.5/5.0

Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive, closed-world behavior, so the safety profile is covered. The description adds the shape of returned data and the presence of filters/paging, but says nothing about page-size behavior, ordering defaults, or the fact that full enumeration requires carrying a cursor forward — details only found in the schema.

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?

One front-loaded sentence with zero filler; the returned fields come before the filter/paging mention. It stops short of being underspecified, but the terseness is a deliberate trade-off rather than padding.

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

Completeness3/5

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

An output schema exists and the rich input schema documents paging, ordering, and the collectionId/name duality, so much of the burden is carried elsewhere. For an 11-parameter listing endpoint, however, the description gives no orientation on how collectionId vs name, or column vs value, relate, and offers nothing on cursor-based enumeration.

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

Parameters4/5

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

Schema description coverage is 100%, so per-parameter meaning is already documented, and the description's mention of filters and paging is a light topical pointer rather than new detail. Baseline is 3 under full coverage; the field list ('score, priority, country, contacts and outreach stage') corresponds to the priority/stage/column/value filters, giving modest added orientation.

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 company rows in a collection) plus the fields returned (score, priority, country, contacts, outreach stage), which distinguishes it from collection-level siblings like collection__get or collection__list. It does not explicitly differentiate from exim__companies__list, but the collection scoping is clear enough on its own.

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?

Use is only implied by 'with filters and paging'; there is no statement of when to choose this over exim__collection__get, exim__companies__list, or collection__analyze, and no prerequisites or exclusions. An agent can infer it is the row-level reader for a collection, but nothing routes it away from alternatives.

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.

List companies in collection

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources