MepMail
E-mail transacional e de marketing com uma API compatível com Resend: envie e-mails, transmissões, domínios, contatos e modelos a partir de assistentes de IA.
Servidor MCP hospedado
npx add-mcp 'https://api-mepmail.je4ndev.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
E-mail transacional com uma API compatível com Resend.
Hospede você mesmo em sua própria AWS SES, ou use a nuvem hospedada em mepmail.je4ndev.com. Migrar do Resend significa mudar duas variáveis de ambiente — não reescrever sua integração.
Recursos
| Recurso | Status | Notas |
|---|---|---|
| API de E-mails (compatível com Resend) | ✅ | Enviar, em lote, obter, cancelar — mesmos formatos de requisição/resposta do Resend. |
| Idempotência | ✅ | O cabeçalho Idempotency-Key deduplica envios repetidos. |
| Chaves de API | ✅ | Crie e revogue chaves ms_ no painel, com rastreamento de último uso. |
| Lista de supressão | ✅ | Rejeições permanentes e reclamações são suprimidas automaticamente; revise e remova por endereço, ou gerencie via /suppressions (adição/remoção em lote de até 1000). |
| Métricas | ✅ | Envios diários com taxas de rejeição e reclamação rastreadas em relação aos limites da SES. |
| Webhooks (Standard Webhooks) | ✅ | Entregas de eventos assinadas (cabeçalhos webhook-* e svix-*) com seleção de eventos por endpoint, registro de entregas e segredo whsec_ próprio. |
| Domínios + BYODKIM | ✅ | Verificação de DNS guiada; use sua própria chave DKIM ou deixe a SES gerenciar. |
| Contatos | ✅ | Contatos da equipe com estado de inscrição, segmentos, tópicos, importação CSV e POST /contacts/batch em lote. |
| Cancelamento de inscrição com um clique (RFC 8058) | ✅ | Cabeçalhos List-Unsubscribe além de uma página de cancelamento hospedada. |
| Transmissões | ✅ | Componha, agende e envie para todos os contatos, um segmento ou um tópico; cancele enquanto agendado. |
| Modelos + campos de mesclagem | ✅ | Modelos reutilizáveis com campos de mesclagem por contato; API /templates com aliases por equipe. |
| Registros de requisições de API | ✅ | Cada requisição de API registrada com corpos de requisição/resposta, com segredos ocultos. |
| Relé SMTP | ✅ | SMTP direto na porta 2587; autentique com uma chave de API. |
| Painel (en/pt-BR) | ✅ | Painel completo em inglês e português brasileiro. |
| Autohospedagem (Docker) | ✅ | Pilha Compose compilada a partir do código-fonte, além de um assistente de configuração; envios através da sua própria AWS SES. |
| Migrar do Resend | ✅ | npx @mepmail/cli migrate --from resend move contatos, segmentos, tópicos, modelos, webhooks, domínios e supressões; somente leitura em relação ao Resend, seguro para reexecutar antes da migração. |
| MCP para agentes de IA | ✅ | Servidor MCP hospedado (https://api-mepmail.je4ndev.com/mcp, OAuth) e um servidor stdio local: npx @mepmail/mcp. |
| Descoberta de agentes | ✅ | /.well-known/ai-catalog.json, /llms.txt e /auth.md servidos pelo aplicativo web. |
| Documentação (en/pt-BR) | ✅ | Documentação completa em docs-mepmail.je4ndev.com. |
Execute localmente
Compile a partir deste checkout do código-fonte:
git clone https://github.com/JE4NVRG/mepmail.git mepmail
cd mepmail
cp .env.example .env
Preencha os dois segredos obrigatórios em .env antes de iniciar (MASTER_ENCRYPTION_KEY e
BETTER_AUTH_SECRET; gere cada um com openssl rand -base64 32).
O caminho de instalação suportado é uma compilação local do código-fonte (raiz Dockerfile /
docker-compose.yml); instaladores de terceiros ou imagens pré-compiladas não são
canais de lançamento suportados para este projeto. O assistente de código-fonte (pnpm setup:aws)
e o pipeline completo de eventos SES/SNS estão documentados no
guia de autohospedagem.
docker compose up --build -d
Painel em http://localhost:3000, API em http://localhost:3001.
Migrando do Resend
Mantenha seu SDK do Resend: aponte seu baseUrl para sua instância do MepMail e troque a
chave de API. O protocolo de comunicação é compatível, então os formatos de requisição não mudam.
MCP para agentes de IA
npx -y @mepmail/mcp # stdio server for Claude Code, Cursor and any MCP client
Links
- Nuvem: mepmail.je4ndev.com
- Documentação: docs-mepmail.je4ndev.com
- API: api-mepmail.je4ndev.com
Licença
O código é licenciado sob AGPL-3.0.
Este projeto é derivado de MillionSend;
atribuição e avisos estão em NOTICE.md. O servidor @mepmail/mcp é distribuído
sob MIT. Nomes, marcas e logotipos upstream permanecem propriedade de seus
respectivos proprietários e não são licenciados sob a AGPL.