Référence des outils · Documentation d’Escouade Mail

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 et API HTTP.

Inscription et vérification

Outil	Accès	Ce qu’il fait
`sign_up`	sans clé	Ouvre un espace : rend une clé et une première boîte.
`verify`	toute clé	Vérifie l’espace avec le code à 6 chiffres.
`attach_human`	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`	toute clé	Ouvre une fois l’établi de la conversation et sa première page.
`navigate_workspace`	toute clé	Demande une autre page dans le même établi, sans carte supplémentaire.
`workspace_events`	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`	toute clé	Dit où en est le forfait : période, usage, prélèvement, factures.
`subscribe`	toute clé	Remet le lien de paiement à donner à l’humain.
`cancel_subscription`	`approve`	Arrête le prélèvement mensuel du forfait.

Boîtes

Outil	Accès	Ce qu’il fait
`inbox_status`	toute clé	Dit où l’on est : espace, permissions, créneau, forfait, quota du jour de chaque boîte.
`activity_report`	`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`	toute clé	Liste les boîtes de la clé.
`create_inbox`	`manage_inboxes`	Crée une boîte sur un domaine de l’espace.
`update_inbox`	`manage_inboxes`	Change le nom affiché d’une boîte.
`delete_inbox`	`manage_inboxes`	Supprime une boîte. Irréversible.
`request_inbox_review`	`approve`	Demande la reprise d’une boîte suspendue : un administrateur d’Escouade Mail décide.
`create_app_password`	`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`	`approve`	Liste les mots de passe d’application d’une boîte, sans leur secret.
`revoke_app_password`	`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`	`manage_inboxes`	Enregistre un domaine et rend les enregistrements DNS à publier.
`verify_domain`	`manage_inboxes`	Contrôle les enregistrements DNS d’un domaine.
`list_domains`	`manage_inboxes` ou `read`	Liste les domaines de l’espace et leur état.
`remove_domain`	`manage_inboxes`	Retire un domaine. Irréversible.
`inspect_domain`	`manage_inboxes`	Regarde où un domaine reçoit déjà son courrier, avant de l’enregistrer.
`domain_quality`	`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`	`send`	Écrit un premier message à un destinataire.
`list_threads`	`read`	Liste les fils, les plus récents d’abord.
`get_thread`	`read`	Lit un fil en entier.
`reply_to_thread`	`send`	Répond ou relance dans un fil.
`classify_thread`	`send` ou `approve`	Classe un fil : tags, archive, lu ou non lu.
`close_thread`	`send` ou `approve`	Clôt un fil traité : il sort de ce qui attend une réponse.
`get_message`	`read`	Lit un message et son journal.

Brouillons et validation

Outil	Accès	Ce qu’il fait
`list_drafts`	`read` ou `approve`	Liste les brouillons à valider.
`update_draft`	`send` ou `approve`	Corrige un brouillon.
`approve_message`	`approve`	Valide un brouillon : il passe en file.
`cancel_message`	`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`	`send`	Rend un lien de dépôt pour joindre des fichiers à un brouillon.
`remove_attachment`	`send` ou `approve`	Retire une pièce d’un brouillon.
`get_attachment`	`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`	`send` ou `approve`	Bloque une adresse ou un domaine.
`remove_suppression`	`approve`	Lève un blocage ajouté à la main.
`list_suppressions`	`read`	Liste les adresses et domaines bloqués.

Espace, accès et webhook

Outil	Accès	Ce qu’il fait
`get_settings`	toute clé	Lit les réglages de l’espace : créneau, étalement, validation, webhook.
`update_settings`	`approve`	Change les réglages de l’espace.
`list_keys`	`approve`	Liste les accès à l’espace : clés des agents et assistants branchés.
`create_key`	`approve`	Crée la clé d’un agent. Elle est rendue une seule fois.
`revoke_key`	`approve`	Retire un accès à l’espace. Sans retour.
`set_webhook`	`approve`	Déclare l’adresse qui reçoit les événements de l’espace.
`remove_webhook`	`approve`	Retire le webhook de l’espace.
`event_feed`	`read`	Relit par curseur les événements de l’espace, les mêmes que ses webhooks.
`close_space`	`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`	`read`	Cherche dans le répertoire des contacts.
`get_contact`	`read`	Lit la fiche d’un contact, ses audiences et son blocage.
`save_contact`	`send`	Crée ou modifie la fiche d’un contact.
`set_contact_audiences`	`send`	Choisit toutes les audiences d’un contact.
`list_audiences`	`read`	Liste les audiences de l’espace.
`get_audience`	`read`	Lit les contacts d’une audience, 200 par page.
`save_audience`	`send`	Crée ou renomme une audience.
`import_contacts`	`send`	Ajoute ou actualise de 1 à 500 contacts dans une audience.
`remove_audience_contact`	`send`	Retire une adresse d’une audience.

Campagnes

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

Main courante et application

Outil	Accès	Ce qu’il fait
`list_events`	`read`	Lit la main courante : qui a fait quoi, et quand.
`workspace_snapshot`	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.
É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.
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.