MCP: Marketing

Estratégia, identidade, públicos, produtos e ações de marketing pelo MCP. 32 ferramentas.

Ferramentas desta área, geradas do código do servidor. As descrições vêm desse código, em português. Para conectar, veja o MCP da XBASE.

`distribution_get_overview`

Visão geral da Distribuição (XBASE → Marketing → Distribuição): estratégias e canais ativos, parceiros ativos e em negociação, indicadores do período (registro manual), ações pendentes, acordos vencendo em 30 dias, aprovações pendentes e conflitos entre regras. empty = nada cadastrado ainda.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`from`	não	Início (AAAA-MM-DD). Padrão: primeiro dia do mês atual.
`to`	não	Fim (AAAA-MM-DD). Padrão: último dia do mês atual.
`strategyId`	não	—
`channelId`	não	Canal principal da venda.
`partnerId`	não	—
`productId`	não	—

`distribution_get_results`

Indicadores da Distribuição (XBASE → Marketing → Distribuição → Resultados) no período (padrão: mês atual): oportunidades, vendas, conversão, receita vendida e recebida, custos, comissões previstas e pagas, ticket médio, margem (só com custo registrado), metas, comparação por canal e por parceiro. null = ainda não registrado; 0 = registrado e soma zero. Origem: registro manual. withRecords=true traz também os registros (até 500).

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`from`	não	Início (AAAA-MM-DD). Padrão: primeiro dia do mês atual.
`to`	não	Fim (AAAA-MM-DD). Padrão: último dia do mês atual.
`strategyId`	não	—
`channelId`	não	Canal principal da venda.
`partnerId`	não	—
`productId`	não	—
`withRecords`	não	—

`distribution_list_channels`

Canais de venda e distribuição (XBASE → Marketing → Distribuição → Canais): site, loja, WhatsApp, marketplace, revenda, representante, afiliados, indicação, redes e influenciadores, com papéis, custos, capacidade e status. Não são as contas conectadas (marketing_list_channels); um canal pode apontar para uma (connectionId). Com channelId devolve o detalhe com estratégias, parceiros, regras, ações e resultados.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`channelId`	não	Detalhe de um canal.
`status`	não	—
`type`	não	—
`q`	não	—

`distribution_list_partners`

Parceiros (XBASE → Marketing → Distribuição → Parceiros): indicadores, afiliados, revendas, distribuidores, estratégicos, entrega e influenciadores, com etapa do funil, contatos, remuneração e a situação dela (termsStatus), vigência e perfis sociais. type=INFLUENCER e network filtram influenciadores. affiliateStatus diz se o parceiro está ligado ao programa de afiliados da XBASE (LINKED), convidado (INVITED) ou não (null); convidar e ligar só pela tela, por uma pessoa. Com partnerId devolve o detalhe com estratégias, canais, regras, ações, resultados e o bloco affiliate (nome mascarado de quem aceitou, links, status do recebimento, contagem da rede e comissões do programa, que não são resultados da Distribuição).

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`partnerId`	não	Detalhe de um parceiro.
`type`	não	—
`stage`	não	—
`network`	não	Influenciadores com perfil nesta rede.
`channelId`	não	Parceiros que atuam neste canal.
`q`	não	—

`distribution_list_rules`

Regras comerciais documentadas (XBASE → Marketing → Distribuição → Regras), cada uma com o resumo em linguagem natural, abrangência, vigência e status, mais conflicts: pares de regras que valem ao mesmo tempo para o mesmo alvo com condições diferentes (nunca resolvidos sozinhos).

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`category`	não	—
`scopeType`	não	—
`scopeId`	não	—
`status`	não	—

`distribution_list_strategies`

Estratégias de distribuição (XBASE → Marketing → Distribuição → Estratégias): o que vende, para quem, onde, modelo (direto, indireto, híbrido), canais, parceiros, metas e status. Com strategyId devolve o detalhe com canais, parceiros, regras, ações e resultados. As arquivadas só com archived=true.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`strategyId`	não	Detalhe de uma estratégia.
`status`	não	—
`archived`	não	true = só as arquivadas.
`q`	não	Busca no nome.

