Tool-Referenz
Alle BrandSuite MCP-Tools, Effekte und Eingabeparameter in einer Referenz.
28 Werkzeuge. Jede Karte dokumentiert ihre Wirkung und ihren Werkzeug-/Listen-Eingabevertrag.
get_current_userReturn the authenticated BrandSuite user, active workspace, granted tool groups and timezone.
Parameter
Keine Eingabeparameter.
get_current_workspaceReturn the workspace bound to this MCP authorization.
Parameter
Keine Eingabeparameter.
list_brandsList every brand the authenticated user can access in the authorized workspace.
Parameter
limitinteger50Maximum brands returned per page.
cursorstringOpaque pagination cursor returned by the previous call.
resolve_brandResolve a brand name to an ID without guessing when multiple brands match.
Parameter
querystringExact or partial brand name. Ambiguous matches return candidates instead of guessing.
get_brand_overviewReturn a compact brand summary and availability of identity, knowledge, documents, assets and guidelines.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
get_brand_identityReturn colors, typography, fonts, voice and safe design tokens from the latest brand kit.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
get_brand_knowledgeReturn positioning, audience, values, tone, competitors and operational brand context.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
list_brand_documentsList authorized project documents with metadata and pagination.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
categorystringOptional document category filter.
limitinteger30Maximum documents returned.
cursorstringOpaque pagination cursor.
read_brand_documentRead a bounded text excerpt from one authorized brand document.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
documentIduuidDocument ID returned by list_brand_documents.
maxCharactersinteger20000Maximum text characters returned; range 500–40,000.
list_brand_assetsList authorized creative assets without exposing prompts, provider data or private storage paths.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
typestringCreative type such as social_post, story, ad or video.
platformstringPlatform such as instagram, facebook or linkedin.
limitinteger30Maximum assets returned.
cursorstringOpaque pagination cursor.
get_brand_guidelinesReturn the current structured brand-guideline document and requested visible pages.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
sectionsstring[][]Optional guideline page types to return; empty returns every visible page.
get_content_calendarAggregate scheduled content across one or all accessible brands for today, tomorrow, this week, seven days or a custom range.
Parameter
rangestringtomorrowPreset date range in the authorized timezone.
{{count}} Tools: today, tomorrow, this_week, next_7_days, custom
brandIdsuuid[][]Brand IDs to include; empty means every accessible brand.
statusesstring[][scheduled]Content statuses to include.
channelsstring[][]Platform/channel filters.
timezoneIANA timezoneTimezone used to calculate calendar boundaries.
fromISO timestampCustom range start; required when range is custom.
toISO timestampCustom range end; required when range is custom.
groupBystringbrandResult grouping.
{{count}} Tools: brand, date, none
list_content_itemsSearch project-scoped content items using brand, status, channel and date filters.
Parameter
brandIdsuuid[][]Brand IDs to include; empty means every accessible brand.
statusesstring[][]Content status filters.
channelsstring[][]Platform/channel filters.
fromISO timestampOptional scheduled-at lower bound.
toISO timestampOptional scheduled-at upper bound.
limitinteger50Maximum items returned.
cursorstringOpaque pagination cursor.
get_content_itemReturn one authorized content item with safe scheduling state.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
itemIduuidContent item ID.
list_conversationsList the user’s persisted BrandSuite AI Studio conversations for the authorized workspace.
Parameter
brandIduuidOptional brand scope.
statusstringConversation status.
{{count}} Tools: active, archived
limitinteger30Maximum conversations returned.
get_conversationReturn a bounded message history for one user-owned BrandSuite conversation.
Parameter
conversationIduuidConversation ID.
limitinteger50Maximum recent messages returned.
start_brand_conversationCreate an explicit, persistent and brand-aware AI Studio conversation.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
titlestringOptional conversation title.
externalThreadIdstringOptional client thread ID; stored only as a hash for idempotent reuse.
continue_brand_conversationPersist a user message, obtain BrandSuite AI guidance and save proposed actions without executing them.
Parameter
conversationIduuidConversation ID.
messagestringUser message, up to 12,000 characters.
requestKeystringStable request key for idempotent message replay.
languagestringitResponse language.
{{count}} Tools: it, en, fr, de, es, pt, ja, zh
prepare_content_generationNormalize a social content request and return a short-lived intent with the exact estimated credit cost.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
conversationIduuidOptional related BrandSuite AI Studio conversation.
contentTypestringsocial_postGeneration scope.
{{count}} Tools: social_post, social_campaign
channelstringTarget social channel.
{{count}} Tools: instagram, facebook, linkedin
briefstringContent brief, 5–8,000 characters.
variantsinteger1Number of draft items, 1–20.
scheduledForISO timestampOptional target scheduling timestamp.
timezoneIANA timezoneTimezone used by the generation plan.
confirm_content_generationConfirm one unexpired intent idempotently and start the canonical BrandSuite generation run.
Parameter
intentIduuidUnexpired intent returned by prepare_content_generation.
idempotencyKeystringStable key that prevents duplicate runs or credit charges.
get_generation_runReturn safe progress and result metadata for an authorized MCP generation run.
Parameter
runIduuidRun ID returned after generation confirmation.
Soziale Analysen
Verbindungen, organische Leistung, Beiträge, Anzeigen und Empfehlungen.
list_social_connectionsList real Meta, Instagram and LinkedIn connections, public account metadata, capabilities, readiness and last sync for one or more brands.
Parameter
brandIdsuuid[][]Brand IDs to inspect; empty means every accessible brand.
providersstring[][]Provider filters.
{{count}} Tools: meta, linkedin
statusstringConnection status filter.
{{count}} Tools: connected, requires_auth, error, not_connected
get_social_overviewAggregate connected providers, followers, post performance and freshness across one or all accessible brands for a bounded date range.
Parameter
brandIdsuuid[][]Brand IDs to aggregate; empty means every accessible brand.
providersstring[][]Provider filters.
{{count}} Tools: meta, linkedin
fromdateStart date in YYYY-MM-DD; default is 30 days ago.
todateEnd date in YYYY-MM-DD; default is today.
get_social_account_analyticsReturn provider-backed account-level follower, reach, impression, engagement, click and spend time series for a brand.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
{{count}} Tools: meta, linkedin
fromdateStart date in YYYY-MM-DD; default is 90 days ago.
todateEnd date in YYYY-MM-DD; default is today.
list_social_post_analyticsRank a brand’s published social content by engagement, impressions, reach, clicks, reactions or date with safe metadata.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
{{count}} Tools: meta, linkedin
fromdateStart date in YYYY-MM-DD; default is 90 days ago.
todateEnd date in YYYY-MM-DD; default is today.
sortBystringengagementMetric used to rank posts.
{{count}} Tools: engagement, impressions, reach, clicks, likes, comments, shares, saves, date
limitinteger20Maximum posts returned; range 1–100.
get_social_post_analyticsReturn one social post, its bounded metric time series, totals, engagement rate, click-through rate and last metric date.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
itemIduuidPublished social campaign item ID.
fromdateStart date in YYYY-MM-DD; default is 365 days ago.
todateEnd date in YYYY-MM-DD; default is today.
get_social_ads_reportReport Meta or LinkedIn campaign, ad set, ad and creative snapshots including spend, CTR, CPC, CPM, conversions and ranking fields.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Advertising provider filters.
{{count}} Tools: meta, linkedin
levelsstring[][]Provider object levels to include.
{{count}} Tools: campaign, adset, ad, creative
fromdateStart date in YYYY-MM-DD; default is 30 days ago.
todateEnd date in YYYY-MM-DD; default is today.
limitinteger50Maximum provider snapshots returned; range 1–200.
list_social_ad_recommendationsList provider-backed BrandSuite advertising recommendations, confidence, evidence, risks and recommended actions without applying them.
Parameter
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
{{count}} Tools: meta, linkedin
statusesstring[][]Recommendation lifecycle filters.
{{count}} Tools: open, accepted, dismissed, draft_action_created
severitiesstring[][]Severity filters.
{{count}} Tools: info, low, medium, high
limitinteger30Maximum recommendations returned; range 1–100.