MisarMail MCP Server

Envie e-mails transacionais, execute campanhas e automações, gerencie contatos e audite a entregabilidade — 54 ferramentas anotadas.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP MisarMail

Envie e-mails, execute campanhas, gerencie contatos e automações, faça testes A/B e audite a entregabilidade — a partir de qualquer assistente de IA.

54 ferramentas · 8 prompts · 4 recursos · 8 habilidades de agente

Funciona com Claude (Desktop, Code e web), Cursor, VS Code, Windsurf, Cline, Zed, Gemini CLI, ChatGPT e qualquer outro cliente compatível com MCP — via stdio ou Streamable HTTP.

Instalação

Smithery (recomendado)

npx -y @smithery/cli install misar/misarmail-mcp --client claude

Claude Code

claude mcp add misarmail -- npx -y @misarmail/mcp@latest

Manual (qualquer cliente)

{
  "mcpServers": {
    "misarmail": {
      "command": "npx",
      "args": ["-y", "@misarmail/mcp@latest"],
      "env": { "MISARMAIL_API_KEY": "msk_your_key_here" }
    }
  }
}

Configurações prontas para cada cliente estão em connectors/.

Remoto (sem instalação)

{
  "mcpServers": {
    "misarmail": {
      "type": "streamable-http",
      "url": "https://api.misar.io/mail/mcp",
      "headers": { "Authorization": "Bearer msk_your_key_here" }
    }
  }
}

Autenticação

Duas opções — sem necessidade de copiar e colar na primeira:

Login pelo navegador. Inicie o servidor sem chave e execute a ferramenta login. Ela abre a tela de consentimento da MisarMail, você revisa as permissões solicitadas e a chave é entregue diretamente e salva em ~/.misarmail/config.json.
Chave de API. Crie uma em https://mail.misar.io/developers e defina MISARMAIL_API_KEY.

Instâncias auto-hospedadas: defina MISARMAIL_BASE_URL.

Ferramentas