`distribution_record_result`

Registra um resultado à mão (XBASE → Marketing → Distribuição → Resultados → Registrar): OPPORTUNITY, SALE, RECEIPT, COST ou COMMISSION. amountBrl é obrigatório fora de OPPORTUNITY. channelId é o canal principal (a venda conta uma vez, nele); assistChannelIds são os de apoio. Venda com parceiro devolve commissionSuggestion (valor pelas regras ativas e pela remuneração aprovada) ou commissionReview (o motivo de não sugerir): para registrar a comissão, chame de novo com kind COMMISSION, saleId e o valor. A comissão nasce FORECAST; aprovar ou marcar paga é só na tela. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`kind`	sim	—
`occurredOn`	sim	Quando aconteceu (AAAA-MM-DD).
`amountBrl`	não	Valor em R$.
`quantity`	não	Padrão 1.
`strategyId`	não	—
`channelId`	não	—
`assistChannelIds`	não	—
`partnerId`	não	—
`productId`	não	—
`description`	não	—
`opportunityId`	não	Na venda: a oportunidade que virou venda.
`saleId`	não	No recebimento e na comissão: a venda.
`commissionStatus`	não	Só em COMMISSION; padrão FORECAST.

`distribution_upsert_channel`

Cria ou edita um canal de venda (XBASE → Marketing → Distribuição → Canais). Sem channelId cria (name, type e roles obrigatórios; nasce PREPARING); com channelId edita só os campos enviados. roles: PROMOTION (divulga), LEADS (gera oportunidades), SALES (vende), DELIVERY (entrega). commercialTerms é texto livre; as regras formais vão em distribution_upsert_rule. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`channelId`	não	Canal a editar. Sem ele, cria.
`name`	não	—
`type`	não	—
`description`	não	—
`url`	não	Link https público do canal.
`roles`	não	—
`ownerUserId`	não	—
`productIds`	não	—
`audience`	não	—
`regions`	não	Estados, cidades, "Brasil" ou "Online".
`leadDestination`	não	Para onde vai a oportunidade.
`commercialTerms`	não	—
`fixedCostMonthlyBrl`	não	Custo fixo por mês (R$).
`variableCostPct`	não	Custo variável (% da venda).
`variableCostNote`	não	—
`capacity`	não	Ex.: "até 30 pedidos/dia".
`deliveryTime`	não	Ex.: "2 dias úteis".
`goals`	não	—
`connectionId`	não	Conta conectada (marketing_list_channels).
`status`	não	—

`distribution_upsert_partner`

Cadastra ou edita um parceiro ou influenciador (XBASE → Marketing → Distribuição → Parceiros). Sem partnerId cria (name e type obrigatórios; nasce PROSPECTED); com partnerId edita só os campos enviados. Mover no funil = stage. A remuneração não é aprovada aqui: termsStatus aceita DRAFT ou PENDING_APPROVAL, e mudar a remuneração de uma condição aprovada a devolve para aprovação. Seguidores e engajamento são digitados (a leitura automática ainda não existe). Contratos e materiais (arquivos) só pela tela. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`partnerId`	não	Parceiro a editar. Sem ele, cria.
`name`	não	—
`document`	não	CPF (11) ou CNPJ (14), só números.
`type`	não	—
`stage`	não	—
`contacts`	não	—
`contactId`	não	Contato do CRM (search-contacts).
`ownerUserId`	não	—
`audience`	não	—
`regions`	não	Estados, cidades, "Brasil" ou "Online".
`channelIds`	não	Canais onde atua.
`productIds`	não	—
`remuneration`	não	—
`termsStatus`	não	PENDING_APPROVAL = enviar para aprovação.
`validFrom`	não	AAAA-MM-DD
`validTo`	não	AAAA-MM-DD
`goals`	não	—
`exclusivity`	não	—
`notes`	não	—
`socialProfiles`	não	—
`niche`	não	—
`rateCard`	não	—

`distribution_upsert_rule`

