MCPサーバー

kontato

ai.kontato/kontato
コミュニケーション 公開・接続可能 MCP 2025-11-25

このMCPでできること

Enables AI agents to send and receive messages through a WhatsApp number.

cancel_schedule
Cancel a schedule
Cancela uma entrega agendada pelo seu schedule_id (obtido em `list_schedules` ou `schedule`).
破壊的操作あり 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['schedule_id'], 'properties': {'owner_phone': {'type': 'string', 'description': 'Numero do dono (so digitos, como texto ou numero). Passe para reativar a conta se a sessao MCP for nova (clientes stateless).'}, 'schedule_id': {'type': 'string', 'description': 'ID do schedule a cancelar.'}}}
list_messages
List message history
Lista o historico de mensagens do numero-ponte (recebidas e enviadas), mais recentes primeiro. Use para decidir a quem responder com `reply`.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximo de mensagens (1 a 100).'}, 'since': {'type': 'string', 'description': 'Timestamp ISO 8601; retorna apenas mensagens posteriores.'}, 'owner_phone': {'type': 'string', 'description': 'Numero do dono (so digitos, como texto ou numero). Passe para reativar a conta se a sessao MCP for nova (clientes stateless).'}}}
list_schedules
List schedules
Lista as entregas agendadas (recorrentes/unicas) desta conta, com proximo disparo.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner_phone': {'type': 'string', 'description': 'Numero do dono (so digitos, como texto ou numero). Passe para reativar a conta se a sessao MCP for nova (clientes stateless).'}}}
provision
Activate Kontato account (create or reuse)
ATIVA a conta Kontato do telefone informado — cria apenas se ainda nao existir; se ja existe, reutiliza a MESMA conta (e normal e esperado chamar com conta existente: funciona como login). IDEMPOTENTE POR TELEFONE: se ja existe conta para o owner_phone, devolve a MESMA conta — entao e seguro chamar de novo em qualquer sessao ou depois de um restart (o usuario nunca precisa lidar com api_key). Se a resposta vier com verification_required=false (numero ja verificado antes), NAO peca OTP: chame `send` direto. Informe owner_phone (formato internacional so digitos, ex: 5511999998888) para habilitar o caso seguro de self-notification: o agente entrega no WhatsApp do proprio dono. Retorna o whatsapp_bridge_number (numero generico do Kontato que envia, nunca o numero pessoal do dono).
外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'email': {'type': 'string', 'description': 'E-mail do dono (opcional).'}, 'owner_phone': {'type': 'string', 'description': 'Numero WhatsApp do dono, so digitos, como texto ou numero (ex: 5511999998888). Vira o destino default das self-notifications.'}}}
reply
Reply to a WhatsApp contact
Responde a um numero especifico que mandou mensagem para o numero-ponte. Igual a `send`, mas "to" e OBRIGATORIO. Responder a quem te escreveu (reply-ratio alto) e mais seguro que cold outbound.
外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['to', 'message'], 'properties': {'to': {'type': 'string', 'description': 'Destino so com digitos, como texto ou numero (ex: 5511999998888).'}, 'message': {'type': 'string', 'description': 'Texto da resposta.'}, 'owner_phone': {'type': 'string', 'description': 'Numero do dono (so digitos, como texto ou numero). Passe para reativar a conta se a sessao MCP for nova (clientes stateless).'}}}
schedule
Schedule a recurring delivery
Registra uma entrega recorrente ou unica no scheduler do Kontato. No horario, o Kontato roda o `prompt` como um agente completo (com web/Exa) e entrega no WhatsApp do dono. USE ISTO para "todo dia me manda X": voce nao precisa ficar online nem prometer trabalho futuro — o scheduler dispara sozinho. O `prompt` deve ser autossuficiente (ex: "Busque as principais noticias do mercado financeiro de hoje e entregue um resumo curto").
外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prompt', 'schedule_type', 'schedule_value'], 'properties': {'prompt': {'type': 'string', 'description': 'O que entregar quando disparar. Autossuficiente.'}, 'owner_phone': {'type': 'string', 'description': 'Numero do dono (so digitos, como texto ou numero). Passe para reativar a conta se a sessao MCP for nova (clientes stateless).'}, 'schedule_type': {'enum': ['cron', 'interval', 'once'], 'type': 'string', 'description': 'cron=recorrente em horarios; interval=a cada N ms; once=uma vez.'}, 'schedule_value': {'type': 'string', 'description': 'cron: "0 8 * * *" (todo dia 8h, fuso BRT) | interval: ms como "3600000" | once: horario local "2026-06-20T15:30:00" (sem Z).'}}}
send
Send WhatsApp message
Envia uma mensagem de WhatsApp pelo numero-ponte do Kontato. CASO SEGURO: se OMITIR "to", entrega no WhatsApp do PROPRIO DONO (self-notification). JANELA DE 24H: e resolvida AUTOMATICAMENTE pelo servidor — mande so "message"; se a janela do WhatsApp estiver fechada, o Kontato embrulha o texto num template aprovado e entrega mesmo assim (a resposta volta com via="template"). NAO pergunte ao dono sobre janela nem sobre template; nunca peca para ele "mandar oi" antes. REGRA TURN-BASED: voce nao executa trabalho no futuro; se pedirem algo recorrente ("todo dia me manda X"), faca a entrega de HOJE agora e oriente a registrar um schedule, nunca prometa entrega futura.
外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Destino so com digitos, como texto ou numero. OMITA para enviar ao proprio dono (recomendado).'}, 'message': {'type': 'string', 'description': 'Texto da mensagem (obrigatorio quando NAO usar template).'}, 'owner_phone': {'type': 'string', 'description': 'Numero do DONO da conta (so digitos, como texto ou numero). Passe SEMPRE que souber: reativa a conta automaticamente quando a sessao MCP e nova (clientes stateless como o conector do claude.ai).'}, 'template_name': {'type': 'string', 'description': 'AVANCADO, normalmente DESNECESSARIO: a janela de 24h ja e tratada sozinha pelo servidor. Use apenas para escolher um template especifico. Templates disponiveis (nome, variaveis em ordem): kontato_aviso (1 variável: texto da notificação) â\x80\x94 Notificação genérica do agente para o dono. Ã\x89 o template usado AUTOMATICAMENTE pela API quando a janela de 24h está fechada.; kontato_lembrete (1 variável: texto do lembrete) â\x80\x94 Lembrete que o dono programou com o agente.; kontato_ativacao (2 variáveis: nome do destinatário, nome do agente ou da empresa) â\x80\x94 Primeiro contato com um destinatário NOVO (traz botões "Ativar recebimento" / "Não quero receber")..'}, 'template_variables': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Variaveis posicionais do template ({{1}}, {{2}}...), em ordem.'}}}
status
Account status & schedules
Mostra o estado da conta Kontato: ativa ou nao, numero-ponte, e os schedules (rotinas) ja registrados. Use para honrar a regra turn-based: antes de dizer que algo sera entregue "todo dia", confirme aqui se existe um schedule ativo.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner_phone': {'type': 'string', 'description': 'Numero do dono (so digitos, como texto ou numero). Passe para reativar a conta se a sessao MCP for nova (clientes stateless).'}}}
verify_number
Verify owner number (OTP)
Confirma o numero do dono com o codigo OTP de 6 digitos que chegou no WhatsApp dele apos o `provision`. OBRIGATORIO antes de enviar/agendar: ate verificar, `send`/`reply`/`schedule` retornam 403 owner_not_verified. Se o codigo expirou ou errou demais, chame de novo apos pedir um novo (resend) ao operador.
外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'Codigo de 6 digitos recebido no WhatsApp do dono (texto ou numero).'}, 'owner_phone': {'type': 'string', 'description': 'Numero do dono (so digitos, como texto ou numero). Passe para reativar a conta se a sessao MCP for nova (clientes stateless).'}}}
追加
status
2026年9月17日7:57
追加
list_messages
2026年9月17日7:57
追加
reply
2026年9月17日7:57
追加
send
2026年9月17日7:57
追加
cancel_schedule
2026年9月17日7:57
追加
list_schedules
2026年9月17日7:57
追加
schedule
2026年9月17日7:57
追加
verify_number
2026年9月17日7:57
追加
provision
2026年9月17日7:57