Skip to main content
Glama

Ballast - Cold Email

Set or clear a thread's label

label_thread

Set or clear a thread's label. The lead gets the label for the thread's campaign and the label's triggers run (suppress, stop in campaign, pause campaign, move to list). null clears it.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYes
labelIdYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations only supply generic hints (readOnlyHint=false, destructiveHint=false), so the description carries most of the burden and does well: it discloses that the lead inherits the label and that the label's triggers fire (suppress, stop in campaign, pause campaign, move to list). That side-effect chain is exactly the consequential behavior an agent needs before mutating state. It stops short of 5 by omitting auth requirements or failure behavior.

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?

Three short sentences, front-loaded with the action and then the consequences, with no filler. The only inefficiency is that sentence one repeats the title word-for-word before adding new information.

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

Completeness4/5

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

For a two-parameter mutation tool with no output schema and only hint-level annotations, the description covers purpose, the null-clear mechanism, and the trigger side effects. The remaining gap is parameter identity for 'id' and any error/permission expectations.

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 0%, so the description must explain both parameters. It does explain labelId well (null clears the label, and the lead receives it), but the 'id' parameter is never disambiguated as thread id versus lead id, and the mention of both 'thread' and 'lead' in one sentence adds confusion. Partial compensation warrants a 3.

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 opening sentence names a specific verb (set/clear) and resource (a thread's label), and the description goes on to explain both modes, including that null performs the clear. It is clear but the lead sentence duplicates the title verbatim and adds no sibling context, so it falls just short of a 5.

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

Usage Guidelines3/5

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

Usage is only implied: the reader learns that passing null clears the label, which is a usable instruction, but there is no explicit when-to-use, when-not-to-use, or named alternative. No sibling tool overlaps this function, so the missing guidance is low-risk but still absent.

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.

Resources