Passer au contenu

Référence de l'outil

Chaque outil, effet et paramètre de saisie BrandSuite MCP dans une seule référence.

28 outils. Chaque carte documente son effet et son contrat d'entrée d'outils/liste.

Compte et espace de travail

Utilisateur actuel, espace de travail et marques disponibles.

4 outils
get_current_user
read
lecture seule

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

Paramètres

Aucun paramètre d'entrée.

get_current_workspace
read
lecture seule

Return the workspace bound to this MCP authorization.

Paramètres

Aucun paramètre d'entrée.

list_brands
read
lecture seule

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

Paramètres

limitinteger
Facultatif
Par défaut: 50

Maximum brands returned per page.

cursorstring
Facultatif

Opaque pagination cursor returned by the previous call.

resolve_brand
read
lecture seule

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

Paramètres

querystring
Obligatoire

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

Intelligence de marque

Identité, connaissances, documents, actifs et directives.

7 outils
get_brand_overview
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

get_brand_identity
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

get_brand_knowledge
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

list_brand_documents
read
lecture seule

List authorized project documents with metadata and pagination.

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

categorystring
Facultatif

Optional document category filter.

limitinteger
Facultatif
Par défaut: 30

Maximum documents returned.

cursorstring
Facultatif

Opaque pagination cursor.

read_brand_document
read
lecture seule

Read a bounded text excerpt from one authorized brand document.

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

documentIduuid
Obligatoire

Document ID returned by list_brand_documents.

maxCharactersinteger
Facultatif
Par défaut: 20000

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

list_brand_assets
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

typestring
Facultatif

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

platformstring
Facultatif

Platform such as instagram, facebook or linkedin.

limitinteger
Facultatif
Par défaut: 30

Maximum assets returned.

cursorstring
Facultatif

Opaque pagination cursor.

get_brand_guidelines
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

sectionsstring[]
Facultatif
Par défaut: []

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

Contenu

Calendrier éditorial et éléments de contenu multimarques.

3 outils
get_content_calendar
read
lecture seule

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

Paramètres

rangestring
Facultatif
Par défaut: tomorrow

Preset date range in the authorized timezone.

Valeurs: today, tomorrow, this_week, next_7_days, custom

brandIdsuuid[]
Facultatif
Par défaut: []

Brand IDs to include; empty means every accessible brand.

statusesstring[]
Facultatif
Par défaut: [scheduled]

Content statuses to include.

channelsstring[]
Facultatif
Par défaut: []

Platform/channel filters.

timezoneIANA timezone
Facultatif

Timezone used to calculate calendar boundaries.

fromISO timestamp
Facultatif

Custom range start; required when range is custom.

toISO timestamp
Facultatif

Custom range end; required when range is custom.

groupBystring
Facultatif
Par défaut: brand

Result grouping.

Valeurs: brand, date, none

list_content_items
read
lecture seule

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

Paramètres

brandIdsuuid[]
Facultatif
Par défaut: []

Brand IDs to include; empty means every accessible brand.

statusesstring[]
Facultatif
Par défaut: []

Content status filters.

channelsstring[]
Facultatif
Par défaut: []

Platform/channel filters.

fromISO timestamp
Facultatif

Optional scheduled-at lower bound.

toISO timestamp
Facultatif

Optional scheduled-at upper bound.

limitinteger
Facultatif
Par défaut: 50

Maximum items returned.

cursorstring
Facultatif

Opaque pagination cursor.

get_content_item
read
lecture seule

Return one authorized content item with safe scheduling state.

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

itemIduuid
Obligatoire

Content item ID.

Analyses sociales

Connexions, performances organiques, publications, annonces et recommandations.

7 outils
list_social_connections
read
lecture seule

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

Paramètres

brandIdsuuid[]
Facultatif
Par défaut: []

Brand IDs to inspect; empty means every accessible brand.

providersstring[]
Facultatif
Par défaut: []

Provider filters.

Valeurs: meta, linkedin

statusstring
Facultatif

Connection status filter.

Valeurs: connected, requires_auth, error, not_connected

get_social_overview
read
lecture seule

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

Paramètres

brandIdsuuid[]
Facultatif
Par défaut: []

