Skip to content

Tool reference

Every BrandSuite MCP tool, effect and input parameter in one reference.

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

Account & workspace

Current user, workspace and available brands.

4 tools
get_current_user
read
read only

Return the authenticated BrandSuite user, active workspace, granted tool groups and timezone.

Parameters

No input parameters.

get_current_workspace
read
read only

Return the workspace bound to this MCP authorization.

Parameters

No input parameters.

list_brands
read
read only

List every brand the authenticated user can access in the authorized workspace.

Parameters

limitinteger
Optional
Default: 50

Maximum brands returned per page.

cursorstring
Optional

Opaque pagination cursor returned by the previous call.

resolve_brand
read
read only

Resolve a brand name to an ID without guessing when multiple brands match.

Parameters

querystring
Required

Exact or partial brand name. Ambiguous matches return candidates instead of guessing.

Brand intelligence

Identity, knowledge, documents, assets and guidelines.

7 tools
get_brand_overview
read
read only

Return a compact brand summary and availability of identity, knowledge, documents, assets and guidelines.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

get_brand_identity
read
read only

Return colors, typography, fonts, voice and safe design tokens from the latest brand kit.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

get_brand_knowledge
read
read only

Return positioning, audience, values, tone, competitors and operational brand context.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

list_brand_documents
read
read only

List authorized project documents with metadata and pagination.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

categorystring
Optional

Optional document category filter.

limitinteger
Optional
Default: 30

Maximum documents returned.

cursorstring
Optional

Opaque pagination cursor.

read_brand_document
read
read only

Read a bounded text excerpt from one authorized brand document.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

documentIduuid
Required

Document ID returned by list_brand_documents.

maxCharactersinteger
Optional
Default: 20000

Maximum text characters returned; range 500–40,000.

list_brand_assets
read
read only

List authorized creative assets without exposing prompts, provider data or private storage paths.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

typestring
Optional

Creative type such as social_post, story, ad or video.

platformstring
Optional

Platform such as instagram, facebook or linkedin.

limitinteger
Optional
Default: 30

Maximum assets returned.

cursorstring
Optional

Opaque pagination cursor.

get_brand_guidelines
read
read only

Return the current structured brand-guideline document and requested visible pages.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

sectionsstring[]
Optional
Default: []

Optional guideline page types to return; empty returns every visible page.

Content

Cross-brand editorial calendar and content items.

3 tools
get_content_calendar
read
read only

Aggregate scheduled content across one or all accessible brands for today, tomorrow, this week, seven days or a custom range.

Parameters

rangestring
Optional
Default: tomorrow

Preset date range in the authorized timezone.

Values: today, tomorrow, this_week, next_7_days, custom

brandIdsuuid[]
Optional
Default: []

Brand IDs to include; empty means every accessible brand.

statusesstring[]
Optional
Default: [scheduled]

Content statuses to include.

channelsstring[]
Optional
Default: []

Platform/channel filters.

timezoneIANA timezone
Optional

Timezone used to calculate calendar boundaries.

fromISO timestamp
Optional

Custom range start; required when range is custom.

toISO timestamp
Optional

Custom range end; required when range is custom.

groupBystring
Optional
Default: brand

Result grouping.

Values: brand, date, none

list_content_items
read
read only

Search project-scoped content items using brand, status, channel and date filters.

Parameters

brandIdsuuid[]
Optional
Default: []

Brand IDs to include; empty means every accessible brand.

statusesstring[]
Optional
Default: []

Content status filters.

channelsstring[]
Optional
Default: []

Platform/channel filters.

fromISO timestamp
Optional

Optional scheduled-at lower bound.

toISO timestamp
Optional

Optional scheduled-at upper bound.

limitinteger
Optional
Default: 50

Maximum items returned.

cursorstring
Optional

Opaque pagination cursor.

get_content_item
read
read only

Return one authorized content item with safe scheduling state.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

itemIduuid
Required

Content item ID.

Social analytics

Connections, organic performance, posts, ads and recommendations.

