Apresentamos o servidor MCP do Emailit

Estamos lançando o servidor MCP do Emailit, um servidor de código aberto do Model Context Protocol que dá a assistentes de IA como o Claude, o Cursor e qualquer outro cliente compatível com MCP acesso completo à plataforma do Emailit. Envie e-mails, gerencie contatos, configure domínios e crie templates, tudo em linguagem natural.

O que isso possibilita

Em vez de alternar entre o seu assistente de IA e o painel do Emailit, agora você pode fazer tudo em uma única conversa:

• “Envie um e-mail de boas-vindas para sarah@example.com usando o template de onboarding”: a IA escolhe o template certo, preenche as variáveis e envia.
• “Mostre todos os e-mails que deram bounce esta semana”: liste e inspecione e-mails sem sair do seu editor.
• “Adicione mail.example.com como domínio de envio e mostre os registros DNS”: crie o domínio e receba exatamente os registros que você precisa configurar.
• “Agende um lembrete para a equipe amanhã às 9h”: o servidor aceita agendamento em linguagem natural (em inglês), como “tomorrow at 9am” ou “next Monday at 2pm”.

O servidor MCP expõe 47 ferramentas em 8 categorias: e-mails, domínios, chaves de API, listas de contatos, contatos, templates, supressões e webhooks. Ele cobre toda a API do Emailit.

Como funciona

O Model Context Protocol é um padrão aberto que permite que assistentes de IA se conectem a serviços externos por meio de uma interface estruturada de ferramentas. O servidor MCP do Emailit implementa esse protocolo, então qualquer cliente compatível pode descobrir e chamar as operações do Emailit automaticamente.

Existem duas formas de conectar:

1. Stdio: o cliente inicia o servidor como um subprocesso e se comunica via stdin/stdout. É a configuração mais simples e funciona com Claude Code, Cursor e Claude Desktop.
2. HTTP: o servidor roda como um serviço HTTP independente, com o transporte Streamable HTTP. É útil para configurações remotas, ambientes compartilhados ou clientes web.

Como começar

Você só precisa de uma conta no Emailit, uma chave de API e Node.js 18+.

Claude Code

claude mcp add emailit -e EMAILIT_API_KEY=sua_chave_api -- npx -y @emailit/emailit-mcp

Cursor

Abra Cursor Settings → MCP → Add new global MCP server e cole:

{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "sua_chave_api"
      }
    }
  }
}

Claude Desktop

Abra Settings → Developer → Edit Config e cole o mesmo bloco JSON acima.

Pronto. Depois da conexão, a IA descobre automaticamente as 47 ferramentas e você já pode começar a usá-las.

Exemplos

Algumas coisas que você já pode fazer logo de cara:

Enviar e-mails com templates e variáveis

“Envie o template welcome-email para john@example.com com o nome John”

A IA encontra o template pelo alias, substitui a variável {{name}} e envia:

{
  "template": "welcome-email",
  "to": "john@example.com",
  "variables": { "name": "John" }
}

Anexar arquivos a partir de uma URL

“Envie a fatura mensal para accounting@company.com com o PDF do nosso bucket S3”

{
  "to": "accounting@company.com",
  "subject": "Fatura Mensal",
  "attachments": [
    {
      "filename": "fatura-2026-05.pdf",
      "url": "https://meubucket.s3.amazonaws.com/faturas/2026-05.pdf"
    }
  ]
}

Gerencie toda a sua infraestrutura de envio

“Crie uma nova lista chamada ‘Usuários Beta’, adicione jane@example.com a ela e depois crie um webhook que me envie os eventos de entrega”

A IA encadeia várias ferramentas (create-audience, create-contact e create-webhook) em uma única conversa.

Suprimir endereços e remover a supressão

“Suprima bounced@example.com por excesso de hard bounces, com expiração em 30 dias”

{
  "email": "bounced@example.com",
  "type": "bounce",
  "reason": "muitos bounces definitivos",
  "keep_until": "2026-06-18T00:00:00Z"
}

Dicas

• Defina um remetente padrão. Passe --sender voce@seudominio.com ou configure a variável de ambiente SENDER_EMAIL_ADDRESS para que a IA não peça o endereço do remetente toda vez.
• Use templates para e-mails recorrentes. Crie templates com {{variables}} e use-os pelo alias: é mais rápido e mais consistente do que escrever HTML no chat.
• O agendamento em linguagem natural funciona. Você pode usar expressões como “tomorrow at 9am” ou “next Friday at noon”, ou passar um timestamp ISO 8601; o servidor entende os dois.
• Operações destrutivas são protegidas. As ferramentas de exclusão orientam a IA a confirmar com você antes de continuar, então você não vai excluir um domínio ou contato sem querer.
• Modo HTTP para configurações compartilhadas. Se várias pessoas da equipe ou vários serviços precisam de acesso, rode o servidor no modo HTTP: cada cliente se autentica com a própria chave de API via token Bearer.

Código aberto

O servidor MCP do Emailit tem licença MIT e está disponível no GitHub. É JavaScript puro (ESM), não tem etapa de build e depende de apenas quatro pacotes: @modelcontextprotocol/sdk, fastify, minimist e zod.

Contribuições e feedback são bem-vindos: abra uma issue ou envie um PR.

Documentação completa

Publicamos um guia completo de configuração e referência:

• Guia do servidor MCP do Emailit: instalação, configuração, as 47 ferramentas, exemplos de uso e solução de problemas

Comece agora

Instale o servidor MCP com um único comando:

npx -y @emailit/emailit-mcp

Leia o guia completo ou confira o repositório no GitHub para começar.