Referencia de herramientas
Cada herramienta BrandSuite MCP, efecto y parámetro de entrada en una sola referencia.
28 herramientas. Cada tarjeta documenta su efecto y herramientas/lista de contrato de entrada.
get_current_userReturn the authenticated BrandSuite user, active workspace, granted tool groups and timezone.
Parámetros
Sin parámetros de entrada.
get_current_workspaceReturn the workspace bound to this MCP authorization.
Parámetros
Sin parámetros de entrada.
list_brandsList every brand the authenticated user can access in the authorized workspace.
Parámetros
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.
Parámetros
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.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
get_brand_identityReturn colors, typography, fonts, voice and safe design tokens from the latest brand kit.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
get_brand_knowledgeReturn positioning, audience, values, tone, competitors and operational brand context.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
list_brand_documentsList authorized project documents with metadata and pagination.
Parámetros
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.
Parámetros
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.
Parámetros
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.
Parámetros
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.
Parámetros
rangestringtomorrowPreset date range in the authorized timezone.
Valores: 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.
Valores: brand, date, none
list_content_itemsSearch project-scoped content items using brand, status, channel and date filters.
Parámetros
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.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
itemIduuidContent item ID.
list_conversationsList the user’s persisted BrandSuite AI Studio conversations for the authorized workspace.
Parámetros
brandIduuidOptional brand scope.
statusstringConversation status.
Valores: active, archived
limitinteger30Maximum conversations returned.
get_conversationReturn a bounded message history for one user-owned BrandSuite conversation.
Parámetros
conversationIduuidConversation ID.
limitinteger50Maximum recent messages returned.
start_brand_conversationCreate an explicit, persistent and brand-aware AI Studio conversation.
Parámetros
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.
Parámetros
conversationIduuidConversation ID.
messagestringUser message, up to 12,000 characters.
requestKeystringStable request key for idempotent message replay.
languagestringitResponse language.
Valores: 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.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
conversationIduuidOptional related BrandSuite AI Studio conversation.
contentTypestringsocial_postGeneration scope.
Valores: social_post, social_campaign
channelstringTarget social channel.
Valores: 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.
Parámetros
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.
Parámetros
runIduuidRun ID returned after generation confirmation.
Análisis social
Conexiones, rendimiento orgánico, publicaciones, anuncios y recomendaciones.
list_social_connectionsList real Meta, Instagram and LinkedIn connections, public account metadata, capabilities, readiness and last sync for one or more brands.
Parámetros
brandIdsuuid[][]Brand IDs to inspect; empty means every accessible brand.
providersstring[][]Provider filters.
Valores: meta, linkedin
statusstringConnection status filter.
Valores: 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.
Parámetros
brandIdsuuid[][]Brand IDs to aggregate; empty means every accessible brand.
providersstring[][]Provider filters.
Valores: 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.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
Valores: 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.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
Valores: 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.
Valores: 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.
Parámetros
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.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Advertising provider filters.
Valores: meta, linkedin
levelsstring[][]Provider object levels to include.
Valores: 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.
Parámetros
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
Valores: meta, linkedin
statusesstring[][]Recommendation lifecycle filters.
Valores: open, accepted, dismissed, draft_action_created
severitiesstring[][]Severity filters.
Valores: info, low, medium, high
limitinteger30Maximum recommendations returned; range 1–100.