> Ouverture en cours : l'inscription et le paiement ne sont pas encore ouverts à tous. L'état du jour : https://subagent.fr/docs/etat.md
>
> Pour un agent : la carte du site est sur https://subagent.fr/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# Référence des outils

> Les 28 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://subagent.fr/docs/mcp.md) et [API HTTP](https://subagent.fr/docs/api-http.md).

## Inscription et vérification

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

## Forfait et paiement

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`billing_status`](https://subagent.fr/docs/reference/billing_status.md) | toute clé | Dit où en est le forfait : période, usage, prélèvement, factures. |
| [`subscribe`](https://subagent.fr/docs/reference/subscribe.md) | toute clé | Remet le lien de paiement à donner à l'humain. |
| [`cancel_subscription`](https://subagent.fr/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://subagent.fr/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://subagent.fr/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://subagent.fr/docs/reference/list_inboxes.md) | toute clé | Liste les boîtes de la clé. |
| [`create_inbox`](https://subagent.fr/docs/reference/create_inbox.md) | `manage_inboxes` | Crée une boîte sur un domaine de l'espace. |
| [`delete_inbox`](https://subagent.fr/docs/reference/delete_inbox.md) | `manage_inboxes` | Supprime une boîte. Irréversible. |
| [`request_inbox_review`](https://subagent.fr/docs/reference/request_inbox_review.md) | `approve` | Demande la reprise d'une boîte suspendue : un administrateur de Subagent décide. |

## Domaines

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`add_domain`](https://subagent.fr/docs/reference/add_domain.md) | `manage_inboxes` | Enregistre un domaine et rend les enregistrements DNS à publier. |
| [`verify_domain`](https://subagent.fr/docs/reference/verify_domain.md) | `manage_inboxes` | Contrôle les enregistrements DNS d'un domaine. |
| [`list_domains`](https://subagent.fr/docs/reference/list_domains.md) | `manage_inboxes` ou `read` | Liste les domaines de l'espace et leur état. |
| [`remove_domain`](https://subagent.fr/docs/reference/remove_domain.md) | `manage_inboxes` | Retire un domaine. Irréversible. |

## Écrire et lire

| Outil | Accès | Ce qu'il fait |
|---|---|---|
| [`send_email`](https://subagent.fr/docs/reference/send_email.md) | `send` | Écrit un premier message à un destinataire. |
| [`list_threads`](https://subagent.fr/docs/reference/list_threads.md) | `read` | Liste les fils, les plus récents d'abord. |
| [`get_thread`](https://subagent.fr/docs/reference/get_thread.md) | `read` | Lit un fil en entier. |
| [`reply_to_thread`](https://subagent.fr/docs/reference/reply_to_thread.md) | `send` | Répond ou relance dans un fil. |
| [`get_message`](https://subagent.fr/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://subagent.fr/docs/reference/list_drafts.md) | `read` ou `approve` | Liste les brouillons à valider. |
| [`update_draft`](https://subagent.fr/docs/reference/update_draft.md) | `send` ou `approve` | Corrige un brouillon. |
| [`approve_message`](https://subagent.fr/docs/reference/approve_message.md) | `approve` | Valide un brouillon : il passe en file. |
| [`cancel_message`](https://subagent.fr/docs/reference/cancel_message.md) | `send` ou `approve` | Annule un brouillon ou un message en file. |

## Liste de blocage

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

## 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://subagent.fr/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://subagent.fr/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.