Ferramenta	Descrição
`send_email`	Envie um e-mail transacional de uma conta MisarMail verificada.
`list_emails`	Liste e-mails de uma pasta da caixa de entrada com pesquisa de texto completo opcional em assunto e corpo.
`get_email`	Leia o conteúdo completo de um único e-mail por ID, incluindo cabeçalhos, corpo e metadados de anexos.
`reply_to_email`	Responda a uma conversa de e-mail existente.
`archive_email`	Mova um e-mail para a pasta de arquivo.
`validate_email`	Valide um endereço de e-mail antes do envio: sintaxe, registros MX, detecção de domínios descartáveis e contas de função.
`list_campaigns`	Liste campanhas de e-mail marketing com status, tamanho do público e métricas principais.
`get_campaign`	Obtenha detalhes completos de uma campanha: conteúdo, segmento de público, agendamento e estatísticas de entrega (enviados, abertos, clicados, rejeitados, reclamados)..
`create_campaign`	Crie uma nova campanha de e-mail marketing como rascunho.
`send_campaign`	Envie uma campanha agora ou agende-a para um horário futuro passando scheduled_at.
`list_contacts`	Liste contatos com status de inscrição e métricas de engajamento.
`create_contact`	Adicione um único contato.
`update_contact`	Atualize um contato existente por endereço de e-mail, incluindo alteração do status de inscrição.
`import_contacts`	Importe em massa até 5.000 contatos em uma única chamada.
`get_contact_score`	Obtenha pontuação de engajamento, nível de engajamento e risco de churn para um contato — ou os contatos de menor engajamento da lista quando contact_id for omitido.
`list_templates`	Liste modelos de e-mail salvos com seus placeholders de variáveis, para que você possa escolher um para uma campanha ou envio transacional..
`create_template`	Crie um modelo de e-mail reutilizável.
`render_template`	Renderize um modelo com variáveis de exemplo e retorne o HTML e o assunto resultantes.
`list_automations`	Liste fluxos de automação (séries de boas-vindas, reengajamento, sequências de gotejamento) com tipo de gatilho e estado ativo..
`get_automation`	Obtenha um fluxo de automação completo: gatilho, cada etapa com seu atraso e estatísticas de conclusão por etapa..
`create_automation`	Crie um fluxo de automação a partir de um gatilho e uma lista ordenada de etapas.
`toggle_automation`	Ative ou pause uma automação.
`list_ab_tests`	Liste testes A/B com resultados por variante e se um vencedor já foi selecionado..
`create_ab_test`	Crie um teste A/B em uma campanha com duas ou mais variantes.
`select_ab_test_winner`	Selecione a variante vencedora e envie-a para o público restante.
`get_analytics`	Obtenha análises de entrega e engajamento — enviados, entregues, abertos, clicados, rejeitados e reclamados — para a conta ou uma campanha, agrupados por dia/semana/mês..
`generate_report`	Gere um relatório analítico estruturado em um intervalo de datas.
`get_revenue_attribution`	Atribua receita de e-commerce ao e-mail — receita por campanha, por contato e valor médio do pedido a partir de conversões rastreadas..
`get_monetization_stats`	Obtenha estatísticas de monetização de newsletter: assinantes pagos, MRR, churn e receita de patrocínio no período..
`get_deliverability_score`	Obtenha a pontuação de entregabilidade da conta (0–100) e a nota em letras (A–F) com os fatores que a estão reduzindo.
`run_deliverability_audit`	Execute uma auditoria completa de entregabilidade em autenticação (SPF/DKIM/DMARC), reputação de domínio, higiene de lista, sinais de conteúdo e status de blocklist.
`get_warmup_status`	Obtenha o progresso de aquecimento de IP/domínio e a capacidade de envio restante de hoje.
`check_dmarc`	Verifique registros DNS SPF, DKIM e DMARC ao vivo para um domínio e relate problemas de alinhamento com o registro exato a publicar.
`list_domains`	Liste domínios de envio com status de verificação e seus registros DKIM/SPF/DMARC.
`add_domain`	Adicione um domínio de envio e retorne os registros DNS a publicar.
`verify_domain`	Verifique novamente os registros DNS de um domínio e marque-o como verificado se eles resolverem.
`configure_inbound_domain`	Configure o roteamento de e-mail de entrada para um subdomínio para que as respostas cheguem à caixa de entrada unificada da MisarMail.
`list_forms`	Liste formulários de inscrição com status de incorporação e contagens de conversão..
`get_form`	Obtenha um formulário de inscrição incluindo campos, código de incorporação e comportamento de redirecionamento..
`get_form_submissions`	Liste envios de um formulário de inscrição, incluindo valores de campos enviados e carimbos de data/hora..
`create_landing_page`	Crie uma página de destino hospedada com um formulário de captura de e-mail.
`list_marketplace_items`	Navegue pelo marketplace de modelos da MisarMail para modelos prontos de e-mail e automação..
`get_marketplace_item`	Obtenha um item do marketplace com visualização completa, autor e contagem de instalações..
`list_inbox_conversations`	Liste conversas da caixa de entrada unificada (threads) com status e intenção detectada.
`get_inbox_conversation_messages`	Obtenha todas as mensagens de uma conversa da caixa de entrada, da mais antiga para a mais recente, com remetente e carimbos de data/hora..
`categorize_inbox_emails`	Execute categorização por IA em um lote de e-mails da caixa de entrada para rotular intenção e prioridade.
`list_api_keys`	Liste chaves de API da conta com escopos e último uso.
`generate_subject_lines`	Gere variantes de linha de assunto por IA para um tópico de campanha, opcionalmente ajustadas a um tom e público.
`list_integrations`	Liste integrações de terceiros conectadas e seu status de sincronização..
`get_integration`	Obtenha configuração, escopos e último resultado de sincronização de uma integração..
`toggle_integration`	Ative ou desative uma integração.
`list_sandbox_sends`	Liste e-mails capturados pelo modo sandbox.
`clear_sandbox`	Exclua todos os e-mails capturados no sandbox.
`upgrade`	Mostre o plano MisarMail atual, quanto de cada cota resta e o que o upgrade desbloqueia.

Prompts

Fluxos de trabalho reutilizáveis que seu cliente expõe como comandos de barra.

