Ferramentas MCP do Chatiops

Catálogo completo das 96 ferramentas do servidor MCP do Chatiops. Cada ferramenta pode ser chamada por qualquer agente de IA conectado — Claude, ChatGPT, Cursor, Windsurf, Cline ou Kiro. Para conectar, veja a página do MCP.

Esta página é gerada a partir do código do servidor. Se uma ferramenta existe aqui, ela existe em produção.
Áreas
Conexões · Tickets · Diagnóstico E Configuração · Filas · Contatos · Usuários · Base De Conhecimento · Campanhas · Tags · Onboarding · Agentes Ia · Base De Conhecimento Avançada · Mensagens · Chaves Api · Grupos · Relatórios · Empresa · Mensagens Rápidas · Métricas · Agendamentos

Conexões (20)

check_jid_type

Identifica o que é um número ou JID: contato comum, grupo, canal, bot ou a IA da Meta. Use antes de responder automaticamente, para não tratar bot como cliente.

jid string obrigatório — Número ou JID a classificar

create_connection

Cria nova conexão WhatsApp. Após criar, escaneie o QR Code no painel.

name string obrigatório — Nome da conexão (ex: Vendas, Suporte)

create_group

Cria um grupo de WhatsApp. Comece com poucos participantes e divulgue o link de convite — adicionar muita gente de uma vez pode fazer o WhatsApp bloquear o número.

subject string obrigatório — Nome do grupo
participants array — Números iniciais com DDI, ex: 5511999999999. Máx 10.
description string — Descrição do grupo (opcional)
connection_id number — ID da conexão (padrão: primeira conectada)

delete_connection

Remove uma conexão WhatsApp permanentemente.

connection_id number obrigatório

disconnect_connection

Desconecta/logout de uma conexão WhatsApp.

connection_id number obrigatório

get_community_info

Dados de uma Comunidade do WhatsApp: nome, descrição e grupos vinculados.

jid string obrigatório — JID da comunidade, ex: 1203...@g.us
connection_id number — ID da conexão (padrão: primeira conectada)

get_connection_status

Status detalhado da conexão (bateria, sessão, QR Code).

connection_id number obrigatório

get_group_daily_summary

Resumo do movimento nos grupos em um dia: quantas mensagens, quantos grupos ativos, quantas pessoas e quais grupos mais movimentados.

date string — Data YYYY-MM-DD (padrão: hoje)

get_group_invite_link

Devolve o link de convite de um grupo. Só funciona se a sua conexão for administradora do grupo.

group_jid string obrigatório — JID do grupo, ex: 1203...@g.us
connection_id number — ID da conexão (padrão: primeira conectada)

get_newsletter_info

Dados de um Canal (Newsletter) do WhatsApp: nome, descrição e número de seguidores. Aceite o JID (@newsletter) ou o código do convite.

jid string — JID do canal, ex: 1203...@newsletter
invite string — Código do convite, alternativa ao jid
connection_id number — ID da conexão (padrão: primeira conectada)

get_qrcode

Retorna o QR Code de uma conexão desconectada para escanear. Retorna texto do QR.

connection_id number obrigatório — ID da conexão

leave_group

Sai de um grupo de WhatsApp. A conexão deixa de receber mensagens dele.

group_jid string obrigatório — JID do grupo
connection_id number

list_connections

Lista conexões WhatsApp configuradas com status (CONNECTED/DISCONNECTED).

Sem parâmetros.

list_group_participants

Lista os participantes de um grupo com o identificador (LID) de cada um e quem é administrador. Use quando precisar saber quem está no grupo, não só quantos.

group_jid string obrigatório — JID do grupo, ex: 1203...@g.us
connection_id number — ID da conexão (padrão: primeira conectada)
limit number — Máx participantes a exibir (padrão 100)

list_groups

Lista grupos de WhatsApp da conexão.

connection_id number — ID da conexão (padrão: primeira conectada)

