Riferimento tool
Tutti i tool BrandSuite MCP con effetto e parametri di input.
28 tool. Ogni scheda documenta effetto e contratto di input esposto da tools/list.
get_current_userRestituisce utente autenticato, workspace, gruppi tool e fuso orario.
Parametri
Nessun parametro di input.
get_current_workspaceRestituisce il workspace associato all’autorizzazione MCP.
Parametri
Nessun parametro di input.
list_brandsElenca tutti i brand accessibili nel workspace autorizzato.
Parametri
limitinteger50Numero massimo di risultati da restituire, entro il limite indicato dal tool.
cursorstringCursore opaco restituito dalla pagina precedente; omettilo per iniziare.
resolve_brandRisolvi un nome brand senza indovinare quando esistono più corrispondenze.
Parametri
querystringTesto facoltativo da cercare nei campi supportati.
get_brand_overviewRestituisce una sintesi del brand e la disponibilità di identità, documenti, asset e linee guida.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
get_brand_identityRestituisce colori, tipografia, font, voce e design token sicuri.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
get_brand_knowledgeRestituisce posizionamento, pubblico, valori, tono, competitor e contesto operativo.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
list_brand_documentsElenca i documenti autorizzati con metadati e paginazione.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
categorystringCategoria facoltativa con cui filtrare i risultati.
limitinteger30Numero massimo di risultati da restituire, entro il limite indicato dal tool.
cursorstringCursore opaco restituito dalla pagina precedente; omettilo per iniziare.
read_brand_documentLegge un estratto testuale limitato di un documento autorizzato.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
documentIduuidID del documento autorizzato da leggere.
maxCharactersinteger20000Numero massimo di caratteri testuali da restituire.
list_brand_assetsElenca asset creativi senza prompt, dati provider o percorsi storage privati.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
typestringTipo facoltativo con cui filtrare i risultati.
platformstringPiattaforma o canale social di destinazione.
limitinteger30Numero massimo di risultati da restituire, entro il limite indicato dal tool.
cursorstringCursore opaco restituito dalla pagina precedente; omettilo per iniziare.
get_brand_guidelinesRestituisce il documento di linee guida e le pagine visibili richieste.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
sectionsstring[][]Sezioni specifiche da restituire; un array vuoto include tutte quelle disponibili.
get_content_calendarAggrega contenuti pianificati per uno o tutti i brand in un intervallo temporale.
Parametri
rangestringtomorrowIntervallo temporale predefinito da usare per la ricerca.
Valori: today, tomorrow, this_week, next_7_days, custom
brandIdsuuid[][]ID dei brand da analizzare; un array vuoto include tutti i brand accessibili.
statusesstring[][scheduled]Stati con cui filtrare i risultati; un array vuoto non applica il filtro.
channelsstring[][]Canali con cui filtrare i contenuti; un array vuoto include tutti i canali.
timezoneIANA timezoneFuso orario IANA usato per calcolare date relative e orari locali.
fromISO timestampData iniziale inclusiva nel formato YYYY-MM-DD.
toISO timestampData finale inclusiva nel formato YYYY-MM-DD.
groupBystringbrandCampo con cui raggruppare i risultati restituiti.
Valori: brand, date, none
list_content_itemsCerca contenuti per brand, stato, canale e data.
Parametri
brandIdsuuid[][]ID dei brand da analizzare; un array vuoto include tutti i brand accessibili.
statusesstring[][]Stati con cui filtrare i risultati; un array vuoto non applica il filtro.
channelsstring[][]Canali con cui filtrare i contenuti; un array vuoto include tutti i canali.
fromISO timestampData iniziale inclusiva nel formato YYYY-MM-DD.
toISO timestampData finale inclusiva nel formato YYYY-MM-DD.
limitinteger50Numero massimo di risultati da restituire, entro il limite indicato dal tool.
cursorstringCursore opaco restituito dalla pagina precedente; omettilo per iniziare.
get_content_itemRestituisce un contenuto autorizzato con stato di pianificazione sicuro.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
itemIduuidID del contenuto o post autorizzato.
list_conversationsElenca le conversazioni AI Studio persistenti dell’utente.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
statusstringStato facoltativo con cui filtrare i risultati.
Valori: active, archived
limitinteger30Numero massimo di risultati da restituire, entro il limite indicato dal tool.
get_conversationRestituisce una cronologia messaggi limitata.
Parametri
conversationIduuidID della conversazione BrandSuite autorizzata.
limitinteger50Numero massimo di risultati da restituire, entro il limite indicato dal tool.
start_brand_conversationCrea una conversazione persistente legata a un brand.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
titlestringTitolo facoltativo della nuova conversazione.
externalThreadIdstringIdentificatore esterno facoltativo, conservato soltanto come hash per la correlazione.
continue_brand_conversationSalva un messaggio e ottiene indicazioni AI senza eseguire azioni proposte.
Parametri
conversationIduuidID della conversazione BrandSuite autorizzata.
messagestringMessaggio dell’utente da aggiungere alla conversazione.
requestKeystringChiave stabile facoltativa che evita di duplicare la stessa richiesta.
languagestringitCodice lingua preferito per la risposta o il contenuto.
Valori: it, en, fr, de, es, pt, ja, zh
prepare_content_generationNormalizza una richiesta social e restituisce un intent con costo esatto.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
conversationIduuidID della conversazione BrandSuite autorizzata.
contentTypestringsocial_postTipo di contenuto da preparare per la generazione.
Valori: social_post, social_campaign
channelstringCanale di destinazione del contenuto.
Valori: instagram, facebook, linkedin
briefstringBrief completo con obiettivo, messaggio e vincoli del contenuto.
variantsinteger1Numero di varianti da preparare e generare.
scheduledForISO timestampData e ora ISO 8601 facoltative proposte per la pianificazione; il MCP non pubblica automaticamente.
timezoneIANA timezoneFuso orario IANA usato per calcolare date relative e orari locali.
confirm_content_generationConferma un intent non scaduto e avvia il run canonico in modo idempotente.
Parametri
intentIduuidID dell’intent di generazione preparato e non ancora scaduto.
idempotencyKeystringChiave stabile generata dal client per impedire run e addebiti duplicati.
get_generation_runRestituisce avanzamento e risultato sicuro di un run autorizzato.
Parametri
runIduuidID del run di generazione autorizzato da monitorare.
Analytics social
Connessioni, performance organiche, post, ads e raccomandazioni.
list_social_connectionsElenca connessioni Meta, Instagram e LinkedIn reali con capacità, stato e ultimo sync.
Parametri
brandIdsuuid[][]ID dei brand da analizzare; un array vuoto include tutti i brand accessibili.
providersstring[][]Provider da includere; un array vuoto include tutti quelli disponibili.
Valori: meta, linkedin
statusstringStato facoltativo con cui filtrare i risultati.
Valori: connected, requires_auth, error, not_connected
get_social_overviewAggrega provider collegati, follower e performance social per uno o tutti i brand.
Parametri
brandIdsuuid[][]ID dei brand da analizzare; un array vuoto include tutti i brand accessibili.
providersstring[][]Provider da includere; un array vuoto include tutti quelli disponibili.
Valori: meta, linkedin
fromdateData iniziale inclusiva nel formato YYYY-MM-DD.
todateData finale inclusiva nel formato YYYY-MM-DD.
get_social_account_analyticsRestituisce serie temporali account per follower, reach, impression, engagement, click e spesa.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
providersstring[][]Provider da includere; un array vuoto include tutti quelli disponibili.
Valori: meta, linkedin
fromdateData iniziale inclusiva nel formato YYYY-MM-DD.
todateData finale inclusiva nel formato YYYY-MM-DD.
list_social_post_analyticsOrdina i contenuti pubblicati per engagement, impression, reach, click o reazioni.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
providersstring[][]Provider da includere; un array vuoto include tutti quelli disponibili.
Valori: meta, linkedin
fromdateData iniziale inclusiva nel formato YYYY-MM-DD.
todateData finale inclusiva nel formato YYYY-MM-DD.
sortBystringengagementMetrica o campo usato per ordinare i risultati.
Valori: engagement, impressions, reach, clicks, likes, comments, shares, saves, date
limitinteger20Numero massimo di risultati da restituire, entro il limite indicato dal tool.
get_social_post_analyticsRestituisce dettaglio e serie temporale di un post, tassi e ultimo aggiornamento.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
itemIduuidID del contenuto o post autorizzato.
fromdateData iniziale inclusiva nel formato YYYY-MM-DD.
todateData finale inclusiva nel formato YYYY-MM-DD.
get_social_ads_reportRestituisce snapshot Meta o LinkedIn Ads con spesa, CTR, CPC, CPM, conversioni e ranking.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
providersstring[][]Provider da includere; un array vuoto include tutti quelli disponibili.
Valori: meta, linkedin
levelsstring[][]Livelli degli oggetti pubblicitari da includere nel report.
Valori: campaign, adset, ad, creative
fromdateData iniziale inclusiva nel formato YYYY-MM-DD.
todateData finale inclusiva nel formato YYYY-MM-DD.
limitinteger50Numero massimo di risultati da restituire, entro il limite indicato dal tool.
list_social_ad_recommendationsElenca raccomandazioni Ads con evidenze, confidenza e rischi senza applicarle.
Parametri
brandIduuidID del brand BrandSuite autorizzato.
providersstring[][]Provider da includere; un array vuoto include tutti quelli disponibili.
Valori: meta, linkedin
statusesstring[][]Stati con cui filtrare i risultati; un array vuoto non applica il filtro.
Valori: open, accepted, dismissed, draft_action_created
severitiesstring[][]Livelli di severità delle raccomandazioni da includere.
Valori: info, low, medium, high
limitinteger30Numero massimo di risultati da restituire, entro il limite indicato dal tool.