inspect_domain · Documentation d’Escouade Mail

En bref

Propriété	Valeur
Titre	Préparer un domaine mail
Outil MCP	`inspect_domain`, sur `https://api.subagent.fr/mcp`
Appelé par	l’assistant et la vue
Appel HTTP	`POST https://api.subagent.fr/v1/inspect_domain`
Accès	permission `manage_inboxes`
État de l’espace	vérifié : sinon, refus `space_unverified`
Effet	lecture seule
Vue dans l’assistant	non

Ce que fait l’outil

Le serveur décrit l’outil ainsi à l’agent qui se branche :

Contrôle les MX et le SPF actuels avant l’enregistrement. Ne modifie rien. Si le domaine reçoit déjà ailleurs, propose un sous-domaine pour conserver les boîtes existantes.

Paramètres

inspect_domain accepte ces paramètres. Un paramètre inconnu est refusé avec le code invalid_argument.

Paramètre	Type	Obligatoire	Description
`domain`	texte	oui	Nom de domaine sans adresse mail ni URL.

Résultat

L’outil rend un texte lisible en français et un objet structuré (structuredContent). En HTTP, la réponse est cet objet.

Champ	Type	Contenu
`current_mx`	liste	Les serveurs de réception actuels du domaine : `priority` et `host`.
`current_spf`	liste	Les enregistrements SPF actuels du domaine, tels quels.
`domain`	texte	Domaine contrôlé.
`receives_elsewhere`	booléen	Des MX conduisent à un autre service.
`suggested_domain`	texte	Domaine proposé pour Subagent.

Exemple d’appel

Les valeurs sont fictives.

HTTP

curl -X POST https://api.subagent.fr/v1/inspect_domain \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "exemple.fr"
}'

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "inspect_domain",
    "arguments": {
      "domain": "exemple.fr"
    }
  }
}

Refus possibles

Aucun refus propre à cet outil. Restent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`inspect_domain`