manage_group_participants

Adiciona, remove, promove ou rebaixa participantes de um grupo. Exige ser administrador.

group_jid string obrigatório
action string obrigatório — add, remove, promote ou demote
participants array obrigatório — Números com DDI, ou LIDs para remover/promover. Máx 10 por chamada.
connection_id number

restart_connection

Reinicia sessão WhatsApp (desconecta e reconecta).

connection_id number obrigatório

update_connection

Atualiza conexão: nome, mensagem de saudação, agente IA.

connection_id number obrigatório — ID da conexão
name string — Nome da conexão
greetingMessage string — Mensagem de boas-vindas
promptId number — ID do agente IA (null para desativar)

update_group_info

Altera nome e/ou descrição de um grupo. Exige ser administrador.

group_jid string obrigatório
subject string — Novo nome
description string — Nova descrição
connection_id number

update_group_settings

Define quem pode escrever no grupo e quem pode editar os dados. Exige ser administrador.

group_jid string obrigatório
who_can_send string — todos ou admins
who_can_edit string — todos ou admins
connection_id number

Tickets (14)

add_ticket_note

Adiciona nota interna em um ticket.

ticket_id number obrigatório — ID do ticket
note string obrigatório — Texto da nota

assign_ticket

Atribui ticket a um atendente.

ticket_id number obrigatório — ID do ticket
user_id number obrigatório — ID do usuário

close_ticket

Fecha um atendimento/ticket.

ticket_id number obrigatório — ID do ticket

get_conversation_summary

Resumo completo de uma conversa: cliente, status, ultimas mensagens, data.

ticket_id number obrigatório — ID do ticket
messages_limit number — Max mensagens (padrao 20)

get_daily_summary

Resumo do dia: quantas conversas novas, mensagens trocadas, tickets abertos/fechados, clientes atendidos. Use esta tool primeiro ao iniciar um atendimento.

date string — Data YYYY-MM-DD. Padrao: hoje.

get_ticket_messages

Busca histórico de mensagens de um ticket. Use para resumir conversas ou ver contexto.

ticket_id number obrigatório — ID do ticket
limit number — Máx mensagens (padrão 50)

get_unread_messages

Busca mensagens não lidas dos clientes. Filtre por ticket ou conexão.

ticket_id number — ID do ticket (opcional)
connection_id number — ID da conexão WhatsApp (opcional)
limit number — Máx mensagens (padrão 50)

list_recent_conversations

Lista TODAS as conversas da sua chave com as ultimas mensagens de cada uma. Filtre por data (date_from/date_to), status ou palavra-chave.

date_from string — Data inicio YYYY-MM-DD
date_to string — Data fim YYYY-MM-DD
status string — open, pending ou closed. Vazio = pending+open
search string — Busca por nome ou numero do contato
limit number — Max tickets (padrao 20)
messages_per_ticket number — Max mensagens por ticket (padrao 10)

list_ticket_notes

Lista notas internas de um ticket.

ticket_id number obrigatório — ID do ticket

list_tickets

Lista atendimentos/tickets. Filtre por status: open (em atendimento), pending (aguardando), closed (finalizados). Opcional: filtrar por conexão, usuário ou período (date_from/date_to).

status string (open | pending | closed)
connection_id number — ID da conexão WhatsApp (opcional)
user_id number — ID do usuário/atendente (opcional)
date_from string — Data início (YYYY-MM-DD). Filtra por data de criação do ticket.
date_to string — Data fim (YYYY-MM-DD)
limit number — Máx resultados (padrão 20)

list_unread_tickets

Lista tickets com mensagens não lidas (aguardando ou em andamento). Filtre por conexão.

connection_id number — ID da conexão WhatsApp (opcional)
limit number — Máx resultados (padrão 30)

reopen_ticket

Reabre um ticket fechado.

ticket_id number obrigatório — ID do ticket

