Skip to main content
Glama

Create a collection

exim__collection__create

Creates an empty collection (a company list) for manual prospecting, optionally with a default email template. For automated discovery use search run.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

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

Input Schema

NameRequiredDescriptionDefault
iconNoChoose the closest supported icon for the product or purpose when creating a collection. Use the conversation context without asking the user; use auto if no icon fits. Existing collections keep their icon.
nameYesCollection name or id Shorten the name to 120 characters or fewer, then retry.
descriptionNoFree-text purpose
businessTypeNoTrade direction: 'export' (user sells) or 'import' (user buys). Default 'export'.
templateNameNoDefault outreach template name (must exist — discover via `template list`)

Output Schema

NameRequiredDescriptionDefault
dataYes
statsNo
_debugNo
summaryYes
warningsNo
nextActionsYes
correlationIdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / icon
      Added value: +{
      +  "description": "Choose the closest supported icon for the product or purpose when creating a collection. Use the conversation context without asking the user; use auto if no icon fits. Existing collections keep their icon.",
      +  "enum": [
      +    "auto",
      +    "folder",
      +    "coffee",
      +    "tea",
      +    "food",
      +    "fruit",
      +    "grains",
      +    "seafood",
      +    "wine",
      +    "packaging",
      +    "furniture",
      +    "apparel",
      +    "beauty",
      +    "health",
      +    "electronics",
      +    "automotive",
      +    "machinery",
      +    "construction",
      +    "agriculture",
      +    "chemicals",
      +    "energy",
      +    "shipping",
      +    "logistics",
      +    "trade-show",
      +    "research",
      +    "shortlist"
      +  ],
      +  "maxLength": 8000,
      +  "type": "string"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / name / pattern
      Previous value: -"[^\\t\\n\\v\\f\\r\\x85\\p{Z}]"New value: +"[^\\t\\n\\v\\f\\r\\x85    - 

   ]"
  3. Changed1 schema field changed
    • changedInput schema / properties / name / description
      Previous value: -"Collection name or id"New value: +"Collection name or id Shorten the name to 120 characters or fewer, then retry."
  4. Changed3 schema fields changed
    • addedOutput schema / properties / data / properties / context / anyOf
      Added value: +[
      +  {
      +    "type": [
      +      "null",
      +      "boolean",
      +      "number",
      +      "string",
      +      "array",
      +      "object"
      +    ]
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "referenced": {
      +        "type": "boolean"
      +      },
      +      "rowCount": {
      +        "type": "integer"
      +      },
      +      "url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "referenced",
      +      "rowCount",
      +      "url"
      +    ],
      +    "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"
      +        },
      +        {
      +          "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"
      +  }
      +]
  5. Changed10 schema fields changed
    • removedInput schema / properties / --businessType
      Removed value: -{
      -  "description": "Trade direction: 'export' (user sells) or 'import' (user buys). Default 'export'.",
      -  "enum": [
      -    "export",
      -    "import"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / --description
      Removed value: -{
      -  "description": "Free-text purpose",
      -  "type": "string"
      -}
    • removedInput schema / properties / --name
      Removed value: -{
      -  "description": "Collection name or id",
      -  "pattern": "[^\\t\\n\\v\\f\\r\\x85\\p{Z}]",
      -  "type": "string"
      -}
    • removedInput schema / properties / --templateName
      Removed value: -{
      -  "description": "Default outreach template name (must exist — discover via `template list`)",
      -  "type": "string"
      -}
    • addedInput schema / properties / businessType
      Added value: +{
      +  "description": "Trade direction: 'export' (user sells) or 'import' (user buys). Default 'export'.",
      +  "enum": [
      +    "export",
      +    "import"
      +  ],
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • addedInput schema / properties / description
      Added value: +{
      +  "description": "Free-text purpose",
      +  "maxLength": 100000,
      +  "type": "string"
      +}
    • addedInput schema / properties / name
      Added value: +{
      +  "description": "Collection name or id",
      +  "maxLength": 120,
      +  "pattern": "[^\\t\\n\\v\\f\\r\\x85\\p{Z}]",
      +  "type": "string"
      +}
    • addedInput schema / properties / templateName
      Added value: +{
      +  "description": "Default outreach template name (must exist — discover via `template list`)",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "--name"
      -]New value: +[
      +  "name"
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "value0": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "id": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "name"
      +      ],
      +      "type": "object"
      +    },
      +    "value1": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "type": [
      +              "null",
      +              "boolean",
      +              "number",
      +              "string",
      +              "array",
      +              "object"
      +            ]
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value2": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "$ref": "#/$defs/value3"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value3": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "command": {
      +          "type": "string"
      +        },
      +        "cost": {
      +          "type": "string"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "rationale": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "command",
      +        "cost",
      +        "label",
      +        "rationale"
      +      ],
      +      "type": "object"
      +    },
      +    "value4": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {
      +            "type": "number"
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value5": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "$ref": "#/$defs/value6"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value6": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "code": {
      +          "type": "string"
      +        },
      +        "message": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "code",
      +        "message"
      +      ],
      +      "type": "object"
      +    },
      +    "value7": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {
      +            "type": [
      +              "null",
      +              "boolean",
      +              "number",
      +              "string",
      +              "array",
      +              "object"
      +            ]
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "additionalProperties": false,
      +  "properties": {
      +    "_debug": {
      +      "$ref": "#/$defs/value7"
      +    },
      +    "correlationId": {
      +      "type": "string"
      +    },
      +    "data": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "context": {
      +          "type": [
      +            "null",
      +            "boolean",
      +            "number",
      +            "string",
      +            "array",
      +            "object"
      +          ]
      +        },
      +        "cursor": {
      +          "type": "string"
      +        },
      +        "has_more": {
      +          "type": "boolean"
      +        },
      +        "items": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "$ref": "#/$defs/value0"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "context",
      +        "has_more",
      +        "items"
      +      ],
      +      "type": "object"
      +    },
      +    "nextActions": {
      +      "$ref": "#/$defs/value2"
      +    },
      +    "stats": {
      +      "$ref": "#/$defs/value4"
      +    },
      +    "summary": {
      +      "type": "string"
      +    },
      +    "warnings": {
      +      "$ref": "#/$defs/value5"
      +    }
      +  },
      +  "required": [
      +    "data",
      +    "nextActions",
      +    "summary"
      +  ],
      +  "type": "object"
      +}
  6. First observed

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnly=false, destructive=false and idempotent=false, so the safety profile is covered. The description usefully adds that the resulting collection is empty and that the template is optional, but it says nothing about duplicate names, permissions, or limits — a modest addition over the structured fields.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences with the core action front-loaded and the routing hint second — nothing is padded. The only minor cost is that the trailing pointer uses an underspecified name ("search run") that spends words without fully resolving the reference.

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 an output schema present, return values need no explanation, and annotations cover the mutation profile. For a five-parameter creation tool with 100% schema coverage, the description is nearly complete, missing only prerequisites such as template existence and duplicate-name handling.

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 the schema already explains name patterns, icon auto-selection, businessType defaults and templateName discovery. The description only echoes the optional template idea without adding syntax, constraints, or edge-case behavior beyond what the schema provides, making the baseline 3 appropriate.

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 ("Creates an empty collection") and parenthetically defines the domain object as "a company list," which an agent could not infer from the name alone. It also contrasts with automated discovery, though the alternative is named as "search run" rather than a clearly identifiable sibling tool, so routing is only partly unambiguous.

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

Usage Guidelines4/5

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

Gives a positive context ("for manual prospecting") and an explicit exclusion ("For automated discovery use search run"), which is more than most definitions offer. The gap is that the named alternative is fuzzy and no prerequisite, such as needing a template to already exist, is stated here.

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.