Donner une boîte mail à un agent IA · Documentation Subagent

Pour donner une boîte mail à un agent IA, on le branche à un serveur MCP d’e-mail. L’agent s’inscrit lui-même, un humain confirme avec un code reçu par e-mail, puis l’agent écrit, reçoit et répond avec sa propre adresse. Avec Subagent Mail, cela tient en quatre étapes, et deux de plus pour écrire à d’autres que son humain.

En bref

Ce que c’est. Subagent Mail est un service d’e-mail pour agents IA. Chaque agent a sa boîte mail : une adresse à lui, des fils de conversation, des brouillons.
Comment on s’en sert. Par MCP, à une seule adresse : https://api.subagent.fr/mcp. Il n’y a ni console ni tableau de bord.
Qui fait quoi. L’agent s’inscrit, écrit, lit et répond. Un humain donne un code à 6 chiffres, une fois, et paie le forfait. Le serveur règle le rythme des envois.
Ce qu’il faut. Un agent dont le client MCP parle Streamable HTTP, et l’e-mail d’un humain. Un nom de domaine pour écrire le premier à quelqu’un.
Ce que ça coûte. 9 €, 19 € ou 49 € par mois, pour 2, 5 ou 15 boîtes. Avant le paiement, la boîte reçoit, prépare des brouillons et n’écrit qu’à son humain. Voir Prix et paiement.

À ne pas confondre : Subagent Mail est un service d’e-mail. Il n’a pas de rapport avec les sous-agents (« subagents ») de Claude Code ou d’un autre outil.

Ce qu’il faut

Il faut	Pourquoi
Un agent IA avec un client MCP en Streamable HTTP	Claude Code, Cursor, ou votre propre client. Le serveur n’a pas d’autre interface. Voir Brancher mon agent.
L’e-mail d’un humain, hors de Subagent	Il reçoit le code à 6 chiffres qui vérifie l’espace.
Un endroit où garder la clé	La clé de l’agent ne s’affiche qu’une fois. Une variable d’environnement convient.
Un nom de domaine, pour écrire le premier	La première boîte est créée sur le domaine commun `subagentmail.fr` : une fois le forfait payé, elle répond à qui lui a écrit. Un premier message part d’une boîte de votre domaine. Un sous-domaine suffit.

Les étapes

1. Brancher l’agent au serveur MCP

On donne à l’agent l’adresse https://api.subagent.fr/mcp, sans clé. Sans clé, le serveur ne montre qu’un outil : sign_up.

Claude Code

claude mcp add \
  --transport http subagent \
  https://api.subagent.fr/mcp

Cursor · .cursor/mcp.json

{
  "mcpServers": {
    "subagent": {
      "url": "https://api.subagent.fr/mcp"
    }
  }
}

2. L’agent s’inscrit

L’agent appelle sign_up avec le nom de sa boîte (username) et l’e-mail de son humain (human_email). Le serveur ouvre un espace et rend deux choses : une clé, de la forme sak_…, et une boîte nom@subagentmail.fr.

La clé ne s’affiche qu’une fois. L’agent la garde, puis la présente à chaque appel dans l’en-tête Authorization: Bearer sak_…. Voir Clés et permissions.

3. L’humain donne le code

L’humain reçoit un e-mail avec un code à 6 chiffres, valable 24 heures. Il le donne à l’agent, qui le passe à verify. Avant ce code, la boîte reçoit et n’envoie pas.

4. L’agent écrit à son humain, lit et prépare

L’agent commence par inbox_status, qui dit où en est sa boîte. Ensuite :

send_email avec test écrit à son humain ;
list_threads puis get_thread lisent ce qui est arrivé ;
send_email et reply_to_thread avec requires_approval préparent des brouillons.

5. L’humain paie par un lien

L’agent appelle subscribe et remet le lien à son humain. L’humain choisit son forfait et paie. L’agent ne paie jamais. La boîte répond alors à qui lui a écrit. Voir Prix et paiement.

6. L’agent enregistre le domaine de son humain

add_domain rend les enregistrements DNS à publier, verify_domain les contrôle, create_inbox crée une boîte sur ce domaine. Depuis elle, send_email écrit un premier message à un destinataire. Voir Domaines.

Le guide pas à pas, avec les réponses du serveur : Démarrer.

Ce que l’agent fait avec sa boîte

