Skip to content

Content generation

Prepare, confirm and monitor credit-based content generation safely and idempotently.

3 tools. Each card documents its effect and tools/list input contract.

Content generation

Prepare, confirm and monitor credit-based content generation safely and idempotently.

3 tools
prepare_content_generation
generation
local write

Normalize a social content request and return a short-lived intent with the exact estimated credit cost.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

conversationIduuid
Optional

Optional related BrandSuite AI Studio conversation.

contentTypestring
Optional
Default: social_post

Generation scope.

Values: social_post, social_campaign

channelstring
Required

Target social channel.

Values: instagram, facebook, linkedin

briefstring
Required

Content brief, 5–8,000 characters.

variantsinteger
Optional
Default: 1

Number of draft items, 1–20.

scheduledForISO timestamp
Optional

Optional target scheduling timestamp.

timezoneIANA timezone
Optional

Timezone used by the generation plan.

confirm_content_generation
generation
billable write

Confirm one unexpired intent idempotently and start the canonical BrandSuite generation run.

Parameters

intentIduuid
Required

Unexpired intent returned by prepare_content_generation.

idempotencyKeystring
Required

Stable key that prevents duplicate runs or credit charges.

get_generation_run
generation
read only

Return safe progress and result metadata for an authorized MCP generation run.

Parameters

runIduuid
Required

Run ID returned after generation confirmation.

Explicit confirmation

prepare_content_generation never spends credits. Only confirm_content_generation can create a run, using an unexpired intent and idempotency key.