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

# Référence des outils

> Les 71 outils du serveur, un par page. Chaque page est produite depuis le registre du serveur : elle dit ce que dit `https://api.subagent.fr/openapi.json`, dans le même ordre que `tools/list`.

Chaque outil s'appelle de deux façons, avec les mêmes arguments et le même résultat : par MCP sur `https://api.subagent.fr/mcp`, ou par `POST https://api.subagent.fr/v1/{opération}`. Voir [Serveur MCP](https://escouade.io/mail/docs/mcp.md) et [API HTTP](https://escouade.io/mail/docs/api-http.md).

## Inscription et vérification

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`sign_up`](https://escouade.io/mail/docs/reference/sign_up.md) | sans clé | Ouvre un espace : rend une clé et une première boîte. |
| [`verify`](https://escouade.io/mail/docs/reference/verify.md) | toute clé | Vérifie l'espace avec le code à 6 chiffres. |
| [`attach_human`](https://escouade.io/mail/docs/reference/attach_human.md) | toute clé | Rattache l'e-mail de l'humain, ou lui renvoie un code. |

## Établi et navigation

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`open_workspace`](https://escouade.io/mail/docs/reference/open_workspace.md) | toute clé | Ouvre une fois l’établi de la conversation et sa première page. |
| [`navigate_workspace`](https://escouade.io/mail/docs/reference/navigate_workspace.md) | toute clé | Demande une autre page dans le même établi, sans carte supplémentaire. |
| [`workspace_events`](https://escouade.io/mail/docs/reference/workspace_events.md) | toute clé | Synchronise une instance depuis la vue ; cet outil est masqué au modèle. |

## Forfait et paiement

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`billing_status`](https://escouade.io/mail/docs/reference/billing_status.md) | toute clé | Dit où en est le forfait : période, usage, prélèvement, factures. |
| [`subscribe`](https://escouade.io/mail/docs/reference/subscribe.md) | toute clé | Remet le lien de paiement à donner à l'humain. |
| [`cancel_subscription`](https://escouade.io/mail/docs/reference/cancel_subscription.md) | `approve` | Arrête le prélèvement mensuel du forfait. |

## Boîtes

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`inbox_status`](https://escouade.io/mail/docs/reference/inbox_status.md) | toute clé | Dit où l'on est : espace, permissions, créneau, forfait, quota du jour de chaque boîte. |
| [`activity_report`](https://escouade.io/mail/docs/reference/activity_report.md) | `read` ou `approve` | Dit ce qui attend une décision, et ce que les boîtes ont envoyé et reçu : aujourd'hui, ou sur sept jours. |
| [`list_inboxes`](https://escouade.io/mail/docs/reference/list_inboxes.md) | toute clé | Liste les boîtes de la clé. |
| [`create_inbox`](https://escouade.io/mail/docs/reference/create_inbox.md) | `manage_inboxes` | Crée une boîte sur un domaine de l'espace. |
| [`update_inbox`](https://escouade.io/mail/docs/reference/update_inbox.md) | `manage_inboxes` | Change le nom affiché d'une boîte. |
| [`delete_inbox`](https://escouade.io/mail/docs/reference/delete_inbox.md) | `manage_inboxes` | Supprime une boîte. Irréversible. |
| [`request_inbox_review`](https://escouade.io/mail/docs/reference/request_inbox_review.md) | `approve` | Demande la reprise d'une boîte suspendue : un administrateur d'Escouade Mail décide. |
| [`create_app_password`](https://escouade.io/mail/docs/reference/create_app_password.md) | `approve` | Crée le mot de passe d'application d'un téléphone ou d'Escouade sur une boîte. Il est rendu une seule fois. |
| [`list_app_passwords`](https://escouade.io/mail/docs/reference/list_app_passwords.md) | `approve` | Liste les mots de passe d'application d'une boîte, sans leur secret. |
| [`revoke_app_password`](https://escouade.io/mail/docs/reference/revoke_app_password.md) | `approve` | Retire un mot de passe d'application : l'appareil ne se connecte plus. Sans retour. |

## Domaines

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`add_domain`](https://escouade.io/mail/docs/reference/add_domain.md) | `manage_inboxes` | Enregistre un domaine et rend les enregistrements DNS à publier. |
| [`verify_domain`](https://escouade.io/mail/docs/reference/verify_domain.md) | `manage_inboxes` | Contrôle les enregistrements DNS d'un domaine. |
| [`list_domains`](https://escouade.io/mail/docs/reference/list_domains.md) | `manage_inboxes` ou `read` | Liste les domaines de l'espace et leur état. |
| [`remove_domain`](https://escouade.io/mail/docs/reference/remove_domain.md) | `manage_inboxes` | Retire un domaine. Irréversible. |
| [`inspect_domain`](https://escouade.io/mail/docs/reference/inspect_domain.md) | `manage_inboxes` | Regarde où un domaine reçoit déjà son courrier, avant de l'enregistrer. |
| [`domain_quality`](https://escouade.io/mail/docs/reference/domain_quality.md) | `read` ou `manage_inboxes` | Dit la qualité d'envoi d'un domaine sur 7 ou 30 jours. |

## Écrire et lire

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`send_email`](https://escouade.io/mail/docs/reference/send_email.md) | `send` | Écrit un premier message à un destinataire. |
| [`list_threads`](https://escouade.io/mail/docs/reference/list_threads.md) | `read` | Liste les fils, les plus récents d'abord. |
| [`get_thread`](https://escouade.io/mail/docs/reference/get_thread.md) | `read` | Lit un fil en entier. |
| [`reply_to_thread`](https://escouade.io/mail/docs/reference/reply_to_thread.md) | `send` | Répond ou relance dans un fil. |
| [`classify_thread`](https://escouade.io/mail/docs/reference/classify_thread.md) | `send` ou `approve` | Classe un fil : tags, archive, lu ou non lu. |
| [`close_thread`](https://escouade.io/mail/docs/reference/close_thread.md) | `send` ou `approve` | Clôt un fil traité : il sort de ce qui attend une réponse. |
| [`get_message`](https://escouade.io/mail/docs/reference/get_message.md) | `read` | Lit un message et son journal. |

## Brouillons et validation

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`list_drafts`](https://escouade.io/mail/docs/reference/list_drafts.md) | `read` ou `approve` | Liste les brouillons à valider. |
| [`update_draft`](https://escouade.io/mail/docs/reference/update_draft.md) | `send` ou `approve` | Corrige un brouillon. |
| [`approve_message`](https://escouade.io/mail/docs/reference/approve_message.md) | `approve` | Valide un brouillon : il passe en file. |
| [`cancel_message`](https://escouade.io/mail/docs/reference/cancel_message.md) | `send` ou `approve` | Annule un brouillon ou un message en file. |

## Pièces jointes et copies

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`attach_files`](https://escouade.io/mail/docs/reference/attach_files.md) | `send` | Rend un lien de dépôt pour joindre des fichiers à un brouillon. |
| [`remove_attachment`](https://escouade.io/mail/docs/reference/remove_attachment.md) | `send` ou `approve` | Retire une pièce d'un brouillon. |
| [`get_attachment`](https://escouade.io/mail/docs/reference/get_attachment.md) | `read` | Lit une pièce jointe : son nom, sa taille, un lien de téléchargement. |

## Liste de blocage

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`add_suppression`](https://escouade.io/mail/docs/reference/add_suppression.md) | `send` ou `approve` | Bloque une adresse ou un domaine. |
| [`remove_suppression`](https://escouade.io/mail/docs/reference/remove_suppression.md) | `approve` | Lève un blocage ajouté à la main. |
| [`list_suppressions`](https://escouade.io/mail/docs/reference/list_suppressions.md) | `read` | Liste les adresses et domaines bloqués. |

## Espace, accès et webhook

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`get_settings`](https://escouade.io/mail/docs/reference/get_settings.md) | toute clé | Lit les réglages de l'espace : créneau, étalement, validation, webhook. |
| [`update_settings`](https://escouade.io/mail/docs/reference/update_settings.md) | `approve` | Change les réglages de l'espace. |
| [`list_keys`](https://escouade.io/mail/docs/reference/list_keys.md) | `approve` | Liste les accès à l'espace : clés des agents et assistants branchés. |
| [`create_key`](https://escouade.io/mail/docs/reference/create_key.md) | `approve` | Crée la clé d'un agent. Elle est rendue une seule fois. |
| [`revoke_key`](https://escouade.io/mail/docs/reference/revoke_key.md) | `approve` | Retire un accès à l'espace. Sans retour. |
| [`set_webhook`](https://escouade.io/mail/docs/reference/set_webhook.md) | `approve` | Déclare l'adresse qui reçoit les événements de l'espace. |
| [`remove_webhook`](https://escouade.io/mail/docs/reference/remove_webhook.md) | `approve` | Retire le webhook de l'espace. |
| [`event_feed`](https://escouade.io/mail/docs/reference/event_feed.md) | `read` | Relit par curseur les événements de l'espace, les mêmes que ses webhooks. |
| [`close_space`](https://escouade.io/mail/docs/reference/close_space.md) | `approve` | Clôt l'espace : un code reçu par son humain, puis 48 heures pendant lesquelles il peut l'annuler. |

## Contacts et audiences

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`list_contacts`](https://escouade.io/mail/docs/reference/list_contacts.md) | `read` | Cherche dans le répertoire des contacts. |
| [`get_contact`](https://escouade.io/mail/docs/reference/get_contact.md) | `read` | Lit la fiche d'un contact, ses audiences et son blocage. |
| [`save_contact`](https://escouade.io/mail/docs/reference/save_contact.md) | `send` | Crée ou modifie la fiche d'un contact. |
| [`set_contact_audiences`](https://escouade.io/mail/docs/reference/set_contact_audiences.md) | `send` | Choisit toutes les audiences d'un contact. |
| [`list_audiences`](https://escouade.io/mail/docs/reference/list_audiences.md) | `read` | Liste les audiences de l'espace. |
| [`get_audience`](https://escouade.io/mail/docs/reference/get_audience.md) | `read` | Lit les contacts d'une audience, 200 par page. |
| [`save_audience`](https://escouade.io/mail/docs/reference/save_audience.md) | `send` | Crée ou renomme une audience. |
| [`import_contacts`](https://escouade.io/mail/docs/reference/import_contacts.md) | `send` | Ajoute ou actualise de 1 à 500 contacts dans une audience. |
| [`remove_audience_contact`](https://escouade.io/mail/docs/reference/remove_audience_contact.md) | `send` | Retire une adresse d'une audience. |

## Campagnes

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`list_campaigns`](https://escouade.io/mail/docs/reference/list_campaigns.md) | `read` | Liste les campagnes de l'espace. |
| [`get_campaign`](https://escouade.io/mail/docs/reference/get_campaign.md) | `read` | Lit une campagne, ses étapes, ses performances et son historique. |
| [`save_campaign`](https://escouade.io/mail/docs/reference/save_campaign.md) | `send` | Prépare ou corrige le brouillon d'une campagne. |
| [`preview_campaign`](https://escouade.io/mail/docs/reference/preview_campaign.md) | `read` | Relit une campagne avant son lancement, sans rien envoyer. |
| [`campaign_action`](https://escouade.io/mail/docs/reference/campaign_action.md) | `send` | Lance, met en pause, reprend, arrête, archive ou duplique une campagne. |
| [`campaign_metrics`](https://escouade.io/mail/docs/reference/campaign_metrics.md) | `read` | Donne les performances d'une campagne, par étape et par variante. |
| [`campaign_history`](https://escouade.io/mail/docs/reference/campaign_history.md) | `read` | Liste les envois d'une campagne reprise d'un autre outil. |
| [`list_campaign_templates`](https://escouade.io/mail/docs/reference/list_campaign_templates.md) | `read` | Liste les modèles de campagne. |
| [`save_campaign_template`](https://escouade.io/mail/docs/reference/save_campaign_template.md) | `send` | Crée ou modifie un modèle de campagne. |

## Main courante et application

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`list_events`](https://escouade.io/mail/docs/reference/list_events.md) | `read` | Lit la main courante : qui a fait quoi, et quand. |
| [`workspace_snapshot`](https://escouade.io/mail/docs/reference/workspace_snapshot.md) | toute clé | Prépare les premières pages des rubriques de l'application. |

## Lire cette référence

- **Accès.** « sans clé » : l'outil s'appelle sans en-tête d'autorisation. « toute clé » : une clé suffit, quelles que soient ses permissions. Sinon, une des permissions citées suffit. Voir [Clés et permissions](https://escouade.io/mail/docs/cles.md).
- **État de l'espace.** Un espace ouvert par `sign_up` n'est pas vérifié tant que le code à 6 chiffres n'a pas été donné à `verify`.
- **Refus.** Un refus porte un `code` stable, un `message` en français et une piste (`hint`). Voir [Erreurs](https://escouade.io/mail/docs/erreurs.md).
- **Source.** Le serveur fait foi : `https://api.subagent.fr/openapi.json` pour les schémas, `https://api.subagent.fr/llms.txt` pour la liste courte.