VaEmail

VaEmail — infraestrutura de e-mail para agentes de IA

Servidor MCP e CLI para VaEmail. Dê a um agente a capacidade de enviar e-mail, autenticar um domínio de envio, rastrear a entrega e diagnosticar a entregabilidade — sem que um humano precise ler um painel no meio do caminho.

Infraestrutura europeia: servidores na Alemanha, envio por meio do Amazon SES Europa.

Instalação

# Claude Code
claude mcp add vaemail --env VAEMAIL_API_KEY=swm_your_key -- npx -y vaemail mcp

# Any MCP client
npx -y vaemail mcp

Ou como um bloco de configuração:

{
  "mcpServers": {
    "vaemail": {
      "command": "npx",
      "args": ["-y", "vaemail", "mcp"],
      "env": { "VAEMAIL_API_KEY": "swm_your_key" }
    }
  }
}

Verifique se tudo está conectado:

npx vaemail init

Ferramentas

Ferramenta	O que faz
vaemail_capabilities	O que o serviço suporta. Nenhuma chave de API necessária.
vaemail_send_email	Coloca um e-mail transacional na fila e retorna o id dele.
vaemail_validate_email	Teste seco: este envio sairia e o que o bloquearia.
vaemail_get_message	Status de entrega e todos os eventos de uma mensagem.
vaemail_list_messages	Mensagens recentes, filtradas por status, tag ou destinatário.
vaemail_list_domains	Domínios de envio com o estado atual de SPF, DKIM e DMARC.
vaemail_create_domain	Declara um domínio e retorna os registros DNS a publicar.
vaemail_verify_domain	Relê o DNS e informa o que está autenticado.
vaemail_dns_requirements	Os registros que um domínio declarado ainda precisa.
vaemail_diagnose_deliverability	Por que o e-mail está chegando mal, com as ações que corrigem isso.
vaemail_list_bounces	Endereços excluídos do envio e o motivo.
vaemail_get_usage	Cota, limite diário da chave e o que resta.
vaemail_get_audit_log	O que esta chave fez, para relatar com precisão.

Para que isso foi criado

Um agente falha de forma diferente de uma pessoa. Ele tenta novamente, não lê um painel e relata sucesso a partir de um 200. A API foi moldada em torno disso:

• Um envio é aceito, não entregue. vaemail_send_email retorna 202 e um id. Somente vaemail_get_message diz o que aconteceu com ele. As descrições das ferramentas dizem isso, para que um agente não anuncie uma entrega que não pode saber.
• Novas tentativas não duplicam. Passe idempotency_key e uma chamada repetida reproduz a primeira resposta por 24 horas em vez de enviar duas vezes.
• Erros dizem o que fazer. Cada falha carrega um code estável, seja retryable, e a ação corretiva com o endpoint que a executa.
• Chaves são limitadas. Escopos, um limite diário de envio, um limite de destinatários por e-mail e uma lista de permissões de domínios de remetente. Um agente não pode gastar mais do que a chave permite.
• Toda chamada é registrada. Qual chave, qual operação, quais parâmetros, qual resultado — corpos de mensagens excluídos. Autônomo, mas responsável.
• Etapas humanas são nomeadas como tal. Publicar registros DNS é uma delas. Um registro cujo valor ainda contém um espaço reservado é sinalizado como publishable: false, porque publicá-lo quebraria a autenticação do domínio.

CLI

vaemail init                          # check config, print the MCP snippet
vaemail capabilities                  # what the service can do (no key needed)
vaemail send --to a@b.fr --subject Hi --html '<p>Hello</p>'
vaemail status 42                     # delivery status of a message
vaemail domains:add exemple.fr        # declare a domain, print DNS records
vaemail doctor                        # why is my email not arriving?
vaemail usage                         # quota and remaining allowance
vaemail mcp                           # run the MCP server on stdio

Adicione --json a qualquer comando para saída legível por máquina.

Ambiente

Variável	Significado
VAEMAIL_API_KEY	Chave de API da conta. Criada no painel, em « Clés API ».
VAEMAIL_BASE_URL	URL base da API. O padrão é https://app.vaemail.fr.

Também disponível

• Especificação OpenAPI: https://app.vaemail.fr/openapi.json
• Endpoint de capacidades: https://app.vaemail.fr/api/v1/capabilities
• Documentação do agente: https://vaemail.fr/agents

Habilidade e exemplos

• Habilidade do agente (regras que um agente deve seguir antes da primeira chamada): npx skills add vaemail/skills, fonte https://github.com/vaemail/skills
• Exemplos para curl, Node, Python, Claude Code, Codex, OpenAI Agents, LangChain, CrewAI e n8n: https://github.com/vaemail/examples
• Entrada do registro: io.github.vaemail/vaemail (veja server.json)

Dependências

Nenhuma. Node 18+ para o fetch integrado e nada mais — um pacote que um agente instala por conta própria não deve arrastar uma árvore de dependências atrás de si.

Licença

MIT