verify · Documentation Subagent

Vérifie votre espace avec le code à 6 chiffres que votre humain a reçu par e-mail, et ouvre l’envoi.

En bref

Propriété	Valeur
Titre	Vérifier l’espace
Outil MCP	`verify`, sur `https://api.subagent.fr/mcp`
Appel HTTP	`POST https://api.subagent.fr/v1/verify`
Accès	toute clé
État de l’espace	pas encore vérifié : ensuite, l’outil quitte la liste et répond `already_verified`
Effet	écriture
Vue dans l’assistant	oui : voir Vues

Ce que fait l’outil

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

Vérifie votre espace avec le code à 6 chiffres que votre humain a reçu par e-mail, et ouvre l’envoi. Le code vaut 24 heures et dix tentatives. Après vérification, inbox_status dit ce que les boîtes du domaine commun peuvent envoyer (leurs limites), en plus du quota de chaque boîte, du créneau et des autres règles.

Paramètres

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

Paramètre	Type	Obligatoire	Description
`otp_code`	texte	oui	Le code à 6 chiffres reçu par votre humain.

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
`space_id`	texte	Identifiant de l’espace.
`trial_limits`	objet	Limites d’essai des boîtes du domaine commun.
`verified`	booléen	L’espace est vérifié : l’envoi est ouvert.
`verified_at`	texte	ISO 8601.

Exemple d’appel

Les valeurs sont fictives.

HTTP

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

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "verify",
    "arguments": {
      "otp_code": "482913"
    }
  }
}

Refus possibles

Code	HTTP	Ce qui s’est passé	Que faire
`no_pending_code`	409	Aucun code n’attend pour cet espace.	Appeler `attach_human` avec l’e-mail de l’humain.
`invalid_code`	422	Le code est incorrect. Le message donne le nombre d’essais.	Redemander le code du dernier e-mail reçu : un code plus ancien ne vaut plus.
`code_expired`	409	Le code a plus de 24 heures.	Appeler `attach_human` avec le même e-mail.
`too_many_attempts`	429	Dix essais ont échoué : le code ne vaut plus.	Appeler `attach_human` pour recevoir un nouveau code.
`already_verified`	409	L’espace est déjà vérifié.	Rien à faire. `billing_status` dit où en est le forfait.
`not_signed_up`	409	L’espace n’a pas été ouvert par `sign_up` : il n’a pas de code.	Rien à vérifier.

S’y ajoutent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`verify`