Skip to main content
Glama

Pause or resume a campaign

campaign_set_status
Idempotent

Pause a running campaign, or resume one that is paused. PAUSED halts sending immediately; pending steps stay queued and pick up where they left off when it resumes. ACTIVE starts real outreach again, so ASK THE USER before resuming — the campaign may have been paused for a reason they know and you do not. Nothing is destroyed either way, so your client will not prompt for you: the confirmation has to be one you asked for. Pausing needs no ceremony — it only stops sending, and is undone by resuming. Deliberately narrower than the status field it writes. It will not ARCHIVE or COMPLETE a campaign — those are web-app housekeeping — and it will not DELETE one, which is campaign_delete. It also refuses to resume anything that is not already PAUSED: updateCampaign writes the field blindly, so setting ACTIVE on a DRAFTED campaign would mark it live without a lead source, a saved flow, a sending account or materialised sequences, none of which this path checks. A campaign that has never run is started with campaign_launch, which validates all of that first.

Input Schema

NameRequiredDescriptionDefault
statusYesPAUSED halts sending. ACTIVE resumes a paused campaign, and is refused for any other current status.
campaignIdYesCampaign id, from `campaign_list` or `campaign_create`.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.8/5.0
Behavior5/5

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

Annotations already declare destructiveHint=false and idempotentHint=true, but the description adds the operationally critical fact that the client will not prompt for confirmation — the agent must solicit it itself — plus that pending steps stay queued and resume in place. It also discloses the refusal behavior for non-PAUSED campaigns and the failure mode of the blind `updateCampaign` path.

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?

Purpose is front-loaded in sentence one and every sentence carries operational weight. Slightly dense and clause-heavy in the middle, but no sentence is filler.

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

Completeness5/5

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

Two required params, full schema coverage, no output schema needed, and annotations covering the safety profile — the description closes the remaining gaps (confirmation ownership, queue behavior, refusal conditions, sibling routing) with nothing material missing.

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 coverage is 100% and the enum is documented, so the baseline is 3. The description earns an extra point by explaining *why* ACTIVE is refused for non-PAUSED states (a DRAFTED campaign would be marked live without a lead source, flow, sending account, or sequences), which is rationale the schema does not carry.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb pair and resource (pause/resume a campaign) and immediately delimits itself against siblings: `campaign_launch`, `campaign_delete`, and raw `updateCampaign`. An agent can distinguish this from every adjacent campaign tool without opening a schema.

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

Usage Guidelines5/5

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

Gives explicit when-to-use (pausing needs no ceremony), when-not (won't ARCHIVE, COMPLETE, DELETE, or start a never-run campaign — use `campaign_launch`), and a hard gating rule: ask the user before resuming because the pause reason may be unknown to the agent.

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