跳至内容

工具参考

一份参考中包含所有 BrandSuite MCP 工具、效果和输入参数。

28 个工具。每张卡片都记录了其效果和工具/列表输入合同。

帐户和工作区

当前用户、工作区和可用品牌。

4工具
get_current_user
read
只读

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

参数

无输入参数。

get_current_workspace
read
只读

Return the workspace bound to this MCP authorization.

参数

无输入参数。

list_brands
read
只读

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

参数

limitinteger
可选
默认: 50

Maximum brands returned per page.

cursorstring
可选

Opaque pagination cursor returned by the previous call.

resolve_brand
read
只读

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

参数

querystring
必需

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

品牌情报

身份、知识、文档、资产和指南。

7工具
get_brand_overview
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

get_brand_identity
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

get_brand_knowledge
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

list_brand_documents
read
只读

List authorized project documents with metadata and pagination.

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

categorystring
可选

Optional document category filter.

limitinteger
可选
默认: 30

Maximum documents returned.

cursorstring
可选

Opaque pagination cursor.

read_brand_document
read
只读

Read a bounded text excerpt from one authorized brand document.

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

documentIduuid
必需

Document ID returned by list_brand_documents.

maxCharactersinteger
可选
默认: 20000

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

list_brand_assets
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

typestring
可选

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

platformstring
可选

Platform such as instagram, facebook or linkedin.

limitinteger
可选
默认: 30

Maximum assets returned.

cursorstring
可选

Opaque pagination cursor.

get_brand_guidelines
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

sectionsstring[]
可选
默认: []

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

内容

跨品牌编辑日历和内容项。

3工具
get_content_calendar
read
只读

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

参数

rangestring
可选
默认: tomorrow

Preset 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 timezone
可选

Timezone used to calculate calendar boundaries.

fromISO timestamp
可选

Custom range start; required when range is custom.

toISO timestamp
可选

Custom range end; required when range is custom.

groupBystring
可选
默认: brand

Result grouping.

值: brand, date, none

list_content_items
read
只读

Search 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 timestamp
可选

Optional scheduled-at lower bound.

toISO timestamp
可选

Optional scheduled-at upper bound.

limitinteger
可选
默认: 50

Maximum items returned.

cursorstring
可选

Opaque pagination cursor.

get_content_item
read
只读

Return one authorized content item with safe scheduling state.

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

itemIduuid
必需

Content item ID.

社交分析

人脉、有机表现、帖子、广告和推荐。

7工具
list_social_connections
read
只读

List 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

statusstring
可选

Connection status filter.

值: connected, requires_auth, error, not_connected

get_social_overview
read
只读

Aggregate 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

fromdate
可选

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

todate
可选

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

get_social_account_analytics
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

providersstring[]
可选
默认: []

Provider filters.

值: meta, linkedin

fromdate
可选

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

todate
可选

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

list_social_post_analytics
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

providersstring[]
可选
默认: []

Provider filters.

值: meta, linkedin

fromdate
可选

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

todate
可选

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

sortBystring
可选
默认: engagement

Metric used to rank posts.

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

limitinteger
可选
默认: 20

Maximum posts returned; range 1–100.

get_social_post_analytics
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

itemIduuid
必需

Published social campaign item ID.

fromdate
可选

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

todate
可选

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

get_social_ads_report
read
只读

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

providersstring[]
可选
默认: []

Advertising provider filters.

值: meta, linkedin

levelsstring[]
可选
默认: []

Provider object levels to include.

值: campaign, adset, ad, creative

fromdate
可选

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

todate
可选

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

limitinteger
可选
默认: 50

Maximum provider snapshots returned; range 1–200.

list_social_ad_recommendations
read
只读

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

参数

brandIduuid
必需

Authorized 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

limitinteger
可选
默认: 30

Maximum recommendations returned; range 1–100.

对话

持久的 BrandSuite AI Studio 线程。

4工具
list_conversations
conversation
只读

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

参数

brandIduuid
可选

Optional brand scope.

statusstring
可选

Conversation status.

值: active, archived

limitinteger
可选
默认: 30

Maximum conversations returned.

get_conversation
conversation
只读

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

参数

conversationIduuid
必需

Conversation ID.

limitinteger
可选
默认: 50

Maximum recent messages returned.

start_brand_conversation
conversation
本地写入

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

titlestring
可选

Optional conversation title.

externalThreadIdstring
可选

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

continue_brand_conversation
conversation
本地写入

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

参数

conversationIduuid
必需

Conversation ID.

messagestring
必需

User message, up to 12,000 characters.

requestKeystring
可选

Stable request key for idempotent message replay.

languagestring
可选
默认: it

Response language.

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

生成

准备、确认和监控草稿内容

3工具
prepare_content_generation
generation
本地写入

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

参数

brandIduuid
必需

Authorized BrandSuite brand ID.

conversationIduuid
可选

Optional related BrandSuite AI Studio conversation.

contentTypestring
可选
默认: social_post

Generation scope.

值: social_post, social_campaign

channelstring
必需

Target social channel.

值: instagram, facebook, linkedin

briefstring
必需

Content brief, 5–8,000 characters.

variantsinteger
可选
默认: 1

Number of draft items, 1–20.

scheduledForISO timestamp
可选

Optional target scheduling timestamp.

timezoneIANA timezone
可选

Timezone used by the generation plan.

confirm_content_generation
generation
可计费写入

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

参数

intentIduuid
必需

Unexpired intent returned by prepare_content_generation.

idempotencyKeystring
必需

Stable key that prevents duplicate runs or credit charges.

get_generation_run
generation
只读

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

参数

runIduuid
必需

Run ID returned after generation confirmation.