Prompt	Descrição
`compose_email`	Redija um e-mail profissional e envie-o via MisarMail após confirmação.
`campaign_performance_report`	Analise o desempenho da campanha e produza melhorias priorizadas.
`contact_import_guide`	Importe e organize contatos com segurança, com verificações de consentimento e higiene.
`automation_builder_guide`	Projete e construa um fluxo de automação de e-mail passo a passo.
`deliverability_improvement_plan`	Diagnostique a entregabilidade e produza um plano de ação semanal priorizado.
`ab_test_plan`	Projete um teste A/B estatisticamente significativo para uma campanha.
`list_hygiene_audit`	Encontre e limpe os contatos que estão prejudicando a reputação do remetente.
`weekly_email_report`	Produza um resumo semanal de desempenho de e-mail pronto para as partes interessadas.

Recursos

Contexto somente leitura que um agente pode anexar sem gastar uma chamada de ferramenta.

URI	Descrição
`misarmail://account/domains`	Seus domínios de envio com estado de verificação e registros DNS.
`misarmail://account/deliverability`	Pontuação atual de entregabilidade da conta (0–100), nota e fatores contribuintes..
`misarmail://account/warmup`	Estágio de aquecimento de IP/domínio e capacidade de envio restante para hoje — o teto que um envio em massa deve respeitar..
`misarmail://templates`	Modelos salvos com suas variáveis declaradas, para reutilização em campanhas e envios..

Habilidades de agente

Incluídas em skills/ — orientação que um agente carrega quando uma tarefa corresponde.

Habilidade	Use quando
`ab-test-campaign`	Projetar e executar um teste A/B em uma campanha MisarMail — linha de assunto, conteúdo, nome do remetente ou horário de envio. Use para "teste A/B", "teste dividido", "qual assunto funciona melhor" ou testar variantes de e-mail.
`audit-deliverability`	Diagnosticar por que e-mails MisarMail caem em spam ou são rejeitados e produzir uma lista priorizada de correções. Use para "e-mails indo para spam", "não sendo entregues", "baixa taxa de abertura", "reputação de domínio", perguntas sobre DMARC/SPF/DKIM ou blocklist.
`build-email-automation`	Projetar e construir um fluxo de automação MisarMail — série de boas-vindas, sequência de gotejamento, reengajamento ou onboarding. Use para "automatizar", "gotejamento", "série de boas-vindas", "sequência" ou e-mail baseado em gatilho.
`clean-contact-list`	Auditar e limpar uma lista de contatos MisarMail — contatos rejeitados, que reclamaram e sem engajamento. Use para higiene de lista, reengajamento, supressão ou "por que minha taxa de abertura está caindo".
`email-performance-report`	Produzir um relatório de desempenho MisarMail — aberturas, cliques, entregabilidade, atribuição de receita. Use para "como estão meus e-mails", relatórios semanais/mensais ou análise de desempenho de campanha.
`run-email-campaign`	Criar, revisar e enviar uma campanha de e-mail em massa no MisarMail. Use quando o usuário quiser enviar e-mail para uma lista, newsletter, segmento ou anúncio para muitos destinatários.
`send-transactional-email`	Enviar um e-mail único ou transacional pelo MisarMail. Use quando o usuário pedir para enviar, redigir e enviar, ou responder a um e-mail — incluindo recibos, notificações, mensagens de boas-vindas e contato pessoal.
`setup-sending-domain`	Adicionar e verificar um domínio de envio personalizado no MisarMail, incluindo SPF, DKIM, DMARC e roteamento de entrada. Use para "enviar do meu próprio domínio", configuração de DNS, verificação de domínio ou e-mail de entrada.

Segurança

Ações destrutivas e irreversíveis são anotadas (destructiveHint) para que os clientes possam solicitar confirmação antes de executá-las. As habilidades instruem os agentes a confirmar antes de qualquer ação que envie e-mail, publique conteúdo ou seja visível para outras pessoas.

A descoberta (initialize, tools/list, prompts/list, resources/list) nunca exige credenciais, para que os registros possam indexar o servidor sem elas. Toda ação exige.