search_messages

Busca mensagens por palavra-chave em TODAS as conversas da sua chave.

query string obrigatório — Palavra ou frase para buscar
date_from string — Data inicio YYYY-MM-DD
date_to string — Data fim YYYY-MM-DD
limit number — Max resultados (padrao 30)

transfer_ticket

Transfere ticket para outra fila ou usuário.

ticket_id number obrigatório — ID do ticket
queue_id number obrigatório — ID da fila destino
user_id number — ID do usuário destino (opcional)

Diagnóstico E Configuração (9)

configure_ai

Ativa/desativa/configura IA em fila ou conexão. Controla qual agente, modelo, chave usar.

target_type string (queue | connection) obrigatório — Onde ativar IA: queue (fila) ou connection (conexão)
target_id number obrigatório — ID da fila ou conexão
prompt_id number — ID do agente IA (null para desativar)
max_messages number — Máx mensagens de histórico (padrão 10)
model string — Modelo OpenAI (gpt-4o-mini, gpt-4o, etc)

configure_connection

Configura TODAS as opções da conexão: mensagens automáticas, tempos, IA, transferência. Use para configurar fluxo completo.

connection_id number obrigatório — ID da conexão
greeting_message string — Mensagem de saudação (use null pra limpar)
farewell_message string — Mensagem de despedida (use null pra limpar)
out_of_hours_message string — Mensagem fora do horário (use null pra limpar)
completion_message string — Mensagem de conclusão (use null pra limpar)
rating_message string — Mensagem de avaliação (use null pra limpar)
prompt_id number — ID do agente IA (null = desativar IA)
time_to_transfer number — Minutos sem resposta para transferir automaticamente (0 = desativado)
transfer_queue_id number — ID da fila destino para transferência automática
expires_ticket number — Minutos para expirar ticket fechado (0 = não expira)
expires_inactive_message string — Mensagem enviada antes de expirar ticket por inatividade

delete_api_key

Remove uma chave API cadastrada.

key_id number obrigatório

diagnose_ticket_flow

Diagnóstico completo do fluxo de atendimento. Mostra: por que tickets somem, tempos de expiração, regras de auto-close, filas sem atendente, conexões fora do ar. Use quando tickets estão desaparecendo ou com problemas.

Sem parâmetros.

get_connection_config

Mostra TODAS as configurações de uma conexão WhatsApp: mensagens (saudação, despedida, fora de hora, avaliação), timeouts (expiração, transferência automática, inatividade), IA vinculada, filas vinculadas.

connection_id number obrigatório — ID da conexão

get_ia_config_summary

Resumo completo de IA: quais filas/conexões tem IA ativa, quais agentes estão configurados, problemas encontrados (agente sem chave, fila sem agente, etc).

Sem parâmetros.

get_queue_config

Mostra configuração completa de uma fila: mensagens, horários de funcionamento, IA ativa, opções do chatbot, integrações.

queue_id number obrigatório — ID da fila

list_settings

Lista TODAS as configurações da empresa (settings).

Sem parâmetros.

update_setting

Altera uma configuração da empresa.

key string obrigatório — Chave da configuração
value string obrigatório — Novo valor

Filas (8)

create_queue

Cria fila de atendimento. Vincule a uma conexão depois.

