Skip to main content
Glama

Build a campaign step by step

build_campaign

Build a Meta campaign together with the person, two related questions at a time, shown in the chat as a form with buttons: goal and budget, page and conversion, creative and texts, audience and name — and first the ad account when several are connected. Call it when the person wants to build a campaign step by step or is unsure what to fill in. Nothing is created in the ad account and nothing counts toward the monthly change limit: the answers are kept under draft_id. When everything is answered, create_campaign with that draft_id returns the full preview and confirm_token.

Input Schema

NameRequiredDescriptionDefault
clearNoFields to remove from the draft, e.g. ["end_time"].
deferNoSet by the form itself: questions the person left to the assistant for the end. Leave it out.
answersNoFields of create_campaign the person chose: the "answer" of the picked options, or what they wrote, mapped to fields.
draft_idNoThe draft to continue, from an earlier answer. Omit to start a new one.
languageNoLanguage of the conversation, e.g. "ru", "uk", "pl" or "en": the form shows its questions and buttons in it. Always pass it; without it the form falls back to the language of the chat interface.
connectionNoAd account: connection id or ad account number — the answer of the ad account question.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.4/5.0
Behavior5/5

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

Despite annotations marking this as non-read-only and open-world, the description clarifies that nothing is created in the ad account and nothing counts toward the change limit, with answers held under draft_id. This is precisely the extra context an agent needs to trust invoking a write-flagged tool.

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?

The description is a single dense paragraph but front-loads the core action and each sentence carries information (form fields, trigger condition, side-effect safety, finalization path). Some sentences run long, slightly hurting readability.

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?

For a 6-parameter, no-output-schema tool, the description covers what the tool does, when to invoke it, its side-effect profile, and how the workflow concludes via create_campaign with the draft_id. Nothing essential to correct invocation is missing.

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 parameter is already documented in the schema. The description reinforces the draft_id lifecycle but adds little param-level syntax or format detail beyond what the schema provides, so the baseline 3 applies.

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?

The description states a specific verb and resource (building a Meta campaign) and makes clear this is an interactive, form-driven builder rather than a direct creator. It distinguishes itself from the sibling create_campaign by positioning that tool as the finalizing step.

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?

"Call it when the person wants to build a campaign step by step or is unsure what to fill in" gives explicit when-to-use context. It implies the alternative (direct creation) via the create_campaign handoff, though it never states an explicit when-not-to-use condition.

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.