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 | | A árvore de blocos e o tema 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. | | add_block / update_block / move_block | projects:write | | Edições na árvore, validadas por canPlace/campo da mesma forma que as edições do copiloto do estúdio. | | remove_block | projects:write | ✓ | Exclui um bloco e seus filhos. | | set_theme | projects:write | | Cores de marca, fonte, raio do botão. | | 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. |

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 e totais de supressão — nenhum dado individual de contato. | | find_contacts | contacts:read | | Consulta limitada (≤25 linhas, paginada por cursor). 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_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. 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. |

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. |

Widgets

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).