Referência de ferramentas
Toda ferramenta que um assistente conectado pode chamar, agrupada da mesma forma como o servidor as registra. Uma ferramenta só é oferecida ao assistente se a sua conexão tiver o escopo que ela exige — não existe uma ferramenta de escrita que fique presente mas sempre retorne erro; se você não concedeu contacts:write, o assistente simplesmente não vê upsert_contacts de jeito nenhum. Veja Escopos e permissões para o que cada escopo significa.
Destrutiva, nas tabelas abaixo, é a mesma anotação do MCP que o próprio processo de revisão do Claude exige — ela marca uma ferramenta cujo efeito não pode ser desfeito trivialmente (excluir um projeto, sobrescrever uma árvore, remover um contato), não "perigosa" em algum sentido mais vago. Toda ferramenta de escrita ainda só aceita os campos que você esperaria; nenhuma delas aceita um payload bruto pelo qual o modelo pudesse contrabandear alterações arbitrárias.
Descoberta
| Ferramenta | Escopo | Notas |
|---|
search | qualquer um entre projects:read / templates:read / contacts:read | Pesquisa projetos, modelos e listas de contatos por nome. Retorna ids opacos para o fetch. É a ferramenta que um cliente com capacidade de pesquisa aprofundada (deep research) chama automaticamente. |
fetch | igual ao search | Resolve um id do search em seu conteúdo completo. |
Design de e-mail
| Ferramenta | Escopo | Destrutiva | Notas |
|---|
list_projects | projects:read | | Id, nome e propósito de cada projeto. |
get_email | projects:read | | O pré-cabeçalho, a árvore de blocos, o tema e as configurações de respostas atuais de um projeto. |
preview_email | projects:read | | Renderiza através do pipeline real de HTML enviado por e-mail — o documento exato que um envio produziria. Vinculado a widget (veja abaixo). |
list_block_types | projects:read | | O catálogo completo de 44 blocos, gerado a partir do registro em tempo real — sempre atualizado, nunca mantido manualmente. |
list_templates | projects:read | | Seus modelos salvos, ou a galeria aprovada da comunidade. |
create_project | projects:write | | Opcionalmente semeado a partir de um modelo de propósito integrado, com um pré-cabeçalho opcional. |
add_block / update_block / move_block | projects:write | | Edições na árvore, validadas por canPlace/campo da mesma forma que as edições da Mia AI do estúdio. |
remove_block | projects:write | ✓ | Exclui um bloco e seus filhos. |
set_theme | projects:write | | Cores de marca, fonte, escala tipográfica, estilos de botão, estilo de links, espaço entre blocos, layout do cartão e modo escuro. |
rename_project | projects:write | | |
delete_project | projects:write | ✓ | Permanente. |
apply_template | projects:write | ✓ | Sobrescreve toda a árvore e o tema do projeto. |
save_as_template | templates:write | | Tira um retrato (snapshot) do projeto atual e o transforma em um modelo reutilizável. |
publish_landing_page | projects:write | | Publica um e-mail como página web pública em /lp/<slug> e devolve a URL. O assistente é instruído a mostrar o e-mail e pedir a sua aprovação antes, como no envio. |
unpublish_landing_page | projects:write | | Tira a página do ar. O endereço continua reservado para você. |
set_response_settings | projects:write | | Define o que é uma resposta completa: todos os blocos contados ou qualquer resposta, quais blocos contam, a mensagem final e um redirecionamento https opcional. |
Público
| Ferramenta | Escopo | Destrutiva | Notas |
|---|
list_data_sources | contacts:read | | Cada fonte de dados, incluindo listas de contatos. Valores de credenciais nunca são retornados. |
list_contact_lists | contacts:read | | Listas de contatos especificamente — id, nome, campos, número de linhas. |
get_contact_list_summary | contacts:read | | Contagens, totais de supressão e a divisão da verificação de e-mail, mais o status da última reverificação — nenhum dado individual de contato. |
find_contacts | contacts:read | | Consulta limitada (≤25 linhas, paginada por cursor). sortBy: "engagementScore" devolve primeiro os contatos mais quentes da lista, com a pontuação e a variação da semana. Toda chamada é registrada no log de acesso a dados pessoais, assim como uma leitura de contato pelo painel. |
upsert_contacts | contacts:write | | Adiciona ou atualiza linhas; aplica o limite de contatos do seu plano. |
remove_contact | contacts:write | ✓ | Remove uma linha permanentemente. |
add_suppression / remove_suppression | contacts:write | | Bloqueia ou desbloqueia um endereço em toda a conta, com o mesmo efeito do próprio link de cancelamento de inscrição de um destinatário. |
Resultados
| Ferramenta | Escopo | Destrutiva | Notas |
|---|
get_campaign_results | analytics:read | | Aberturas/cliques/respostas/receita, comparação de variantes A/B, mapa de calor de cliques. Apenas resumido — nunca eventos brutos por destinatário. Vinculado a widget. |
get_email_insights | analytics:read | | Uma visualização do Insights (visão geral, blocos, um bloco, público, tabela cruzada, envios ou engajamento) como agregados, com filtros opcionais de data, envio, variante e lista. Os mesmos números da página; público e tabela cruzada exigem Pro ou superior. As diferenças são observadas, não testadas. |
get_form_responses | analytics:read | | Totais por pergunta; respostas de texto livre são uma amostra limitada e isolada. |
list_orders | analytics:read | | Pedidos de checkout do bloco de produto. |
list_campaign_sends | analytics:read | | Envios em massa anteriores, mais recentes primeiro. |
list_schedules | analytics:read | | Envios recorrentes configurados em um projeto. |
mark_order_fulfilled | commerce:write | | Marca um pedido físico como enviado e notifica o comprador por e-mail. |
create_schedule | campaigns:send | | Configura um novo envio recorrente. |
set_schedule_enabled | campaigns:send | ✓ | Marcada como destrutiva porque desativar um agendamento ativo interrompe envios futuros silenciosamente. |
Envio
| Ferramenta | Escopo | Destrutiva | Notas |
|---|
send_test_email | campaigns:read | | Uma única cópia com prefixo [Test] para um endereço que você especifica — não toca no seu público real nem exige campaigns:send. |
prepare_send | campaigns:send | | Somente leitura por anotação — resolve o público e renderiza uma pré-visualização, não envia nada. Retorna um confirmationToken, e quantos contatos serão pulados por endereço inválido ou por falta de consentimento. Vinculado a widget (cartão de confirmação de envio). |
confirm_send | campaigns:send | ✓ | Exige o confirmationToken exato retornado por prepare_send, sem alteração, dentro de 10 minutos. Veja Segurança para saber por quê. |
Caixa de entrada e tickets
| Ferramenta | Escopo | Notas |
|---|
list_mailbox_threads / get_mailbox_thread | mailbox:read | E-mails recebidos no seu domínio verificado. Os corpos das mensagens são isolados como conteúdo não confiável, de autoria do destinatário. |
reply_to_mailbox_thread | mailbox:write | Envia a partir do endereço de mailbox exato em que o e-mail original chegou, corretamente encadeado (threaded). |
list_tickets / get_ticket | mailbox:read | Conversas de tickets de suporte. Mesmo isolamento de conteúdo não confiável. |
reply_to_ticket | mailbox:write | Adiciona uma mensagem do(a) proprietário(a) e envia um e-mail ao destinatário com um link de volta. |
Jornadas e segmentos
| Ferramenta | Escopo | Destrutiva | Notas |
|---|
list_journeys | journeys:read | | Id, nome, ativada ou não, tipo de gatilho e número de etapas de cada jornada. |
get_journey | journeys:read | | O fluxo completo de uma jornada, com os nomes dos seus e-mails, listas e segmentos, e tudo o que a impediria de rodar. Para uma jornada desativada que pode rodar, também retorna um enableToken. |
list_segments | journeys:read | | Os segmentos salvos, com a lista de contatos e as regras de cada um. |
create_segment | journeys:write | | Salva um segmento em uma lista de contatos. Respeita o limite de segmentos do seu plano. |
build_journey | journeys:write | | Cria uma jornada nova, ou edita uma desativada, a partir de um pedido em linguagem natural, com a Mia AI do construtor de jornadas. Usa um turno da Mia AI. O resultado é sempre salvo desativado, e uma jornada ativada nunca é alterada. |
set_journey_enabled | journeys:write (+ campaigns:send para ativar) | ✓ | Ativar uma jornada exige o enableToken de get_journey, sem alterações, em até 10 minutos e sem edições no meio do caminho. A mesma ideia de duas etapas de prepare_send/confirm_send. Pausar não exige nenhum dos dois. |
Experimentos
| Ferramenta | Escopo | Destrutiva | Notas |
|---|
list_experiments | analytics:read | | Os seus experimentos A/B, do mais recente ao mais antigo, de envio e de jornada: status, variantes, métricas, o último resultado do mecanismo de análise, a decisão registrada, se houver, e um link para a página de resultados. Filtra por status, tipo, e-mail ou jornada. |
get_experiment_results | analytics:read | | O relatório de um experimento, o mesmo da exportação JSON da página de resultados, mais o resultado do mecanismo em uma linha. O assistente é instruído de que essa linha é o único veredito, então só aponta um vencedor quando o mecanismo apontou. |
create_experiment_draft | projects:write | | Cria um rascunho de experimento de envio em um e-mail: nome, hipótese, métricas e até o número de variantes que o seu plano permite, divididas igualmente. Não envia nada. Você define o público, bloqueia e inicia no painel, pelo link que ela retorna. Experimentos de jornada são criados a partir de uma etapa de divisão. |
Nenhuma ferramenta bloqueia, inicia, decide ou implanta um experimento. Essas etapas continuam sendo suas, no painel.
Conta
| Ferramenta | Escopo | Notas |
|---|
get_plan_usage | nenhum — sempre disponível | Plano, cotas e o uso deste mês. Somente leitura, e não é um dado de conta sensível como projetos/contatos/mailbox, então fica disponível independentemente de quais escopos você concedeu. |
Três ferramentas anexam um widget interativo em hosts que oferecem suporte a MCP Apps (Claude — o Gemini não tem camada de widgets e sempre recebe o resultado em texto simples/JSON): preview_email (pré-visualização de e-mail ao vivo para desktop/celular), get_campaign_results (painel de resultados) e prepare_send (o cartão de confirmação de envio, cujo próprio botão Confirmar e enviar é o que de fato chama confirm_send).