Cria ou edita uma regra documentada (XBASE → Marketing → Distribuição → Regras). Não aprova: regra de preço, comissão, pagamento ou exclusividade enviada como ACTIVE fica PENDING_APPROVAL até alguém com a permissão aprovar na tela. Sem ruleId cria (name, category e scopeType obrigatórios; scopeId para STRATEGY, CHANNEL ou PARTNER). params por categoria: COMMISSION { model: FIXED|PERCENT|RECURRING, value, base: GROSS_SALE|NET_SALE|RECEIVED|MARGIN, installments? }; PRICING { maxDiscountPct?, approvalAbovePct?, minPriceBrl? }; ATTRIBUTION { criteria: LAST_CONTACT|FIRST_CONTACT|COUPON|TRACKING_LINK|CUSTOMER_DECLARED, windowDays }; PAYMENT { daysAfter, base: SALE_DATE|RECEIPT_DATE|MONTH_CLOSE, refundPolicy }; SERVICE_LEVEL { responseHours? }; PRODUCTS_TERRITORY { productIds, regions }; EXCLUSIVITY { condition }; as demais {} (o texto vai em description). Só regra documentada: a automática ainda não existe. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`ruleId`	não	Regra a editar. Sem ele, cria.
`name`	não	—
`description`	não	—
`category`	não	—
`scopeType`	não	GENERAL vale para todos.
`scopeId`	não	Id da estratégia, do canal ou do parceiro.
`overridesGeneral`	não	true = esta regra substitui a regra geral da mesma categoria.
`params`	não	—
`validFrom`	não	AAAA-MM-DD
`validTo`	não	AAAA-MM-DD
`ownerUserId`	não	—
`approverUserId`	não	Quem aprova exceções.
`status`	não	—

`distribution_upsert_strategy`

Cria ou edita uma estratégia de distribuição (XBASE → Marketing → Distribuição → Estratégias). Sem strategyId cria (só name é obrigatório; nasce rascunho); com strategyId edita só os campos enviados (listas trocam inteiras). Para sair do rascunho precisa de produto (productIds ou productsNote), objetivo, modelo e um canal: o erro lista o que falta. Pausar = status PAUSED. Só registra o plano. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`strategyId`	não	Estratégia a editar. Sem ele, cria.
`name`	não	Nome (obrigatório ao criar).
`description`	não	—
`productIds`	não	Produtos do catálogo (marketing_list_products).
`productsNote`	não	Produto ou serviço fora do catálogo ("consultoria de 1 hora").
`audience`	não	—
`regions`	não	Estados, cidades, "Brasil" ou "Online".
`objective`	não	Objetivo principal.
`model`	não	DIRECT = vende você; INDIRECT = por parceiros; HYBRID = os dois.
`coverage`	não	Quantos pontos de venda: muitos, alguns escolhidos ou um só.
`delivery`	não	—
`goals`	não	—
`budgetBrl`	não	—
`ownerUserId`	não	Responsável (membro do workspace).
`startsOn`	não	AAAA-MM-DD
`endsOn`	não	AAAA-MM-DD
`channelIds`	não	Canais (distribution_list_channels).
`partnerIds`	não	Parceiros (distribution_list_partners).
`projectId`	não	Projeto de marketing (marketing_list_projects).
`status`	não	—

`marketing_add_reference`

Adiciona uma referência por link (XBASE → Marketing → Identidade visual → Referências). kind: INSPIRATION, COMPETITOR, APPROVED_CREATIVE ou BRAND_ASSET. Arquivo (imagem ou PDF) só pela tela.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`kind`	sim	Tipo da referência.
`title`	sim	Título.
`url`	sim	Link https (post, anúncio, página).
`tags`	não	—
`notes`	não	Por que é referência, o que aproveitar.
`projectId`	não	Projeto (marketing_list_projects).

`marketing_create_action`

