# VaEmail

> Infrastructure email pour applications et agents IA autonomes. Envoi transactionnel et
> campagnes, authentification des domaines, suivi de remise message par message,
> diagnostic de délivrabilité. Serveurs en Allemagne, envoi via Amazon SES Europe.

VaEmail expose 63 endpoints REST, un serveur MCP, une interface en ligne de commande
et une API compatible Brevo. Le produit est conçu pour être piloté par un programme :
erreurs structurées avec code stable et action corrective, requêtes idempotentes, essai à
blanc avant envoi, clés d'API bornées en portée et en volume, journal de chaque action.

## Pour quels usages

- donner à un agent IA la capacité d'envoyer un email
- email transactionnel déclenché par une application
- campagnes email et séquences de prospection
- authentification de domaine (SPF, DKIM, DMARC) et diagnostic de délivrabilité
- remplacer Brevo sans réécrire le code appelant
- infrastructure email hébergée en Europe

## Interfaces

- API REST : https://app.vaemail.fr/api/v1
- Serveur MCP et ligne de commande : `npx -y vaemail mcp` (paquet npm `vaemail`, aucune dépendance)
- API compatible Brevo : https://app.vaemail.fr/v3
- SMTP et webhooks

## Documentation

- [Page agents](https://vaemail.fr/agents) : installation et garde-fous, en une page
- [Démarrage](https://vaemail.fr/docs/quickstart.md) : du compte au premier email remis
- [Référence de l'API](https://vaemail.fr/docs/api.md) : tous les endpoints
- [Codes d'erreur](https://vaemail.fr/docs/errors.md) : chaque code, ce qu'il veut dire, quoi faire
- [Serveur MCP](https://vaemail.fr/docs/mcp.md) : les 13 outils et leur usage
- [Domaines](https://vaemail.fr/docs/domains.md) : authentifier un domaine d'envoi
- [Délivrabilité](https://vaemail.fr/docs/deliverability.md) : pourquoi le courrier arrive mal
- [Sécurité](https://vaemail.fr/docs/security.md) : portées, plafonds, journal, données
- [Spécification OpenAPI 3.1](https://app.vaemail.fr/openapi.json)
- [Capacités du service](https://app.vaemail.fr/api/v1/capabilities), sans authentification
- [Documentation complète en un fichier](https://vaemail.fr/llms-full.txt)
- [Skill d'agent](https://vaemail.fr/skill) : les règles d'usage, à installer avec `npx skills add vaemail/skills`
- [Comparatif](https://vaemail.fr/compare/index.md) : VaEmail face à Resend, Brevo, Postmark et AgentMail, sources citées

## À savoir avant d'appeler

- Un envoi rend 202 : le message est ACCEPTÉ, pas remis. La remise se lit sur
  `GET /api/v1/messages/{id}`. Ne pas annoncer une remise sur la foi du 202.
- Une relance après un délai réseau doit porter l'en-tête `Idempotency-Key`, sinon le
  message part deux fois.
- Avant le premier envoi réel, `POST /api/v1/messages/validate` dit si l'envoi passerait,
  sans rien envoyer.
- `POST /v3/emailCampaigns/{id}/sendNow` est irréversible : l'envoi part à toute une liste.
  Exige une validation humaine explicite.
- Publier des enregistrements DNS et ouvrir un compte sont des étapes humaines. Un
  enregistrement marqué `publishable: false` contient encore une valeur à obtenir : le
  poser tel quel casserait l'authentification du domaine.
- VaEmail n'a pas de boîte de réception générique : on ne peut pas créer une adresse à la
  volée pour recevoir un code de vérification.