7 tools
list_social_connections
read
read only

List real Meta, Instagram and LinkedIn connections, public account metadata, capabilities, readiness and last sync for one or more brands.

Parameters

brandIdsuuid[]
Optional
Default: []

Brand IDs to inspect; empty means every accessible brand.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

statusstring
Optional

Connection status filter.

Values: connected, requires_auth, error, not_connected

get_social_overview
read
read only

Aggregate connected providers, followers, post performance and freshness across one or all accessible brands for a bounded date range.

Parameters

brandIdsuuid[]
Optional
Default: []

Brand IDs to aggregate; empty means every accessible brand.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

fromdate
Optional

Start date in YYYY-MM-DD; default is 30 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.

get_social_account_analytics
read
read only

Return provider-backed account-level follower, reach, impression, engagement, click and spend time series for a brand.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

fromdate
Optional

Start date in YYYY-MM-DD; default is 90 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.

list_social_post_analytics
read
read only

Rank a brand’s published social content by engagement, impressions, reach, clicks, reactions or date with safe metadata.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

fromdate
Optional

Start date in YYYY-MM-DD; default is 90 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.

sortBystring
Optional
Default: engagement

Metric used to rank posts.

Values: engagement, impressions, reach, clicks, likes, comments, shares, saves, date

limitinteger
Optional
Default: 20

Maximum posts returned; range 1–100.

get_social_post_analytics
read
read only

Return one social post, its bounded metric time series, totals, engagement rate, click-through rate and last metric date.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

itemIduuid
Required

Published social campaign item ID.

fromdate
Optional

Start date in YYYY-MM-DD; default is 365 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.

get_social_ads_report
read
read only

Report Meta or LinkedIn campaign, ad set, ad and creative snapshots including spend, CTR, CPC, CPM, conversions and ranking fields.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

providersstring[]
Optional
Default: []

Advertising provider filters.

Values: meta, linkedin

levelsstring[]
Optional
Default: []

Provider object levels to include.

Values: campaign, adset, ad, creative

fromdate
Optional

Start date in YYYY-MM-DD; default is 30 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.

limitinteger
Optional
Default: 50

Maximum provider snapshots returned; range 1–200.

list_social_ad_recommendations
read
read only

List provider-backed BrandSuite advertising recommendations, confidence, evidence, risks and recommended actions without applying them.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

statusesstring[]
Optional
Default: []

Recommendation lifecycle filters.

Values: open, accepted, dismissed, draft_action_created

severitiesstring[]
Optional
Default: []

Severity filters.

Values: info, low, medium, high

limitinteger
Optional
Default: 30

Maximum recommendations returned; range 1–100.

Conversations

Persistent BrandSuite AI Studio threads.

4 tools
list_conversations
conversation
read only

List the user’s persisted BrandSuite AI Studio conversations for the authorized workspace.

Parameters

brandIduuid
Optional

Optional brand scope.

statusstring
Optional

Conversation status.

Values: active, archived

limitinteger
Optional
Default: 30

Maximum conversations returned.

get_conversation
conversation
read only

Return a bounded message history for one user-owned BrandSuite conversation.

Parameters

conversationIduuid
Required

Conversation ID.

limitinteger
Optional
Default: 50

Maximum recent messages returned.

start_brand_conversation
conversation
local write

Create an explicit, persistent and brand-aware AI Studio conversation.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

titlestring
Optional

Optional conversation title.

externalThreadIdstring
Optional

Optional client thread ID; stored only as a hash for idempotent reuse.

continue_brand_conversation
conversation
local write

Persist a user message, obtain BrandSuite AI guidance and save proposed actions without executing them.

Parameters

conversationIduuid
Required

Conversation ID.

messagestring
Required

User message, up to 12,000 characters.

requestKeystring
Optional

Stable request key for idempotent message replay.

languagestring
Optional
Default: it

Response language.

Values: it, en, fr, de, es, pt, ja, zh

Generation

Prepare, confirm and monitor draft content generation.

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.