Skip to main content

​
Visão geral

O servidor MCP morada-platform expõe 13 ferramentas organizadas por domínio. A primeira chamada de qualquer fluxo deve ser list_workspaces para descobrir o workspaceId usado pelas demais.
DomínioFerramentasEscopo
Workspaceslist_workspaces—
Conversaslist_conversations, get_conversation, list_conversation_messagesconversations:view
Dealslist_deals, get_dealdeals:view
Agenteslist_agents, get_agentinstances:view
Integraçõeslist_integrations, get_integrationintegrations:view
Analyticsget_analyticsdashboard:view
Mensagenssend_active_messagetalk:edit
Templateslist_message_templates, create_message_templatemessage-templates:view / message-templates:edit

​
Workspaces

​
list_workspaces

Lista todos os workspaces (partners) aos quais o usuário autenticado tem acesso. Primeiro passo de qualquer fluxo — o id retornado aqui é usado como workspaceId em todas as outras tools. Retorno: array de workspaces com id, name e role.

​
Conversas

​
list_conversations

Lista conversas de um workspace com filtros opcionais por status, intervalo de datas, agente, tags ou busca por pessoa. Resultado paginado. Parâmetros principais: workspaceId, status, dateFrom, dateTo, agentId, tags, search, limit, offset.

​
get_conversation

Retorna os detalhes completos de uma conversa específica: pessoa, agente atribuído, tags, status e timestamps. Parâmetros: workspaceId, conversationId.

​
list_conversation_messages

Lista as mensagens de uma conversa com sanitização automática (imagens são marcadas, mensagens longas são truncadas em 2000 caracteres). Parâmetros: workspaceId, conversationId, limit, offset.

​
Deals

​
list_deals

Lista deals de um workspace com filtros por status (open, won, lost, closed), data de criação e busca por nome ou telefone da pessoa. Parâmetros: workspaceId, status, dateFrom, dateTo, search, limit, offset.

​
get_deal

Retorna o contexto completo de um deal: pessoa, produtos, logs de etapas, rastreio de origem e usuário responsável. Parâmetros: workspaceId, dealId.

​
Agentes (Mia)

​
list_agents

Lista todos os agentes (bots/instâncias) de um workspace. Retorna id, name, type e partnerId. Parâmetros: workspaceId.

​
get_agent

Retorna a configuração de um agente: tipo, instruções e demais propriedades. Use o parâmetro fields para pedir o valor completo de chaves específicas. Parâmetros: workspaceId, agentId, fields (opcional).

​
Integrações

​
list_integrations

Lista todas as integrações (partner connections) configuradas em um workspace. Retorna id, connectorCode, active e metadados do conector. Parâmetros: workspaceId.

​
get_integration

Retorna detalhes de uma integração específica: conector, status ativo e propriedades de configuração. Parâmetros: workspaceId, integrationId.

​
Analytics

​
get_analytics

Retorna KPIs do dashboard para um workspace em um intervalo de datas: volume de conversas, métricas de funil, tempos de resposta e indicadores de atividade de agentes. Parâmetros: workspaceId, from (ISO), to (ISO), timezone (opcional, ex.: America/Sao_Paulo).

​
Mensagens

​
send_active_message

Envia uma mensagem ativa (outbound) no WhatsApp usando um template aprovado pela Meta, via um agente com canal WhatsApp ativo. Cria ou retoma uma conversa com o destinatário.
Operação de escrita que envia uma mensagem real. O assistente deve confirmar telefone, template e variáveis antes de executar.
Parâmetros: workspaceId, agentId, templateName, phoneNumber, recipientName (opcional), email (opcional), replacements (opcional). Retorno: success e conversationId.

​
Templates de mensagem

​
list_message_templates

Lista os templates do WhatsApp disponíveis para um agente, consultando a Meta Graph API. Retorna nome, status (APPROVED, PENDING, etc.), idioma, categoria e componentes. Parâmetros: workspaceId, agentId, name (filtro opcional).

​
create_message_template

Cria um novo template de mensagem na conta do WhatsApp Business via Meta Graph API.
Operação de escrita. O template entra em revisão da Meta antes de poder ser usado.
Parâmetros: workspaceId, agentId, payload de template no formato esperado pela Meta.

​
Fluxos recomendados

​
Investigar uma conversa

list_workspaces
  → list_conversations (com filtros)
    → get_conversation (id específico)
      → list_conversation_messages

​
Mapear agentes

list_workspaces
  → list_agents
    → get_agent (informações básicas)

​
Disparar uma mensagem ativa

list_workspaces
  → list_agents (escolher agente com Meta)
    → list_message_templates (escolher template APPROVED)
      → send_active_message
        → get_conversation (acompanhar)

​
Relatório de período

list_workspaces
  → get_analytics (from / to)
    → list_deals (status=won, dateFrom, dateTo) para drill-down

​
Boas práticas

Use as ferramentas list_* para descobrir IDs antes de chamar get_*. Isso evita tentativa-e-erro e mantém consistência entre chamadas.
Para send_active_message e create_message_template, sempre apresente ao usuário o que será enviado antes de executar.
Uma vez descoberto, reutilize o mesmo workspaceId em chamadas subsequentes para evitar trocas de contexto.
Em listas grandes (conversas, deals), use os filtros de data, status e busca para reduzir o payload retornado.