Skip to main content
Glama

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.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "exim__collection__items__list"
  }
}

Input Schema

NameRequiredDescriptionDefault
qNoSearch recorded company names across the full collection
nameNoCollection name (alternative to collectionId)
limitNoMax rows to return per page (default 50, max 500). For full enumeration, pass the previous response cursor.
orderNoCaptured row order; defaults to change_seq_asc
stageNoSaved company stage or unstaged; omit for all stages
valueNoValue that column must equal
columnNoNarrow to rows whose column equals value
cursorNoOpaque cursor from the previous response; omit for the first page
profileNoUnsupported during reads; invoke ranking separately to store fits
priorityNoFilter to this priority only
collectionIdNoCollection 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

NameRequiredDescriptionDefault
dataYes
statsNo
_debugNo
summaryYes
warningsNo
nextActionsYes
correlationIdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed65 schema fields changed
    • changedInput schema / properties / order / enum
      Previous value: -[
      -  "change_seq_asc",
      -  "stored_fit"
      -]New value: +[
      +  "change_seq_asc",
      +  "stored_fit",
      +  "company_asc",
      +  "company_desc",
      +  "stage_asc",
      +  "stage_desc",
      +  "owner_asc",
      +  "owner_desc",
      +  "activity_asc",
      +  "activity_desc",
      +  "next_asc",
      +  "next_desc"
      +]
    • addedOutput schema / $defs / value0 / properties / qualification
      Added value: +{
      +  "anyOf": [
      +    {
      +      "$ref": "#/$defs/value18"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • removedOutput schema / $defs / value18 / properties / change_seq
      Removed value: -{
      -  "type": "integer"
      -}
    • removedOutput schema / $defs / value18 / properties / collectionId
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / $defs / value18 / properties / generation
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / $defs / value18 / properties / has_more
      Removed value: -{
      -  "type": "boolean"
      -}
    • removedOutput schema / $defs / value18 / properties / lockedTotal
      Removed value: -{
      -  "type": "integer"
      -}
    • addedOutput schema / $defs / value18 / properties / matchReasons
      Added value: +{
      +  "$ref": "#/$defs/value19"
      +}
    • removedOutput schema / $defs / value18 / properties / matchedTotal
      Removed value: -{
      -  "type": "integer"
      -}
    • removedOutput schema / $defs / value18 / properties / order
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / $defs / value18 / properties / pendingCompanies
      Removed value: -{
      -  "$ref": "#/$defs/value19"
      -}
    • removedOutput schema / $defs / value18 / properties / pendingCount
      Removed value: -{
      -  "type": "integer"
      -}
    • removedOutput schema / $defs / value18 / properties / pendingTotal
      Removed value: -{
      -  "type": "integer"
      -}
    • addedOutput schema / $defs / value18 / properties / reasoning
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / $defs / value18 / properties / score
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • removedOutput schema / $defs / value18 / properties / totalItems
      Removed value: -{
      -  "type": "integer"
      -}
    • changedOutput schema / $defs / value18 / required
      Previous value: -[
      -  "change_seq",
      -  "collectionId",
      -  "generation",
      -  "has_more",
      -  "matchedTotal",
      -  "order",
      -  "pendingCompanies",
      -  "pendingCount",
      -  "pendingTotal",
      -  "totalItems"
      -]New value: +[
      +  "matchReasons",
      +  "reasoning",
      +  "score"
      +]
    • changedOutput schema / $defs / value19 / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "$ref": "#/$defs/value20"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / $defs / value20 / properties / change_seq
      Added value: +{
      +  "type": "integer"
      +}
    • addedOutput schema / $defs / value20 / properties / collectionId
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / $defs / value20 / properties / displayName
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / $defs / value20 / properties / generation
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / $defs / value20 / properties / has_more
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / $defs / value20 / properties / lockedTotal
      Added value: +{
      +  "type": "integer"
      +}
    • addedOutput schema / $defs / value20 / properties / matchedTotal
      Added value: +{
      +  "type": "integer"
      +}
    • removedOutput schema / $defs / value20 / properties / message
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / $defs / value20 / properties / order
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / $defs / value20 / properties / pendingCompanies
      Added value: +{
      +  "$ref": "#/$defs/value21"
      +}
    • addedOutput schema / $defs / value20 / properties / pendingCount
      Added value: +{
      +  "type": "integer"
      +}
    • removedOutput schema / $defs / value20 / properties / pendingId
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / $defs / value20 / properties / pendingTotal
      Added value: +{
      +  "type": "integer"
      +}
    • removedOutput schema / $defs / value20 / properties / reportingCountry
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / $defs / value20 / properties / status
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / $defs / value20 / properties / totalItems
      Added value: +{
      +  "type": "integer"
      +}
    • changedOutput schema / $defs / value20 / required
      Previous value: -[
      -  "displayName",
      -  "message",
      -  "pendingId",
      -  "reportingCountry",
      -  "status"
      -]New value: +[
      +  "change_seq",
      +  "collectionId",
      +  "generation",
      +  "has_more",
      +  "matchedTotal",
      +  "order",
      +  "pendingCompanies",
      +  "pendingCount",
      +  "pendingTotal",
      +  "totalItems"
      +]
    • changedOutput schema / $defs / value21 / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "type": [
      -        "null",
      -        "boolean",
      -        "number",
      -        "string",
      -        "array",
      -        "object"
      -      ]
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "$ref": "#/$defs/value22"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / $defs / value22 / additionalProperties
      Added value: +false
    • removedOutput schema / $defs / value22 / anyOf
      Removed value: -[
      -  {
      -    "items": {
      -      "$ref": "#/$defs/value23"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / value22 / properties
      Added value: +{
      +  "displayName": {
      +    "type": "string"
      +  },
      +  "message": {
      +    "type": "string"
      +  },
      +  "pendingId": {
      +    "type": "string"
      +  },
      +  "reportingCountry": {
      +    "type": "string"
      +  },
      +  "status": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / $defs / value22 / required
      Added value: +[
      +  "displayName",
      +  "message",
      +  "pendingId",
      +  "reportingCountry",
      +  "status"
      +]
    • addedOutput schema / $defs / value22 / type
      Added value: +"object"
    • removedOutput schema / $defs / value23 / additionalProperties
      Removed value: -false
    • addedOutput schema / $defs / value23 / anyOf
      Added value: +[
      +  {
      +    "items": {
      +      "type": [
      +        "null",
      +        "boolean",
      +        "number",
      +        "string",
      +        "array",
      +        "object"
      +      ]
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / $defs / value23 / properties
      Removed value: -{
      -  "command": {
      -    "type": "string"
      -  },
      -  "cost": {
      -    "type": "string"
      -  },
      -  "label": {
      -    "type": "string"
      -  },
      -  "rationale": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / $defs / value23 / required
      Removed value: -[
      -  "command",
      -  "cost",
      -  "label",
      -  "rationale"
      -]
    • removedOutput schema / $defs / value23 / type
      Removed value: -"object"
    • changedOutput schema / $defs / value24 / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {
      -      "type": "number"
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "$ref": "#/$defs/value25"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / $defs / value25 / additionalProperties
      Added value: +false
    • removedOutput schema / $defs / value25 / anyOf
      Removed value: -[
      -  {
      -    "items": {
      -      "$ref": "#/$defs/value26"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / value25 / properties
      Added value: +{
      +  "command": {
      +    "type": "string"
      +  },
      +  "cost": {
      +    "type": "string"
      +  },
      +  "label": {
      +    "type": "string"
      +  },
      +  "rationale": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / $defs / value25 / required
      Added value: +[
      +  "command",
      +  "cost",
      +  "label",
      +  "rationale"
      +]
    • addedOutput schema / $defs / value25 / type
      Added value: +"object"
    • removedOutput schema / $defs / value26 / additionalProperties
      Removed value: -false
    • addedOutput schema / $defs / value26 / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": {
      +      "type": "number"
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / $defs / value26 / properties
      Removed value: -{
      -  "code": {
      -    "type": "string"
      -  },
      -  "message": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / $defs / value26 / required
      Removed value: -[
      -  "code",
      -  "message"
      -]
    • removedOutput schema / $defs / value26 / type
      Removed value: -"object"
    • changedOutput schema / $defs / value27 / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {
      -      "type": [
      -        "null",
      -        "boolean",
      -        "number",
      -        "string",
      -        "array",
      -        "object"
      -      ]
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "$ref": "#/$defs/value28"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / $defs / value28
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "code": {
      +      "type": "string"
      +    },
      +    "message": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "code",
      +    "message"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / $defs / value29
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": {
      +        "type": [
      +          "null",
      +          "boolean",
      +          "number",
      +          "string",
      +          "array",
      +          "object"
      +        ]
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / _debug / $ref
      Previous value: -"#/$defs/value27"New value: +"#/$defs/value29"
    • changedOutput schema / properties / data / properties / context / anyOf
      Previous value: -[
      -  {
      -    "anyOf": [
      -      {
      -        "$ref": "#/$defs/value18"
      -      },
      -      {
      -        "type": "null"
      -      }
      -    ]
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "referenced": {
      -        "type": "boolean"
      -      },
      -      "rowCount": {
      -        "type": "integer"
      -      },
      -      "url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "referenced",
      -      "rowCount",
      -      "url"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "$ref": "#/$defs/value20"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "referenced": {
      +        "type": "boolean"
      +      },
      +      "rowCount": {
      +        "type": "integer"
      +      },
      +      "url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "referenced",
      +      "rowCount",
      +      "url"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / nextActions / $ref
      Previous value: -"#/$defs/value22"New value: +"#/$defs/value24"
    • changedOutput schema / properties / stats / $ref
      Previous value: -"#/$defs/value24"New value: +"#/$defs/value26"
    • changedOutput schema / properties / warnings / $ref
      Previous value: -"#/$defs/value25"New value: +"#/$defs/value27"
  2. Changed3 schema fields changed
    • addedOutput schema / $defs / value18 / properties / lockedTotal
      Added value: +{
      +  "type": "integer"
      +}
    • changedOutput schema / properties / data / properties / context / anyOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/value18"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "$ref": "#/$defs/value18"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "referenced": {
      +        "type": "boolean"
      +      },
      +      "rowCount": {
      +        "type": "integer"
      +      },
      +      "url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "referenced",
      +      "rowCount",
      +      "url"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / data / properties / items / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "$ref": "#/$defs/value0"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "anyOf": [
      +        {
      +          "$ref": "#/$defs/value0"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "exportUrl": {
      +              "type": "string"
      +            },
      +            "payloadBytes": {
      +              "type": "integer"
      +            },
      +            "rowCount": {
      +              "type": "integer"
      +            },
      +            "token": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "exportUrl",
      +            "payloadBytes",
      +            "rowCount",
      +            "token",
      +            "url"
      +          ],
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. Changed39 schema fields changed
    • 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"
  4. Changed2 schema fields changed
    • 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)"
  5. Changed2 schema fields changed
    • 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)"
  6. Changed2 schema fields changed
    • 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)"
  7. Changed21 schema fields changed
    • 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"
      +}
  8. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare this read-only, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds which fields come back and that filters and paging exist, but says nothing about page size defaults, total counts, ordering defaults, or the trap that the 'profile' parameter is ignored during reads (only the schema flags that).

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 front-loaded sentence with no filler. It is slightly dense, since the list 'score, priority, country, contacts and outreach stage' could be read as either returned fields or filterable fields, which costs a bit of precision.

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

Completeness4/5

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

With 11 fully documented parameters, an output schema, and rich annotations, the description only needs to carry purpose and routing, and it handles purpose well. The remaining gap is routing against the many sibling collection and company tools, which leaves it short of complete.

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 every one of the 11 parameters, including the enum values for order and priority and the cursor format, is already documented in the schema. The description's generic 'filters and paging' adds no meaning beyond that, so the baseline of 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?

The description states a specific verb ('Lists') and resource ('company rows in a collection') and names the returned fields (score, priority, country, contacts, outreach stage). It implicitly distinguishes this from the global exim__companies__list by scoping to a collection, but never names the sibling, so the differentiation is left to inference.

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

Usage Guidelines2/5

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

There is no when-to-use or when-not-to-use guidance and no mention of alternatives, even though the catalog holds obvious siblings such as exim__collection__get, exim__collection__list, and exim__companies__list. The phrase 'with filters and paging' hints at usage but gives the agent nothing to route on.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.