ツール リファレンス
すべての BrandSuite MCP ツール、効果、および入力パラメータを 1 つのリファレンスにまとめました。
28 個のツール。各カードには、その効果とツール/リスト入力コントラクトが記載されています。
get_current_userReturn the authenticated BrandSuite user, active workspace, granted tool groups and timezone.
パラメータ
入力パラメータなし。
get_current_workspaceReturn the workspace bound to this MCP authorization.
パラメータ
入力パラメータなし。
list_brandsList every brand the authenticated user can access in the authorized workspace.
パラメータ
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.
パラメータ
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.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
get_brand_identityReturn colors, typography, fonts, voice and safe design tokens from the latest brand kit.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
get_brand_knowledgeReturn positioning, audience, values, tone, competitors and operational brand context.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
list_brand_documentsList authorized project documents with metadata and pagination.
パラメータ
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.
パラメータ
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.
パラメータ
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.
パラメータ
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.
パラメータ
rangestringtomorrowPreset date range in the authorized timezone.
値: 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.
値: brand, date, none
list_content_itemsSearch project-scoped content items using brand, status, channel and date filters.
パラメータ
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.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
itemIduuidContent item ID.
list_conversationsList the user’s persisted BrandSuite AI Studio conversations for the authorized workspace.
パラメータ
brandIduuidOptional brand scope.
statusstringConversation status.
値: active, archived
limitinteger30Maximum conversations returned.
get_conversationReturn a bounded message history for one user-owned BrandSuite conversation.
パラメータ
conversationIduuidConversation ID.
limitinteger50Maximum recent messages returned.
start_brand_conversationCreate an explicit, persistent and brand-aware AI Studio conversation.
パラメータ
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.
パラメータ
conversationIduuidConversation ID.
messagestringUser message, up to 12,000 characters.
requestKeystringStable request key for idempotent message replay.
languagestringitResponse language.
値: 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.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
conversationIduuidOptional related BrandSuite AI Studio conversation.
contentTypestringsocial_postGeneration scope.
値: social_post, social_campaign
channelstringTarget social channel.
値: 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.
パラメータ
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.
パラメータ
runIduuidRun ID returned after generation confirmation.
ソーシャル分析
つながり、オーガニック パフォーマンス、投稿、広告、おすすめ。
list_social_connectionsList real Meta, Instagram and LinkedIn connections, public account metadata, capabilities, readiness and last sync for one or more brands.
パラメータ
brandIdsuuid[][]Brand IDs to inspect; empty means every accessible brand.
providersstring[][]Provider filters.
値: meta, linkedin
statusstringConnection status filter.
値: 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.
パラメータ
brandIdsuuid[][]Brand IDs to aggregate; empty means every accessible brand.
providersstring[][]Provider filters.
値: 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.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
値: 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.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
値: 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.
値: 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.
パラメータ
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.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Advertising provider filters.
値: meta, linkedin
levelsstring[][]Provider object levels to include.
値: 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.
パラメータ
brandIduuidAuthorized BrandSuite brand ID.
providersstring[][]Provider filters.
値: meta, linkedin
statusesstring[][]Recommendation lifecycle filters.
値: open, accepted, dismissed, draft_action_created
severitiesstring[][]Severity filters.
値: info, low, medium, high
limitinteger30Maximum recommendations returned; range 1–100.