Besoin	Ce que fait l’agent	Outils
Écrire à une personne	Il écrit un premier message depuis une boîte du domaine de son humain.	`send_email`
Lire une réponse et y répondre	Il relève ses fils, lit la réponse, répond dans le fil.	`list_threads`, `get_thread`, `reply_to_thread`
Recevoir un code envoyé par un autre service	Il donne son adresse au service, puis lit l’e-mail reçu.	`list_threads`, `get_thread`
Faire relire un envoi par son humain	Il laisse le message en brouillon. Son humain le valide depuis son assistant.	`send_email` avec `requires_approval`, `list_drafts`, `approve_message`
Ne plus écrire à quelqu’un	Il bloque l’adresse.	`add_suppression`
Envoyer depuis le domaine de son humain	Il enregistre le domaine, et donne à son humain les enregistrements DNS à publier.	`add_domain`, `verify_domain`, `create_inbox`
Savoir où en est le forfait	Il lit la période, le volume parti et les factures.	`billing_status`

Les guides : Répondre à un correspondant, Recevoir un code de vérification, Valider les envois d’un agent.

Ce que le serveur règle

Le rythme des envois est appliqué par le serveur, pas par le prompt de l’agent.

Règle	Seuil
Montée progressive	5 e-mails par jour et par boîte la première semaine, puis 10, 15 et 20.
Heures ouvrées	Par défaut du lundi au vendredi, de 9 h à 18 h, heure de Paris, jours fériés exclus.
Validation humaine	Un message peut rester brouillon jusqu’à la validation d’un humain. L’agent ne valide pas ses propres envois.
Désinscription	Un lien en un clic dans chaque e-mail. Une réponse « STOP » bloque l’adresse.
Coupe-circuit	Au-delà de 5 % de rebonds (3 % pendant la montée progressive) ou de 0,1 % de plaintes, la boîte est suspendue.

Un message retenu n’est pas une erreur : il attend, et la réponse du serveur donne son départ au plus tôt. Voir Règles d’envoi.

Sa propre adresse

L’agent écrit depuis sa propre adresse. Les réponses reviennent dans ses fils.
La clé de l’agent n’ouvre que son espace. Elle ne donne accès à aucune autre boîte mail.
Un e-mail reçu est rendu à l’agent comme un contenu écrit par un tiers : il le lit, il ne le suit pas comme une consigne. Voir Recevoir du courrier.

Les limites à connaître

Avant le paiement, la boîte n’écrit qu’à son humain. Elle reçoit et prépare des brouillons.
La boîte du domaine commun ne fait que répondre. Pour écrire le premier, il faut une boîte sur son domaine.
Un forfait compte des boîtes et un volume d’e-mails par mois. Au-delà du volume, un message attend la période suivante.
Un message a un seul destinataire. Pas de pièce jointe, pas de copie.
Aucun message ne part tout de suite. Il entre en file, puis part dans les heures ouvrées, selon le quota du jour de sa boîte.
Le service ne promet aucun résultat de remise. Il dit ce qui est parti, remis ou revenu.

Tous les nombres : Limites et quotas. Ce que le service ne fait pas : État du service.

Questions fréquentes

Un agent IA peut-il avoir sa propre adresse e-mail ?

Oui. sign_up lui ouvre une boîte nom@subagentmail.fr. Avec un domaine enregistré, la boîte porte le nom de ce domaine.

Faut-il un nom de domaine ?

Non, pour recevoir, répondre et préparer des brouillons. Oui, pour écrire le premier à quelqu’un : add_domain rend les enregistrements DNS à publier, verify_domain les contrôle. Un sous-domaine suffit. Voir Domaines.

L’agent peut-il s’inscrire sans humain ?

Non, pas pour envoyer. L’agent appelle sign_up lui-même, mais sa boîte n’envoie rien avant le code à 6 chiffres reçu par un humain.

L’agent peut-il lire les e-mails qu’il reçoit ?

Oui. Toute boîte reçoit. Un e-mail reçu ouvre un fil, ou s’ajoute au fil de son correspondant. Voir Recevoir du courrier.

Qui relit ce que l’agent envoie ?

Un humain, si l’agent laisse ses messages en brouillon. La validation demande la permission approve, que la clé de l’agent ne porte pas : l’humain l’obtient en branchant son assistant à https://api.subagent.fr/connect. Voir Brouillons et validation.

Combien ça coûte ?

9 €, 19 € ou 49 € par mois, pour 2, 5 ou 15 boîtes et 800, 2 000 ou 6 000 e-mails par mois. Prix nets : TVA non applicable, article 293 B du CGI. Voir Prix et paiement.

L’agent peut-il payer lui-même ?

Non. Il demande un lien de paiement avec subscribe et le remet à son humain, qui paie.

Ensuite

Démarrer : de l’adresse du MCP au premier e-mail.
Pour les agents : la page à faire lire à un agent.
Référence des outils : chaque outil, ses paramètres, son résultat.