Documentation · Escouade Mail

Escouade Mail donne une boîte mail à un agent IA. Il écrit, reçoit et répond avec sa propre adresse, par MCP. Cette documentation est écrite pour l’agent d’abord : chaque page existe en Markdown, à la même adresse suffixée .md.

Le service est payant : trois forfaits par mois, à 9 €, 19 € et 49 €. Avant le paiement, une boîte reçoit, prépare des brouillons et n’écrit qu’à son humain. Les prix : Prix et paiement ; ce qui est en service : État du service.

En bref

Une adresse pour l’agent : https://api.subagent.fr/mcp, un serveur MCP en Streamable HTTP.
Sans clé, le serveur ne montre qu’un outil : sign_up. Il ouvre un espace, rend une clé (sak_…, affichée une seule fois) et une première boîte sur subagentmail.fr.
Un humain confirme : il reçoit par e-mail un code à 6 chiffres, que l’agent passe à verify. Avant, la boîte reçoit et n’envoie pas.
Un humain paie : l’agent demande un lien avec subscribe et le lui remet. L’agent ne paie jamais.
Le serveur règle les envois : montée progressive, quota du jour, heures ouvrées, validation humaine, désinscription, coupe-circuit. Voir Règles d’envoi.
Aucune console. Un humain lit, corrige et valide depuis son assistant, branché à l’adresse https://mail.escouade.io/mcp. Voir Connecteur.

La consigne à donner à votre agent

Remplacez l’adresse par la vôtre : c’est elle qui reçoit le code.

Consigne

Branche-toi au MCP d'Escouade Mail : https://api.subagent.fr/mcp
Lis d'abord https://escouade.io/mail/docs/agents.md.
Inscris-toi avec sign_up : choisis un nom de boîte et donne mon e-mail, [email protected], en human_email.
Garde la clé rendue : elle ne s'affiche qu'une fois.
Je te donnerai le code à 6 chiffres que je vais recevoir : passe-le à verify.

Par où commencer

Vous êtes	Lisez
Un agent IA qui découvre le service	Pour les agents : le parcours de l’inscription à la réponse à un correspondant, sur une page.
Une personne qui veut brancher son agent	Démarrer : de l’adresse du MCP au premier e-mail. Assistant par assistant : Brancher mon agent.
Une personne sans agent, dans Claude ou ChatGPT	Brancher Claude ou Brancher ChatGPT : elle ouvre son espace sur la page de connexion.
Une personne qui veut valider depuis Claude ou ChatGPT	Connecteur, puis Valider les envois d’un agent.
Quelqu’un qui se demande si le service convient	Donner une boîte mail à un agent IA : ce qu’il faut, ce que l’agent fait ensuite, les limites.
Quelqu’un qui écrit un client	Serveur MCP, API HTTP, Référence des outils.

Le plan

Partie	Pages
Démarrer	Démarrer, Pour les agents, Donner une boîte mail à un agent IA, État du service, Prix et paiement
Concepts	Boîtes, Messages, Fils, Recevoir du courrier, Brouillons et validation, Pièces jointes et copies, Clés et permissions, Vues
Envoi	Règles d’envoi, Domaines, Désinscription et blocages, Limites et quotas
Guides	Répondre à un correspondant, Valider les envois d’un agent, Recevoir un code de vérification
Intégrations	Serveur MCP, API HTTP, Webhooks, Connecteur
Référence	Tous les outils, Erreurs, FAQ, Glossaire, Aide

Les objets

Objet	Ce que c’est
Boîte (`inb_…`)	Une adresse e-mail pilotée par un agent. Elle porte son calendrier de montée progressive et son quota du jour. Toute boîte reçoit. Voir Boîtes.
Fil (`thr_…`)	La conversation entre une boîte et un correspondant. Il naît au premier envoi ou au premier e-mail reçu. Voir Fils.
Message (`msg_…`)	Entrant ou sortant, dans un fil. Un sortant passe par `draft`, `queued`, `sending`, `sent`, `delivered`. Voir Messages.
Brouillon	Un message `draft` : il attend une validation humaine et se corrige tant qu’il n’est pas validé. Voir Brouillons et validation.
Domaine (`dom_…`)	Un nom de domaine enregistré par un espace pour y créer ses boîtes. Voir Domaines.
Clé (`sak_…`)	Elle désigne un espace et porte des permissions : `send`, `read`, `approve`, `manage_inboxes`. Voir Clés et permissions.
Espace	Les boîtes, les fils, les clés, les domaines, la liste de blocage et le forfait d’un même client. La clé l’impose : un agent ne peut pas en sortir.
Forfait	Ce que l’espace paie par mois : un nombre de boîtes et un volume d’e-mails. Voir Prix et paiement.

Les identifiants sont préfixés (inb_, thr_, msg_, dom_) et suivis de 32 caractères hexadécimaux. Les dates sont en ISO 8601, à l’heure de Paris, avec leur fuseau. Tous les mots : Glossaire.

Deux façons d’appeler

MCP : https://api.subagent.fr/mcp, en-tête Authorization: Bearer sak_…. Chaque résultat porte un texte lisible en français et un objet structuré (structuredContent). Voir Serveur MCP.
HTTP : chaque outil existe aussi en POST https://api.subagent.fr/v1/{opération}, avec les mêmes arguments en JSON et le même objet en réponse. Sous /v1, chaque route est un outil. Voir API HTTP.

L’assistant d’un humain, lui, se branche à https://mail.escouade.io/mcp : le même serveur, avec une connexion par le compte Escouade au lieu d’une clé. Voir Connecteur.

La référence produite par le serveur fait foi : https://api.subagent.fr/llms.txt et https://api.subagent.fr/openapi.json.

Ce qui est en service

Cette documentation ne décrit comme disponible que ce que le serveur fait. Le reste porte la marque à venir. Une seule page dit où en est chaque sujet : État du service.

Introduction