Cria uma ação de marketing (XBASE → Marketing → Ações → Nova ação), solta ou num projeto. kind: CONTENT, AD, MESSAGE, EMAIL, EVENT, TASK ou DECISION. links liga a ação à produção do Estúdio, à publicação agendada, à campanha ou a uma URL. Com distributionStrategyId/ChannelId/PartnerId entra no plano de ação da Distribuição (prioridade, verba, custo e checklist). Anexos só pela tela. Só registra: não publica nem envia nada.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`title`	sim	O que fazer.
`kind`	sim	Tipo da ação.
`description`	não	—
`status`	não	TODO (padrão), DOING, WAITING, DONE ou CANCELED.
`startsAt`	não	Início (ISO 8601 com fuso).
`dueAt`	não	Prazo (ISO 8601 com fuso, ex.: 2026-11-01T18:00:00-03:00).
`projectId`	não	Projeto (marketing_list_projects). Nulo = ação solta.
`assigneeUserId`	não	Responsável (membro do workspace).
`channel`	não	Rótulo do canal: instagram, whatsapp, meta_ads, email…
`links`	não	Ligações da ação (troca inteiro).
`priority`	não	Prioridade (padrão MEDIUM).
`plannedBudgetBrl`	não	Verba prevista (R$).
`actualCostBrl`	não	Custo real (R$).
`checklist`	não	Checklist (troca a lista inteira).
`distributionStrategyId`	não	Estratégia da Distribuição (distribution_list_strategies). Nulo = desliga.
`distributionChannelId`	não	Canal de venda (distribution_list_channels). Nulo = desliga.
`distributionPartnerId`	não	Parceiro (distribution_list_partners). Nulo = desliga.

`marketing_create_project`

Cria um projeto de marketing (XBASE → Marketing → Projetos → Novo projeto). kind: ALWAYS_ON (sempre ligado), SEASONAL (data comemorativa), LAUNCH (lançamento) ou INSTITUTIONAL. Ligue adCampaignIds e crmTags para o projeto ter números. Só registra o plano: não cria campanha nem publica.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`name`	sim	Nome do projeto.
`kind`	sim	Tipo do projeto.
`status`	não	PLANNED (padrão), ACTIVE, PAUSED, DONE ou CANCELED.
`startsAt`	não	Início (AAAA-MM-DD).
`endsAt`	não	Fim (AAAA-MM-DD). Nulo = sem fim (sempre ligado).
`objective`	não	Objetivo do projeto.
`kpis`	não	Até 10 KPIs com meta (a lista troca inteira).
`budget`	não	Verba (troca inteira).
`audience`	não	Público do projeto (troca inteiro).
`message`	não	Mensagem principal.
`offer`	não	Oferta do projeto.
`channelIds`	não	Ids das conexões (Instagram, Página, WhatsApp) usadas.
`adCampaignIds`	não	Ids NA PLATAFORMA das campanhas de anúncio do projeto (ads_list_entities): os números de mídia vêm delas.
`crmTags`	não	Etiquetas das conversas do projeto (ex.: "camp-gargantilha"): conversas, qualificados e vendas vêm delas.
`editorialLineIds`	não	Linhas editoriais (marketing_get_strategy).
`productUrls`	não	Links https de produtos fora do catálogo.
`productIds`	não	Produtos do catálogo (marketing_list_products).
`ownerUserId`	não	Responsável (membro do workspace).
`notes`	não	—

`marketing_get_audience`

Público do workspace (XBASE → Marketing → Público): personas completas (dores, desejos, objeções, gatilhos, palavras que usam), público-alvo dos anúncios (idade, regiões, empresas ou consumidor, segmentos, cidades) e os termos-chave do início dos anúncios com o status de cada um. Só leitura.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).

`marketing_get_identity`

Identidade visual do workspace (XBASE → Marketing → Identidade visual): frase, logos, paleta, fontes e tom de voz (faça/não faça), mais a marca do Estúdio (nome, @, cores, logo, CTA) e as regras (claims proibidos e diretrizes). Só leitura.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).

`marketing_get_project`

Um projeto de marketing com as ações e os números do período (XBASE → Marketing → Projetos → projeto): mídia das campanhas ligadas (investimento, impressões, cliques, conversões da plataforma, conversas vindas de anúncio), CRM das etiquetas (conversas, qualificados, vendas), CPL, receita estimada (vendas × ticket médio), ROAS e cada KPI com real, meta e progresso. Padrão do período: desde o início do projeto (ou 30 dias) até hoje.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`projectId`	sim	Id do projeto (marketing_list_projects).
`from`	não	Início do período dos números (AAAA-MM-DD).
`to`	não	Fim do período dos números (AAAA-MM-DD).

