# 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.

**Statut : bêta privée, sur invitation.** Aucun prix n'est publié.

- **MCP** : `https://api.subagent.fr/mcp` (Streamable HTTP). Sans clé, le serveur ne montre qu'un outil : `sign_up`.
- **Interface** : le MCP, et lui seul. Un humain passe par son assistant, branché au même serveur ; l'état des boîtes s'y affiche.
- **Pour un agent** : commencez par [/llms.txt](https://subagent.fr/llms.txt), puis [Démarrer](https://subagent.fr/docs/demarrer.md).

## Donnez-lui une adresse. Il se met au travail.

Votre agent ouvre sa boîte, envoie, lit ses fils et répond. Le MCP est la seule interface.

1. **Une adresse à lui.** Une boîte d'essai sur `subagentmail.fr`, puis des boîtes sur votre domaine. Toute boîte reçoit.
2. **Il lit et il répond.** Chaque échange avec un correspondant est un fil. Les réponses s'y rangent, et votre agent répond dans le même fil.
3. **Tout passe par le MCP.** Aucune console. Vous lisez, corrigez et validez depuis votre assistant, branché au même serveur.

Pas seulement la prospection : une boîte mail sert à répondre au support, prendre un rendez-vous, s'inscrire à un service, suivre un dossier, prospecter.

## Le serveur règle les envois

Six règles s'appliquent à la création d'un message, puis à l'envoi. Chacune retient le message ou le refuse, et la réponse dit pourquoi.

| Règle | Seuil | Effet |
|---|---|---|
| Montée progressive | 5, 10, 15, puis 20 e-mails par jour et par boîte, semaine après semaine, à partir de la création de la boîte. | Retient : au-delà du palier, l'e-mail attend le jour ouvré suivant. |
| Quota du jour | Un quota par boîte : son palier du moment. Un plafond par clé, si elle en porte un. | Retient à la boîte. Refuse à la clé : `key_daily_cap`. |
| Heures ouvrées | Par défaut du lundi au vendredi, de 9 h à 18 h, heure de Paris, jours fériés exclus. Les envois sont étalés. | Retient : un e-mail écrit le dimanche part le lundi. |
| Validation humaine | Si vous la demandez, un envoi reste brouillon. Vous le validez dans votre assistant, avec une permission que l'agent n'a pas. | Retient, jusqu'à votre validation. |
| Désinscription | Un lien en un clic (RFC 8058) dans chaque e-mail. Une réponse « STOP » vaut désinscription. | Refuse tout nouvel envoi à cette adresse : `recipient_suppressed`. |
| Coupe-circuit | Boîte suspendue au-delà de 5 % de rebonds (3 % pendant la montée progressive) ou de 0,1 % de plaintes. | Refuse jusqu'à une reprise manuelle : `inbox_suspended`. |

- **Retient** : le message attend, avec une heure.
- **Refuse** : un `code` stable, un `message` en français, une piste (`hint`).

Une réponse dans une conversation part sans attendre : dès que votre correspondant a écrit dans le fil, la réponse de votre agent n'attend pas les heures ouvrées. Elle compte toujours dans le quota du jour.

Dans les réponses du serveur, la montée progressive s'appelle « réchauffage ». Détail : [Règles d'envoi](https://subagent.fr/docs/regles-envoi.md).

## Brancher : une adresse, un code, une mission

Votre agent s'inscrit lui-même, par le MCP. Vous confirmez avec un code reçu par e-mail.

1. **Collez l'adresse du MCP.** `https://api.subagent.fr/mcp`, dans Claude Code, Cursor ou tout client MCP. Sans clé, votre agent n'y voit qu'un outil : `sign_up`.
2. **Donnez-lui le code.** Votre agent appelle `sign_up` avec votre e-mail : il reçoit sa clé et une boîte d'essai. Vous recevez un code à 6 chiffres, il le passe à `verify`.
3. **Donnez-lui une mission.** « Écris au cabinet Morel pour déplacer le rendez-vous de jeudi. Laisse le message en brouillon : je le relis. »

Claude Code :

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

Autre client (`.mcp.json`) :

```json
{
  "mcpServers": {
    "subagent": {
      "type": "http",
      "url": "https://api.subagent.fr/mcp"
    }
  }
}
```

**La boîte d'essai.** Une adresse sur le domaine commun, `subagentmail.fr`. Avant le code, elle reçoit et n'envoie pas. Ensuite : au plus 3 destinataires distincts la première heure, 5 le premier jour, 10 la première semaine, en plus des règles d'envoi.

**Ensuite.** Enregistrez votre domaine avec `add_domain` et `verify_domain` : vos boîtes portent votre nom et sortent des limites d'essai.

**Bêta privée.** Les inscriptions sont sur invitation : seul un e-mail invité reçoit le code. Pour demander une invitation, écrivez à `contact@subagent.fr`.

Guide complet : [Brancher mon agent](https://subagent.fr/demarrer.md) et [Démarrer](https://subagent.fr/docs/demarrer.md).

## Les clients sont ouverts. Le serveur reste fermé.

Ce qui se branche chez vous sera public sur GitHub. Les règles d'envoi s'appliquent sur le serveur, qui reste privé.

| Dépôt | Rôle | État |
|---|---|---|
| `subagent-mcp` | La configuration et le guide de connexion. | [à venir] |
| `subagent-python`, `subagent-node` | Les mêmes opérations que les outils du MCP, en Python et en TypeScript. | [à venir] |
| `subagent-cli` | La ligne de commande. | [à venir] |
| `subagent-skills` | Des recettes à donner à un agent. | [à venir] |
| `subagent` | Le serveur : règles d'envoi, file d'envoi, retours. | privé |

Détail : [Open source](https://subagent.fr/open-source.md). Organisation GitHub : <https://github.com/subagent-fr>.

## Liens

- [Brancher mon agent](https://subagent.fr/demarrer.md)
- [Documentation](https://subagent.fr/docs/index.md)
- [Tarifs](https://subagent.fr/tarifs.md)
- [Open source](https://subagent.fr/open-source.md)
- [Mentions légales](https://subagent.fr/mentions-legales.md) · [Confidentialité](https://subagent.fr/confidentialite.md)
- [llms.txt](https://subagent.fr/llms.txt)

Subagent : des services pour agents IA. Le premier : l'e-mail. Hébergé en France.