Ferramentas

As 22 ferramentas do MCP organizadas por categoria. ✅ marca parâmetros obrigatórios.

Assistentes

Ferramenta	Descrição	Parâmetros principais
`list_assistants`	Lista todos os assistentes da conta	`page`, `perPage`, `name`
`get_assistant`	Retorna configuração completa de um assistente	`id` ✅
`create_assistant`	Cria um novo assistente	`name` ✅, `prompt`, `language`, `temperature`, `maxTokens`, `restrictedByContext`
`update_assistant`	Atualiza campos de um assistente existente (apenas os campos enviados são alterados)	`id` ✅, `name`, `prompt`, `isActive`, `language`, `temperature`, `maxTokens`, `restrictedByContext`

Valores válidos para language: brazil-portuguese · english · any

temperature: entre 0.0 e 2.0 (recomendado 0.3–0.8 para atendimento). maxTokens: limite máximo de tokens por resposta: 0 ou omitido usa o default do modelo. restrictedByContext: quando true, o assistente só responde com base nos arquivos da base de conhecimento. isActive: desativa o assistente sem apagar nada.

Gatilhos

Ferramenta	Descrição	Parâmetros principais
`list_triggers`	Lista gatilhos de um assistente	`assistantId` ✅, `page`, `perPage`
`get_trigger`	Retorna definição completa de um gatilho	`assistantId` ✅, `triggerId` ✅
`create_trigger`	Cria um gatilho de function calling	`assistantId` ✅, `name` ✅, `description` ✅, `parametersJson`, `isActive`, `interpretResponse`, `copilotOnly`
`update_trigger`	Atualiza um gatilho existente (merge automático com o estado atual)	`assistantId` ✅, `triggerId` ✅, `name`, `description`, `parametersJson`, `isActive`, `interpretResponse`, `copilotOnly`
`delete_trigger`	Remove o gatilho e todas as suas ações (irreversível)	`assistantId` ✅, `triggerId` ✅

name deve estar em camelCase (ex.: searchOrder). description tem máx 350 chars e deve explicar exatamente quando o LLM deve chamar a função.

parametersJson é um JSON Schema serializado como string descrevendo os argumentos que o LLM deve coletar antes de chamar o gatilho. Tipos suportados: string, number, boolean, array (com items). Toda propriedade precisa de description (máx 200 chars).

interpretResponse: true faz o LLM transformar a resposta em linguagem natural; false repassa a resposta crua. copilotOnly: true deixa o gatilho disponível apenas no modo copiloto.

Ações

Ferramenta	Descrição	Parâmetros principais
`list_actions`	Lista ações de um gatilho	`assistantId` ✅, `triggerId` ✅, `page`, `perPage`
`get_action`	Retorna configuração de uma ação	`assistantId` ✅, `triggerId` ✅, `actionId` ✅
`create_action`	Cria uma ação dentro de um gatilho	`assistantId` ✅, `triggerId` ✅, `type` ✅, `actionJson`
`update_action`	Substitui a configuração de uma ação	`assistantId` ✅, `triggerId` ✅, `actionId` ✅, `type` ✅, `actionJson`
`delete_action`	Remove uma ação do gatilho (irreversível)	`assistantId` ✅, `triggerId` ✅, `actionId` ✅

Tipos de ação disponíveis (type):

Tipo	Descrição
`WEBHOOK`	Requisição HTTP customizada (GET/POST/PUT/DELETE com headers e body)
`NATIVE`	Mensagens nativas do WhatsApp: texto, botões, lista, imagem, áudio, arquivo, áudio gerado por IA, transferência de assistente
`CRM`	Upsert de contato no CRM nativo da Verboo
`GOOGLE_CALENDAR`	Verificar disponibilidade, listar eventos, agendar reuniões
`META_ADS`	Evento de conversão para o Pixel da Meta (Purchase, LeadSubmitted, etc.)
`FEEGOW`	Pacientes, agendamentos, profissionais, especialidades, convênios
`CHAT_INTEGRATION`	Mudar status da conversa ou gerar resumo no painel
`KNOWLEDGE`	Busca semântica na base de conhecimento do assistente
`Z_API`	Z-API WhatsApp: aplicar tag, resetar sessão
`MY_ZAP`	MyZap WhatsApp: tag, reset, enviar arquivo/imagem, mensagem para si
`EVOLUTION`	Evolution API WhatsApp: tag, reset, enviar arquivo/imagem, marcar como não lida
`CATALOG_INTEGRATION`	Buscar produtos, gerenciar carrinho (search, get/add/remove cart)

actionJson é uma string JSON com a configuração específica do tipo. Para referenciar parâmetros do gatilho dentro de uma ação, use o nome do parâmetro como string simples (sem chaves, sem {{ }}). O runtime substitui pelos valores coletados pelo LLM. Exceções: o body do WEBHOOK e os texts/baseText de NATIVE são conteúdo literal.

Sessões (testar agentes end-to-end)

Ferramenta	Descrição	Parâmetros principais
`create_session`	Cria uma nova sessão de conversa com um assistente. Retorna o `sessionId` para os próximos passos	`assistant_id` ✅
`get_session`	Retorna o estado completo de uma sessão, incluindo todas as mensagens trocadas	`session` ✅
`send_message`	Envia uma mensagem do usuário para uma sessão e retorna a resposta do assistente	`session` ✅, `message` ✅
`delete_message`	Remove uma mensagem específica do histórico para reaproveitar a sessão em outro caminho de teste	`session` ✅, `message_index` ✅

Use essas tools para validar prompt, gatilhos, ações e base de conhecimento sem precisar conectar um WhatsApp real. O fluxo típico é: create_session → send_message (várias vezes simulando o usuário) → get_session para conferir o histórico completo.

Histórico e Analytics

Ferramenta	Descrição	Parâmetros principais
`list_generative_messages`	Lista mensagens individuais de conversas (conteúdo, role, tokens, timestamps)	`assistantId`, `sessionId`, `page`, `perPage`
`list_generative_sessions`	Lista sessões únicas com contagem de mensagens e timestamps	`assistantId`, `page`, `perPage`
`get_generative_message_graph`	Série temporal diária de volume de mensagens	`assistantId`, `range` (1–365 dias, default 7)
`list_assistants_usage`	Mensagens por assistente no mês corrente, ordenado do maior para o menor	:

Quer ver tudo isso em ação? Veja 3 conversas reais → mostrando como o Claude encadeia essas tools de ponta a ponta.