`marketing_get_strategy`

Estratégia de marketing do workspace (XBASE → Marketing → Estratégia): posicionamento, mensagem central, diferenciais, provas reais, ofertas (código, mecânica, status, validade), sazonalidade (épocas do ano), metas do negócio (ticket médio, margem, CPL e ROAS alvo) e as linhas editoriais completas. Só leitura.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).

`marketing_import_products`

Importa produtos de fora (XBASE → Marketing → Produtos → Adicionar por link / Importar feed). source page: lê a página do produto (og:title, og:image, preço do Open Graph) e cria ou atualiza o produto desse link. source feed: baixa o feed da loja (JSON ou CSV, até 5 MB e 2.000 itens) e atualiza por id ou link; devolve created, updated, skipped e os erros. Só https de site público; o link não pode redirecionar.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`source`	sim	page = página de um produto; feed = feed da loja.
`url`	sim	Link https da página ou do feed.
`format`	não	Formato do feed (obrigatório com source feed).
`baseUrl`	não	Feed só com slug: base dos links (ex.: https://loja.com/produtos/).

`marketing_list_actions`

Ações de marketing (XBASE → Marketing → Ações): conteúdos, anúncios, mensagens, e-mails, eventos, tarefas e decisões, por prazo (sem prazo por último), até 500. Filtros por projeto, status, responsável e prazo; distribution=true traz só o plano de ação da Distribuição (ou filtre pela estratégia, canal ou parceiro).

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`projectId`	não	Só as ações deste projeto.
`status`	não	—
`assignee`	não	Id do responsável.
`from`	não	Prazo a partir de (ISO 8601 com fuso).
`to`	não	Prazo até (ISO 8601 com fuso).
`distribution`	não	true = só as ações ligadas à Distribuição (plano de ação).
`distributionStrategyId`	não	Só as ações desta estratégia da Distribuição.
`distributionChannelId`	não	Só as ações deste canal de venda.
`distributionPartnerId`	não	Só as ações deste parceiro.

`marketing_list_channels`

Canais e perfis do workspace (XBASE → Marketing → Canais e perfis): Instagram, Página do Facebook, WhatsApp, TikTok, YouTube e contas de anúncio, cada um com status, saúde (ok, aviso ou erro e o motivo), agente vinculado, projetos que usam o canal e a tela para gerenciar. O id é o que vai em channelIds do projeto. Só leitura.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).

`marketing_list_products`

Catálogo de produtos do workspace (XBASE → Marketing → Produtos): nome, link, foto, preço de referência e quando foi lido, categoria, etiquetas e status, por nome (até 500). Traz também o último feed importado (feed). Os projetos ligam produtos por productIds.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`q`	não	Busca no nome.
`category`	não	—
`status`	não	—

`marketing_list_projects`

Projetos de marketing (XBASE → Marketing → Projetos): campanhas e iniciativas com tipo, status, período, objetivo, KPIs, verba, público e o que cada um liga (campanhas de anúncio, etiquetas do CRM, canais, linhas). Ativos primeiro. Números do período: marketing_get_project.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`status`	não	Filtra por status.
`kind`	não	Filtra por tipo.

`marketing_list_references`

Referências visuais (XBASE → Marketing → Identidade visual → Referências): inspirações, concorrentes, criativos aprovados e ativos da marca, com link e/ou arquivo, etiquetas, notas e projeto. As mais novas primeiro (até 500).

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`kind`	não	—
`projectId`	não	Só as deste projeto.
`q`	não	Busca no título, nas notas e nas etiquetas.

`marketing_update_action`

