> Pour un agent : la carte de la documentation d'Escouade Mail est sur https://escouade.io/mail/docs/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# Introduction

> 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](https://escouade.io/offre) ; ce qui est en service : [État du service](https://escouade.io/mail/docs/etat.md).

## 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](https://escouade.io/mail/docs/regles-envoi.md).
- **Aucune console.** Un humain lit, corrige et valide depuis son assistant, branché à l'adresse `https://mail.escouade.io/mcp`. Voir [Connecteur](https://escouade.io/mail/docs/connecteur.md).

## La consigne à donner à votre agent

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

Consigne :

```text
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, marie@exemple.fr, 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](https://escouade.io/mail/docs/agents.md) : le parcours de l'inscription à la réponse à un correspondant, sur une page. |
| Une personne qui veut brancher son agent | [Démarrer](https://escouade.io/mail/docs/demarrer.md) : de l'adresse du MCP au premier e-mail. Assistant par assistant : [Brancher mon agent](https://escouade.io/mail/docs/brancher.md). |
| Une personne sans agent, dans Claude ou ChatGPT | [Brancher Claude](https://escouade.io/mail/docs/brancher/claude.md) ou [Brancher ChatGPT](https://escouade.io/mail/docs/brancher/chatgpt.md) : elle ouvre son espace sur la page de connexion. |
| Une personne qui veut valider depuis Claude ou ChatGPT | [Connecteur](https://escouade.io/mail/docs/connecteur.md), puis [Valider les envois d'un agent](https://escouade.io/mail/docs/guide-validation.md). |
| Quelqu'un qui se demande si le service convient | [Donner une boîte mail à un agent IA](https://escouade.io/mail/docs/donner-une-boite-mail-a-un-agent.md) : ce qu'il faut, ce que l'agent fait ensuite, les limites. |
| Quelqu'un qui écrit un client | [Serveur MCP](https://escouade.io/mail/docs/mcp.md), [API HTTP](https://escouade.io/mail/docs/api-http.md), [Référence des outils](https://escouade.io/mail/docs/reference/index.md). |

## Le plan

| Partie | Pages |
|---|---|
| Démarrer | [Démarrer](https://escouade.io/mail/docs/demarrer.md), [Pour les agents](https://escouade.io/mail/docs/agents.md), [Donner une boîte mail à un agent IA](https://escouade.io/mail/docs/donner-une-boite-mail-a-un-agent.md), [État du service](https://escouade.io/mail/docs/etat.md), [Prix et paiement](https://escouade.io/offre) |
| Concepts | [Boîtes](https://escouade.io/mail/docs/boites.md), [Messages](https://escouade.io/mail/docs/messages.md), [Fils](https://escouade.io/mail/docs/fils.md), [Recevoir du courrier](https://escouade.io/mail/docs/recevoir.md), [Brouillons et validation](https://escouade.io/mail/docs/brouillons.md), [Pièces jointes et copies](https://escouade.io/mail/docs/pieces-jointes.md), [Clés et permissions](https://escouade.io/mail/docs/cles.md), [Vues](https://escouade.io/mail/docs/vues.md) |
| Envoi | [Règles d'envoi](https://escouade.io/mail/docs/regles-envoi.md), [Domaines](https://escouade.io/mail/docs/domaines.md), [Désinscription et blocages](https://escouade.io/mail/docs/desinscription.md), [Limites et quotas](https://escouade.io/mail/docs/limites.md) |
| Guides | [Répondre à un correspondant](https://escouade.io/mail/docs/guide-repondre.md), [Valider les envois d'un agent](https://escouade.io/mail/docs/guide-validation.md), [Recevoir un code de vérification](https://escouade.io/mail/docs/guide-code.md) |
| Intégrations | [Serveur MCP](https://escouade.io/mail/docs/mcp.md), [API HTTP](https://escouade.io/mail/docs/api-http.md), [Webhooks](https://escouade.io/mail/docs/webhooks.md), [Connecteur](https://escouade.io/mail/docs/connecteur.md) |
| Référence | [Tous les outils](https://escouade.io/mail/docs/reference/index.md), [Erreurs](https://escouade.io/mail/docs/erreurs.md), [FAQ](https://escouade.io/mail/docs/faq.md), [Glossaire](https://escouade.io/mail/docs/glossaire.md), [Aide](https://escouade.io/mail/docs/aide.md) |

## 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](https://escouade.io/mail/docs/boites.md). |
| 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](https://escouade.io/mail/docs/fils.md). |
| Message (`msg_…`) | Entrant ou sortant, dans un fil. Un sortant passe par `draft`, `queued`, `sending`, `sent`, `delivered`. Voir [Messages](https://escouade.io/mail/docs/messages.md). |
| Brouillon | Un message `draft` : il attend une validation humaine et se corrige tant qu'il n'est pas validé. Voir [Brouillons et validation](https://escouade.io/mail/docs/brouillons.md). |
| Domaine (`dom_…`) | Un nom de domaine enregistré par un espace pour y créer ses boîtes. Voir [Domaines](https://escouade.io/mail/docs/domaines.md). |
| Clé (`sak_…`) | Elle désigne un espace et porte des permissions : `send`, `read`, `approve`, `manage_inboxes`. Voir [Clés et permissions](https://escouade.io/mail/docs/cles.md). |
| 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](https://escouade.io/offre). |

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](https://escouade.io/mail/docs/glossaire.md).

## 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](https://escouade.io/mail/docs/mcp.md).
- **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](https://escouade.io/mail/docs/api-http.md).

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](https://escouade.io/mail/docs/connecteur.md).

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](https://escouade.io/mail/docs/etat.md).