Brand IDs to aggregate; empty means every accessible brand.

providersstring[]
Facultatif
Par défaut: []

Provider filters.

Valeurs: meta, linkedin

fromdate
Facultatif

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

todate
Facultatif

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

get_social_account_analytics
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

providersstring[]
Facultatif
Par défaut: []

Provider filters.

Valeurs: meta, linkedin

fromdate
Facultatif

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

todate
Facultatif

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

list_social_post_analytics
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

providersstring[]
Facultatif
Par défaut: []

Provider filters.

Valeurs: meta, linkedin

fromdate
Facultatif

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

todate
Facultatif

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

sortBystring
Facultatif
Par défaut: engagement

Metric used to rank posts.

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

limitinteger
Facultatif
Par défaut: 20

Maximum posts returned; range 1–100.

get_social_post_analytics
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

itemIduuid
Obligatoire

Published social campaign item ID.

fromdate
Facultatif

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

todate
Facultatif

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

get_social_ads_report
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

providersstring[]
Facultatif
Par défaut: []

Advertising provider filters.

Valeurs: meta, linkedin

levelsstring[]
Facultatif
Par défaut: []

Provider object levels to include.

Valeurs: campaign, adset, ad, creative

fromdate
Facultatif

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

todate
Facultatif

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

limitinteger
Facultatif
Par défaut: 50

Maximum provider snapshots returned; range 1–200.

list_social_ad_recommendations
read
lecture seule

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

providersstring[]
Facultatif
Par défaut: []

Provider filters.

Valeurs: meta, linkedin

statusesstring[]
Facultatif
Par défaut: []

Recommendation lifecycle filters.

Valeurs: open, accepted, dismissed, draft_action_created

severitiesstring[]
Facultatif
Par défaut: []

Severity filters.

Valeurs: info, low, medium, high

limitinteger
Facultatif
Par défaut: 30

Maximum recommendations returned; range 1–100.

Conversations

Fils de discussion BrandSuite AI Studio persistants.

4 outils
list_conversations
conversation
lecture seule

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

Paramètres

brandIduuid
Facultatif

Optional brand scope.

statusstring
Facultatif

Conversation status.

Valeurs: active, archived

limitinteger
Facultatif
Par défaut: 30

Maximum conversations returned.

get_conversation
conversation
lecture seule

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

Paramètres

conversationIduuid
Obligatoire

Conversation ID.

limitinteger
Facultatif
Par défaut: 50

Maximum recent messages returned.

start_brand_conversation
conversation
écriture locale

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

titlestring
Facultatif

Optional conversation title.

externalThreadIdstring
Facultatif

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

continue_brand_conversation
conversation
écriture locale

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

Paramètres

conversationIduuid
Obligatoire

Conversation ID.

messagestring
Obligatoire

User message, up to 12,000 characters.

requestKeystring
Facultatif

Stable request key for idempotent message replay.

languagestring
Facultatif
Par défaut: it

Response language.

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

Génération

Préparer, confirmer et surveiller les brouillons de contenu génération.

3 outils
prepare_content_generation
generation
écriture locale

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

Paramètres

brandIduuid
Obligatoire

Authorized BrandSuite brand ID.

conversationIduuid
Facultatif

Optional related BrandSuite AI Studio conversation.

contentTypestring
Facultatif
Par défaut: social_post

Generation scope.

Valeurs: social_post, social_campaign

channelstring
Obligatoire

Target social channel.

Valeurs: instagram, facebook, linkedin

briefstring
Obligatoire

Content brief, 5–8,000 characters.

variantsinteger
Facultatif
Par défaut: 1

Number of draft items, 1–20.

scheduledForISO timestamp
Facultatif

Optional target scheduling timestamp.

timezoneIANA timezone
Facultatif

Timezone used by the generation plan.

confirm_content_generation
generation
écriture facturable

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

Paramètres

intentIduuid
Obligatoire

Unexpired intent returned by prepare_content_generation.

idempotencyKeystring
Obligatoire

Stable key that prevents duplicate runs or credit charges.

get_generation_run
generation
lecture seule

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

Paramètres

runIduuid
Obligatoire

Run ID returned after generation confirmation.