Edita uma ação de marketing (XBASE → Marketing → Ações): só os campos enviados mudam. status DONE marca como feita (guarda quando); sair de DONE reabre.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`actionId`	sim	Id da ação (marketing_list_actions).
`title`	não	—
`kind`	não	—
`description`	não	—
`status`	não	TODO (padrão), DOING, WAITING, DONE ou CANCELED.
`startsAt`	não	Início (ISO 8601 com fuso).
`dueAt`	não	Prazo (ISO 8601 com fuso, ex.: 2026-11-01T18:00:00-03:00).
`projectId`	não	Projeto (marketing_list_projects). Nulo = ação solta.
`assigneeUserId`	não	Responsável (membro do workspace).
`channel`	não	Rótulo do canal: instagram, whatsapp, meta_ads, email…
`links`	não	Ligações da ação (troca inteiro).
`priority`	não	Prioridade (padrão MEDIUM).
`plannedBudgetBrl`	não	Verba prevista (R$).
`actualCostBrl`	não	Custo real (R$).
`checklist`	não	Checklist (troca a lista inteira).
`distributionStrategyId`	não	Estratégia da Distribuição (distribution_list_strategies). Nulo = desliga.
`distributionChannelId`	não	Canal de venda (distribution_list_channels). Nulo = desliga.
`distributionPartnerId`	não	Parceiro (distribution_list_partners). Nulo = desliga.

`marketing_update_audience`

Atualiza o público-alvo e os termos-chave (XBASE → Marketing → Público → Público-alvo e Termos-chave). targeting: só os campos enviados mudam (listas trocam inteiras). hookTerms: termo com id é editado, sem id é novo; removeHookTermIds remove; os outros ficam. Até 100 termos; o texto não repete. Não mexe em campanhas na Meta.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`targeting`	não	Público-alvo dos anúncios e do diagnóstico.
`hookTerms`	não	Termos-chave a criar ou editar.
`removeHookTermIds`	não	Termos-chave a remover.

`marketing_update_editorial_lines`

Cria, edita ou remove linhas editoriais (XBASE → Marketing → Estratégia → Linhas editoriais). Linha com id é editada (só os campos enviados); sem id é nova; removeIds remove. As outras ficam como estão. Até 50 linhas; o nome não repete. O Estúdio usa a linha no roteiro (objetivo, estrutura, tom, regras do início e do CTA).

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`lines`	não	Linhas a criar ou editar.
`removeIds`	não	Linhas a remover.

`marketing_update_identity`

Atualiza o guia visual e o tom (XBASE → Marketing → Identidade visual). Só os campos enviados mudam; listas (logos, paleta, fontes, faça/não faça) trocam inteiras, então mande a lista completa (leia antes com marketing_get_identity). A marca e as regras do Estúdio não mudam aqui.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`tagline`	não	Frase da marca (até 120).
`logos`	não	Logos (a lista troca inteira).
`palette`	não	Paleta de cores (a lista troca inteira).
`fonts`	não	Fontes (a lista troca inteira).
`voice`	não	Tom de voz: só os campos enviados mudam.

`marketing_update_personas`

Cria, edita ou remove personas (XBASE → Marketing → Público → Personas). Persona com id é editada (só os campos enviados); sem id é nova; removeIds remove (e tira a persona das linhas que a usavam). As outras ficam como estão. Até 20 personas; o nome não repete. O Estúdio usa as personas no roteiro.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`personas`	não	Personas a criar ou editar.
`removeIds`	não	Personas a remover.

`marketing_update_project`

Edita um projeto de marketing (XBASE → Marketing → Projetos → projeto → Editar): só os campos enviados mudam; listas e objetos (KPIs, verba, público, campanhas, etiquetas) trocam inteiros. Para encerrar, use status DONE ou CANCELED.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`projectId`	sim	Id do projeto.
`name`	não	—
`kind`	não	—
`status`	não	PLANNED (padrão), ACTIVE, PAUSED, DONE ou CANCELED.
`startsAt`	não	Início (AAAA-MM-DD).
`endsAt`	não	Fim (AAAA-MM-DD). Nulo = sem fim (sempre ligado).
`objective`	não	Objetivo do projeto.
`kpis`	não	Até 10 KPIs com meta (a lista troca inteira).
`budget`	não	Verba (troca inteira).
`audience`	não	Público do projeto (troca inteiro).
`message`	não	Mensagem principal.
`offer`	não	Oferta do projeto.
`channelIds`	não	Ids das conexões (Instagram, Página, WhatsApp) usadas.
`adCampaignIds`	não	Ids NA PLATAFORMA das campanhas de anúncio do projeto (ads_list_entities): os números de mídia vêm delas.
`crmTags`	não	Etiquetas das conversas do projeto (ex.: "camp-gargantilha"): conversas, qualificados e vendas vêm delas.
`editorialLineIds`	não	Linhas editoriais (marketing_get_strategy).
`productUrls`	não	Links https de produtos fora do catálogo.
`productIds`	não	Produtos do catálogo (marketing_list_products).
`ownerUserId`	não	Responsável (membro do workspace).
`notes`	não	—