name string obrigatório — Nome da fila (ex: Vendas, Suporte, Financeiro)
greetingMessage string — Mensagem de saudação quando cliente entra na fila
color string — Cor hex (ex: #682EE3). Padrão: branco

create_queue_option

Cria opção no menu chatbot da fila.

queue_id number obrigatório — ID da fila
title string obrigatório — Título da opção (ex: 1 - Vendas)
message string obrigatório — Mensagem de resposta automática
option string — Número ou letra da opção (ex: 1)

delete_queue

Remove uma fila de atendimento.

queue_id number obrigatório — ID da fila

delete_queue_option

Remove uma opção do menu chatbot.

option_id number obrigatório

list_queue_options

Lista opções do menu chatbot de uma fila.

queue_id number obrigatório — ID da fila

list_queues

Lista filas de atendimento com status da IA.

Sem parâmetros.

update_queue

Atualiza fila: nome, saudação, ativar/desativar IA (promptId).

queue_id number obrigatório — ID da fila
name string
greetingMessage string
promptId number — ID do agente IA (null para desativar)

update_queue_option

Atualiza uma opção do menu chatbot.

option_id number obrigatório
title string
message string
option string

Contatos (5)

create_contact

Cria novo contato manualmente.

name string obrigatório — Nome do contato
number string obrigatório — Número 5511999999999
email string — Email (opcional)

delete_contact

Remove um contato.

contact_id number obrigatório

get_contact

Detalhes completos de um contato.

contact_id number obrigatório

search_contacts

Busca contatos por nome ou número de telefone.

search string obrigatório — Nome ou número
limit number

update_contact

Atualiza dados de um contato.

contact_id number obrigatório
name string
number string
email string

Usuários (5)

create_user

Cria novo usuário (admin ou atendente).

name string obrigatório — Nome do usuário
email string obrigatório — Email de login
password string obrigatório — Senha (mín 6 caracteres)
profile string (admin | user) obrigatório — admin=administrador, user=atendente

delete_user

Remove um usuário da empresa.

user_id number obrigatório

get_user

Detalhes de um usuário específico.

user_id number obrigatório

list_users

Lista usuários/atendentes da empresa.

Sem parâmetros.

update_user

Atualiza dados de um usuário.

user_id number obrigatório
name string
email string
password string
profile string (admin | user)

Base De Conhecimento (4)

create_knowledge_base

Cria base de conhecimento. O conteúdo é usado pela IA para responder com precisão.

name string obrigatório — Nome da base (ex: FAQ, Produtos, Preços)
content string obrigatório — Conteúdo em texto/markdown

delete_knowledge_base

Remove uma base de conhecimento.

kb_id number obrigatório

list_knowledge_bases

Lista bases de conhecimento disponíveis.

Sem parâmetros.

update_knowledge_base

Atualiza conteúdo de uma base de conhecimento.

kb_id number obrigatório
name string
content string

Campanhas (4)

cancel_campaign

Cancela campanha em andamento.

campaign_id number obrigatório

create_campaign

Cria campanha de disparo em massa.

name string obrigatório — Nome da campanha
message1 string obrigatório — Mensagem principal
contact_list_id number obrigatório — ID da lista de contatos
connection_id number — ID da conexão WhatsApp (padrão: primeira conectada)

list_campaigns

Lista campanhas de disparo em massa.

Sem parâmetros.

start_campaign

Inicia/envia uma campanha.

campaign_id number obrigatório

Tags (4)

create_tag

Cria nova tag.

name string obrigatório — Nome da tag
color string obrigatório — Cor hex (ex: #FF0000)

delete_tag

Remove uma tag.

tag_id number obrigatório

list_tags

Lista tags/etiquetas disponíveis.

Sem parâmetros.

update_tag

Atualiza uma tag.

tag_id number obrigatório
name string
color string

Onboarding (3)

create_account

Cria conta no Chatiops (plano Starter gratuito, 7 dias trial). Retorna token MCP para usar nas demais tools.

email string obrigatório — Email do usuário
name string obrigatório — Nome da empresa
password string obrigatório — Senha (mín 6 caracteres)

debug_queues

Diagnóstico: mostra filas e opções de uma empresa.

email string obrigatório — Email da empresa

login_account

Autentica email existente e retorna token MCP para usar nas demais tools.

email string obrigatório — Email cadastrado
password string obrigatório — Senha

Agentes Ia (3)

create_agent

Cria agente de IA. Configure prompt, modelo e chave OpenAI.

name string obrigatório — Nome do agente
prompt string obrigatório — Instruções do agente (system prompt)
model string (gpt-4o-mini | gpt-4o | gpt-4.1 | o4-mini) — Modelo OpenAI (padrão: gpt-4o-mini)
apiKey string obrigatório — Chave OpenAI (sk-...) ou ID da chave cadastrada
maxTokens number — Máx tokens resposta (padrão 500)

list_agents

Lista agentes de IA configurados.

Sem parâmetros.

update_agent

Atualiza agente de IA: prompt, modelo, chave, base de conhecimento.

agent_id number obrigatório
name string
prompt string
model string
apiKey string
maxTokens number
knowledgeBaseIds array — IDs das bases de conhecimento

Base De Conhecimento Avançada (3)

get_agent_knowledge

Mostra quais bases de conhecimento estão vinculadas a um agente IA.

agent_id number obrigatório — ID do agente

link_knowledge_base

Vincula base de conhecimento a um agente IA. O agente usará esse conteúdo nas respostas.

kb_id number obrigatório — ID da base de conhecimento
agent_id number obrigatório — ID do agente IA

unlink_knowledge_base

Desvincula base de conhecimento de um agente IA.

kb_id number obrigatório — ID da base
agent_id number obrigatório — ID do agente

Mensagens (2)

reply_ticket

Responde em um ticket/atendimento existente. Mensagem vai pro WhatsApp do cliente.

ticket_id number obrigatório — ID do ticket
body string obrigatório — Texto da resposta

send_whatsapp

Envia mensagem WhatsApp para um número. Use para mandar zap, notificar cliente.

number string obrigatório — Número formato 5511999999999
body string obrigatório — Texto da mensagem
imageUrl string — URL de imagem para enviar junto (opcional)
priority string (baixa | media | alta) — baixa=1.5s, media=0.5s, alta=sem delay

Chaves Api (2)

create_api_key

Cadastra chave OpenAI para uso nos agentes.

name string obrigatório — Nome identificador (ex: Principal, Backup)
key string obrigatório — Chave OpenAI (sk-...)

list_api_keys

Lista chaves OpenAI cadastradas.

Sem parâmetros.

Grupos (2)

list_group_messages

Lê mensagens recentes de um grupo WhatsApp.

group_jid string obrigatório — JID do grupo (ex: 5511999999999-123456@g.us). Use list_groups para descobrir.
limit number — Máx mensagens (padrão 30)

send_group_message

Envia mensagem para um grupo WhatsApp.

group_jid string obrigatório — JID do grupo. Use list_groups para descobrir.
body string obrigatório — Texto da mensagem

Relatórios (2)

get_dashboard

Dashboard completo: tickets por fila, por usuário, evolução diária.

Sem parâmetros.

get_reports

Relatório avançado de tickets com filtros por período, fila, usuário, status.

date_from string — Data início (YYYY-MM-DD)
date_to string — Data fim (YYYY-MM-DD)
user_id number
queue_id number
status string (open | pending | closed)

Empresa (2)

get_company

Dados da empresa: plano, vencimento, limites.

Sem parâmetros.

update_company

Atualiza dados da empresa.

name string
phone string
email string

Mensagens Rápidas (2)

create_quick_message

Cria resposta rápida.

shortcode string obrigatório — Atalho (ex: /boasvindas)
message string obrigatório — Texto da resposta

list_quick_messages

Lista respostas rápidas/templates.

Sem parâmetros.

Métricas (1)

get_metrics

Métricas do dia: tickets abertos, pendentes, fechados hoje, total de mensagens.

Sem parâmetros.

Agendamentos (1)

list_appointment_bookings

Lista agendamentos. Opcional: filtrar por data.

date string — Data (YYYY-MM-DD). Vazio = próximos 7 dias.

Chatiops é um produto da Tiops Tecnologia LTDA · chatiops.com · Dúvidas: (11) 94724-3306