GoodSender

Um servidor MCP local gratuito e baseado em consentimento para envio de e-mails em texto simples, HTML e Markdown, além de templates transacionais, com tratamento automático de consentimento do destinatário.

Documentação

GoodSender MCP banner

Recursos

  • 🛡️ Servidor local
    • Conteúdos de e-mail, templates personalizados, grupos de destinatários e identidades de remetente são armazenados apenas na sua máquina.
  • ✉️ Envie e-mails em texto simples, HTML ou Markdown para um ou mais destinatários.
  • ✅ Envie e-mails transacionais sem consentimento usando templates integrados (OTP, MFA, Conclusão de Pedido, etc.)
  • 🤝 Fluxo de consentimento automático.
    • Destinatários adicionados via MCP recebem o e-mail de consentimento.
    • E-mails são enfileirados localmente até que o destinatário conceda o consentimento para recebê-los.
  • 📝 Crie, edite e armazene templates personalizados com variáveis dinâmicas.
    • Pré-visualização interativa de templates para iteração rápida de design.
    • Envie e-mail de teste para verificar a renderização do template.
  • 👥 Organize destinatários em grupos e referencie todos pelo nome do grupo.
  • 🏷️ Gerencie identidades de remetente (cabeçalho From:) e referencie-as pelo nome.
  • 📊 Monitore métricas de saúde do e-mail.
  • 📰 Mantenha o blog: configurações, domínio personalizado, rascunhos, publicação, pré-visualização e transmissão por e-mail.

Instalação

MCP Bundle (arquivo `.mcpb`, mais fácil)
  • Pegue o arquivo goodsender.mcpb na última versão.

  • Clique duas vezes no arquivo goodsender.mcpb para abri-lo no seu cliente de IA.

    Nota: Nem todo cliente de IA suporta bundles MCP ou servidores MCP locais ainda. Use um método de instalação diferente se nada acontecer ao clicar duas vezes.

Imagem Docker / auto-hospedagem

Execute via

docker run -d -e GOODSENDER_API_KEY=<Your API Key> -v goodsender-mcp-data:/data ghcr.io/good-sender/mcp:latest

Se seu objetivo é executar o agente usando este MCP de forma totalmente autônoma, defina GOODSENDER_DISABLE_ACTION_GUARDS=true para pular todas as confirmações de ação completamente. Veja Confirmação de ação.

ou adicione ao docker-compose.yaml no seu servidor doméstico

services:
  goodsender-mcp:
    image: ghcr.io/good-sender/mcp:latest
    ports:
      - "9889:9889"
    environment:
      GOODSENDER_API_KEY: <Your API Key>
      # GOODSENDER_DISABLE_ACTION_GUARDS: "true"  # skip all action confirmations
    volumes:
      - goodsender-mcp-data:/data
    restart: unless-stopped

volumes:
  goodsender-mcp-data:

e execute via

docker compose up -d
Configuração manual (JSON)
  • Pegue o arquivo binaries.zip na última versão (inclui binários MCP goodsender-mcp-* e CLI goodsender-*).

  • Descompacte-o em algum lugar de fácil referência.

  • Modifique o arquivo de configuração do seu cliente de IA, adicionando a configuração do servidor MCP (exemplo para Claude Desktop e Cursor no macOS):

    {
      ...
      "mcpServers": {
        "GoodSender": {
          "command": "<path to the unzipped binaries>/goodsender-mcp-darwin-arm64",
          "env": {
            "GOODSENDER_API_KEY": "<Your API key>"
          }
        }
      }
      ...
    }
    

    Para outras plataformas, você deve referenciar um binário correspondente em vez de darwin (macOS)

    Se seu objetivo é executar o agente usando este MCP de forma totalmente autônoma, defina GOODSENDER_DISABLE_ACTION_GUARDS=true para pular todas as confirmações de ação completamente. Veja Confirmação de ação.

Confirmação de ação

Por padrão, ferramentas de mutação (criar, publicar, enviar e similares) não são executadas imediatamente. Elas retornam um token de confirmação. O agente deve chamar confirm_action após sua aprovação.

Defina GOODSENDER_DISABLE_ACTION_GUARDS=true no ambiente do servidor MCP para pular essa etapa. As ferramentas então são executadas quando o cliente as chama. Use isso para loops não supervisionados (agendamentos Cowork, CI). Deixe sem definir se você quiser que cada envio e publicação aguarde sua aprovação no chat.

Exemplos

Exemplos de prompts

Adicione 'John Doe <john.doe@example.com>' e 'Jane Doe <jane.doe@example.com>' ao grupo de assinantes do boletim de IA

ℹ️ Isso irá:

  • Criar/atualizar os destinatários no banco de dados
  • Adicioná-los ao grupo de destinatários "AI newsletter subscribers", criando-o se necessário

Crie um template GoodSender para um resumo semanal de notícias de IA enviado ao grupo de assinantes do boletim de IA

ℹ️ Isso irá:

  • Criar um rascunho de template de e-mail no formato GoodSender seguindo as melhores práticas para criação de templates de e-mail
  • Exibir pré-visualização interativa deste rascunho de template (se o cliente de IA suportar)

Aumente o número de notícias no resumo para 5

ℹ️ Feito durante a criação/edição do rascunho do template, isso irá:

  • Modificar o template de acordo
  • Exibir pré-visualização interativa deste rascunho de template (se o cliente de IA suportar)

Envie um e-mail de teste para mim: 'Good Sender <good.sender@example.com>'

ℹ️ Feito durante a criação/edição do rascunho do template, isso irá:

  • Enviar um e-mail com dados simulados gerados a partir do rascunho atual do template apenas para você

Salve o template como "Weekly AI news"

ℹ️ Feito durante a criação/edição do rascunho do template, isso irá:

  • Converter o rascunho atual do template em um template persistente armazenado no banco de dados local
  • Permitir o envio de e-mails apenas mencionando o nome do template

Reúna as notícias de IA desta semana e envie-as usando o template "Weekly AI news"

ℹ️ Isso irá:

  • Criar e enfileirar um e-mail personalizado baseado em template para cada destinatário no grupo de assinantes do boletim de IA
  • Para todos os destinatários que não receberam um e-mail com solicitação de consentimento, solicitará seu consentimento para receber e-mails seus
  • Enviar e-mails para todos os destinatários que concederam seu consentimento de e-mail
  • Monitorar todos os destinatários com consentimento pendente e enviar o e-mail assim que eles o concederem

Publique uma postagem de blog 'Why consent-based emailing wins' e envie por e-mail para o grupo de assinantes do boletim de IA

ℹ️ Isso irá:

  • Criar um rascunho de postagem a partir do título e corpo
  • Mostrar uma URL de pré-visualização assinada
  • Publicar a postagem
  • Transmiti-la para o grupo (o fluxo de consentimento ainda se aplica)
Example 1 Example 2

Telemetria e privacidade

A telemetria está habilitada por padrão. O servidor MCP envia métricas agregadas de uso e confiabilidade para a GoodSender para ajudar a melhorar o produto.

Sinais típicos incluem:

  • Nomes de ferramentas MCP, contagens de chamadas e latência.
  • Taxas de sucesso e erro.
  • Trechos curtos de erro em falhas.
  • Códigos de erro e frequência de trabalhos em segundo plano.

Nós não coletamos intencionalmente corpos de e-mail, endereços de destinatários ou conteúdos de templates como parte desta telemetria.

Você pode optar por não participar da coleta de telemetria definindo GOODSENDER_TELEMETRY=false no ambiente do servidor MCP.

Veja a Política de Privacidade da GoodSender para saber como os dados pessoais são tratados pelo serviço.