`marketing_update_strategy`

Atualiza a estratégia (XBASE → Marketing → Estratégia). Só os campos enviados mudam; listas (diferenciais, provas, ofertas, sazonalidade) trocam inteiras, então mande a lista completa (leia antes com marketing_get_strategy). Provas são só fatos reais (certificado, garantia, loja, história). goals grava as metas do negócio (aba Metas), que também valem para Anúncios. Não publica nem gasta nada.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`positioning`	não	Posicionamento (até 1.000).
`centralMessage`	não	Mensagem central (até 300).
`differentials`	não	Diferenciais (até 20).
`proofPoints`	não	Provas reais (até 20).
`offers`	não	Ofertas (até 30; o código não repete).
`seasonality`	não	Épocas do ano (até 30).
`goals`	não	Metas do negócio: só os números enviados mudam.

`marketing_upsert_product`

Cadastra ou edita um produto do catálogo (XBASE → Marketing → Produtos). Sem productId cria (name e url obrigatórios; o link é único no workspace); com productId edita só os campos enviados. Para arquivar, status ARCHIVED. Para ler a página ou o feed da loja, use marketing_import_products.

Parâmetro	Obrigatório	Descrição
`workspaceId`	não	Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace).
`productId`	não	Produto a editar (marketing_list_products). Sem ele, cria.
`name`	não	Nome (obrigatório ao criar).
`url`	não	Página do produto, https (obrigatório ao criar).
`imageUrl`	não	Foto (https).
`price`	não	Preço de referência (ex.: 4590.5).
`currency`	não	Moeda (BRL, padrão; USD…).
`category`	não	—
`tags`	não	Etiquetas (a lista troca inteira).
`description`	não	—
`externalId`	não	Id na loja ou no feed.
`status`	não	ACTIVE (padrão) ou ARCHIVED (arquivado).

MCP: Marketing

distribution_get_overviewCopy Anchor Link

distribution_get_resultsCopy Anchor Link

distribution_list_channelsCopy Anchor Link

distribution_list_partnersCopy Anchor Link

distribution_list_rulesCopy Anchor Link

distribution_list_strategiesCopy Anchor Link

distribution_record_resultCopy Anchor Link

distribution_upsert_channelCopy Anchor Link

distribution_upsert_partnerCopy Anchor Link

distribution_upsert_ruleCopy Anchor Link

distribution_upsert_strategyCopy Anchor Link

marketing_add_referenceCopy Anchor Link

marketing_create_actionCopy Anchor Link

marketing_create_projectCopy Anchor Link

marketing_get_audienceCopy Anchor Link

marketing_get_identityCopy Anchor Link

marketing_get_projectCopy Anchor Link

marketing_get_strategyCopy Anchor Link

marketing_import_productsCopy Anchor Link

marketing_list_actionsCopy Anchor Link

marketing_list_channelsCopy Anchor Link

marketing_list_productsCopy Anchor Link

marketing_list_projectsCopy Anchor Link

marketing_list_referencesCopy Anchor Link

marketing_update_actionCopy Anchor Link

marketing_update_audienceCopy Anchor Link

marketing_update_editorial_linesCopy Anchor Link

marketing_update_identityCopy Anchor Link

marketing_update_personasCopy Anchor Link

marketing_update_projectCopy Anchor Link

marketing_update_strategyCopy Anchor Link

marketing_upsert_productCopy Anchor Link

Nesta página