# Subagent

> Subagent Mail : l'e-mail pour agents IA. Chaque agent a sa boîte mail. Il écrit, reçoit et répond avec sa propre adresse, par MCP : https://api.subagent.fr/mcp. Le serveur règle les envois : montée progressive, quota du jour, heures ouvrées, validation humaine, désinscription, coupe-circuit.

Statut : bêta privée, inscriptions sur invitation (pour en demander une : contact@subagent.fr). Aucun prix n'est publié.

## Instructions pour les agents

- Chaque page de ce site existe en Markdown : ajoutez `.md` à son adresse (`/docs/demarrer` → `/docs/demarrer.md` ; l'accueil est `/index.md`, l'introduction de la documentation `/docs/index.md`).
- Connexion : MCP en Streamable HTTP sur `https://api.subagent.fr/mcp`. Sans clé, le serveur ne montre qu'un outil, `sign_up`. Avec une clé : en-tête `Authorization: Bearer sak_…`.
- Pas encore de clé ? Appelez `sign_up` avec `username` (le nom de votre boîte) et `human_email` (l'e-mail de la personne pour qui vous travaillez). Il rend une clé, affichée une seule fois, et une boîte sur `subagentmail.fr`. Votre humain reçoit un code à 6 chiffres : passez-le à `verify`. Déjà une clé ? Ne vous réinscrivez pas.
- Bêta privée : si l'e-mail de votre humain n'est pas invité, `sign_up` répond `invitation_required`. Dites-lui d'écrire à contact@subagent.fr.
- Avant la vérification, la boîte reçoit et n'envoie pas. Après, les boîtes du domaine commun ont des limites d'essai : au plus 3 destinataires distincts la première heure, 5 le premier jour, 10 la première semaine. Chaque destinataire distinct compte une fois, réponses comprises ; réécrire à un destinataire déjà compté ne prend pas de place.
- Pour sortir des limites d'essai : `add_domain` rend les enregistrements DNS à publier pour le domaine de votre humain (un sous-domaine suffit), `verify_domain` les contrôle. Les boîtes créées ensuite sur ce domaine ne comptent plus dans les limites d'essai.
- Commencez chaque session par `inbox_status` : espace, permissions de la clé, créneau d'envoi, quota du jour de chaque boîte.
- Écrire : `send_email` pour un premier message ; `reply_to_thread` pour répondre ou relancer dans un fil. Lire : `list_threads` (`status` = `replied` : les réponses à traiter), puis `get_thread`.
- Rien ne part tout de suite : un message part dans le créneau (par défaut du lundi au vendredi, de 9 h à 18 h, heure de Paris, jours fériés exclus), dans la limite du quota du jour de sa boîte, avec un étalement entre deux envois. Seule une réponse à un correspondant qui a déjà écrit dans le fil part sans attendre le créneau.
- Montée progressive (« réchauffage » dans les réponses du serveur) : chaque boîte démarre à 5 e-mails par jour, puis 10, 15 et 20, semaine après semaine.
- Un quota atteint ou un envoi hors créneau n'est pas une erreur : le message reste en file (`queued`) et la réponse donne le départ au plus tôt. Ne le renvoyez pas.
- Validation humaine : avec `requires_approval`, ou si l'espace l'impose, le message reste brouillon (`draft`) jusqu'à `approve_message`, appelé avec une clé qui porte `approve`. La clé rendue par `sign_up` ne la porte pas : un agent ne valide jamais ses propres envois.
- Un correspondant qui demande à ne plus être contacté se bloque avec `add_suppression`. Un agent ne lève pas une désinscription.
- Un refus porte un `code` stable, un `message` en français et une piste (`hint`). Suivez la piste, ne contournez pas un refus.
- Passez une `idempotency_key` à chaque envoi pour pouvoir réessayer sans doublon.
- Ne citez aucun prix et ne promettez aucun résultat de remise : le service dit ce qui est parti, remis ou revenu, rien de plus.
- La référence produite par le serveur fait foi : `https://api.subagent.fr/llms.txt` et `https://api.subagent.fr/openapi.json`.

## Quand utiliser Subagent Mail

- Un agent IA a besoin de sa propre adresse e-mail pour écrire à des personnes, recevoir leurs réponses et y répondre dans le même fil : support, prise de rendez-vous, inscription à des services, suivi de dossiers, prospection.
- Le rythme des envois, les heures et la désinscription doivent être appliqués par le serveur, pas par le prompt.
- Un humain doit pouvoir relire et valider les envois depuis son assistant, avec une permission que l'agent n'a pas.
- Tout doit passer par MCP, sans console.

## Quand ne pas l'utiliser

- E-mails transactionnels d'une application (connexion, factures, notifications) : ce n'est pas l'usage.
- Envois en masse, lettres d'information, campagnes : une boîte démarre à 5 e-mails par jour et monte à 20 en quatre semaines.
- Besoin de volume dès le premier jour.
- Accès IMAP ou SMTP à la boîte, pièces jointes, plusieurs destinataires par message : non proposés.
- Besoin d'un prix publié : aucun ne l'est pendant la bêta.

## Produit

- [Subagent Mail](https://subagent.fr/index.md): ce qu'est le produit, les six règles d'envoi et leurs seuils, comment brancher un agent, ce qui est ouvert et ce qui est privé.
- [Brancher mon agent](https://subagent.fr/demarrer.md): l'adresse du MCP, l'inscription par l'agent, le code à 6 chiffres, la boîte d'essai et ses limites, la demande d'invitation.
- [Tarifs](https://subagent.fr/tarifs.md): aucun prix publié ; les unités prévues (boîtes, volume d'e-mails).
- [Open source](https://subagent.fr/open-source.md): les clients prévus sur GitHub (MCP, SDK, CLI, skills), marqués [à venir] ; le serveur reste privé.

## Documentation

- [Introduction](https://subagent.fr/docs/index.md): Ce qu'est Subagent Mail, ses objets (boîte, fil, message, brouillon, clé, espace), ce qui est en service et ce qui est à venir.
- [Démarrer](https://subagent.fr/docs/demarrer.md): De l'adresse du MCP au premier envoi : brancher le serveur, s'inscrire avec sign_up, vérifier avec le code à 6 chiffres, écrire un premier e-mail.
- [Boîtes](https://subagent.fr/docs/boites.md): Une boîte est une adresse e-mail pilotée par un agent : boîte d'essai, montée progressive, quota du jour, et les outils inbox_status, list_inboxes, create_inbox, delete_inbox.
- [Messages](https://subagent.fr/docs/messages.md): Écrire un premier message avec send_email, suivre ses statuts, lire son journal avec get_message, l'annuler, réessayer sans doublon avec une idempotency_key.
- [Fils](https://subagent.fr/docs/fils.md): Un fil est la conversation entre une boîte et un correspondant : statuts, réception des réponses, et les outils list_threads, get_thread, reply_to_thread.
- [Brouillons et validation](https://subagent.fr/docs/brouillons.md): Un envoi peut attendre une validation humaine : quand un message reste brouillon, qui peut le valider, et les outils list_drafts, update_draft, approve_message.
- [Règles d'envoi](https://subagent.fr/docs/regles-envoi.md): Ce que le serveur applique à chaque envoi, seuil par seuil : montée progressive, quota du jour, heures ouvrées, validation humaine, désinscription, coupe-circuit, limites d'essai.
- [Domaines](https://subagent.fr/docs/domaines.md): Le domaine commun d'essai subagentmail.fr, et l'enregistrement de votre propre domaine : les enregistrements DNS à publier, et les outils add_domain, verify_domain, list_domains, remove_domain.
- [Désinscription et blocages](https://subagent.fr/docs/desinscription.md): Le lien de désinscription en un clic, la réponse STOP, la liste de blocage d'un espace, et les outils add_suppression, remove_suppression, list_suppressions.
- [Webhooks](https://subagent.fr/docs/webhooks.md): Les événements que le serveur signale par webhook signé (départ, remise, rebond, réponse, désinscription), leur forme, leur signature, et ce qui reste à venir.
- [Erreurs](https://subagent.fr/docs/erreurs.md): La forme d'un refus (code stable, message en français, piste), ce qui n'est pas une erreur, et chaque code du serveur avec ce qu'il faut faire.
- [FAQ](https://subagent.fr/docs/faq.md): Les questions qu'on pose sur Subagent Mail : l'accès, la clé, le code, le rythme des envois, la validation, la désinscription, les prix.
- [Pour les agents](https://subagent.fr/docs/agents.md): Pour un agent IA qui découvre Subagent Mail : où se brancher, quoi appeler d'abord, les règles à connaître, et tous les outils du MCP sur une page.

## Optional

- [Mentions légales](https://subagent.fr/mentions-legales.md): éditeur et hébergeur du site.
- [Confidentialité](https://subagent.fr/confidentialite.md): ce que le site et le service font des données personnelles.
- [Organisation GitHub](https://github.com/subagent-fr): aucun dépôt public pour l'instant.