Référence des outils

Chaque outil qu'un assistant connecté peut appeler, regroupé de la même façon que le serveur les enregistre. Un outil n'est proposé à l'assistant que si votre connexion détient la portée dont il a besoin — il n'existe pas d'outil d'écriture présent mais qui échoue systématiquement ; si vous n'avez pas accordé contacts:write, l'assistant ne voit tout simplement pas upsert_contacts. Voir Portées et autorisations pour ce que chaque portée signifie.

Destructive dans les tableaux ci-dessous est la même annotation MCP que le processus de revue de Claude exige — elle marque un outil dont l'effet ne peut pas être annulé trivialement (supprimer un projet, écraser une arborescence, retirer un contact), pas « dangereux » dans un sens plus vague. Chaque outil d'écriture ne prend toujours que les champs auxquels on s'attendrait ; aucun n'accepte de charge brute par laquelle le modèle pourrait faire passer des modifications arbitraires en contrebande.

Découverte

Outil	Portée	Notes
`search`	l'une de `projects:read` / `templates:read` / `contacts:read`	Recherche parmi les projets, modèles et listes de contacts par nom. Renvoie des identifiants opaques pour `fetch`. C'est l'outil qu'un client capable de recherche approfondie appelle automatiquement.
`fetch`	identique à `search`	Résout un identifiant issu de `search` en son contenu complet.

Conception d'email

Outil	Portée	Destructive	Notes
`list_projects`	`projects:read`		Identifiant, nom, objectif pour chaque projet.
`get_email`	`projects:read`		L'arborescence de blocs et le thème actuels d'un projet.
`preview_email`	`projects:read`		Rendu via le véritable pipeline HTML d'envoi — le document exact qu'un envoi produirait. Associé à un widget (voir ci-dessous).
`list_block_types`	`projects:read`		Le catalogue complet de 44 blocs, généré à partir du registre en direct — toujours à jour, jamais maintenu à la main.
`list_templates`	`projects:read`		Vos modèles enregistrés, ou la galerie communautaire approuvée.
`create_project`	`projects:write`		Optionnellement amorcé depuis un modèle d'objectif intégré.
`add_block` / `update_block` / `move_block`	`projects:write`		Modifications de l'arborescence, validées par `canPlace`/champ de la même façon que les modifications du copilote intégré au studio.
`remove_block`	`projects:write`	✓	Supprime un bloc et ses enfants.
`set_theme`	`projects:write`		Couleurs de marque, police, rayon des boutons.
`rename_project`	`projects:write`
`delete_project`	`projects:write`	✓	Permanent.
`apply_template`	`projects:write`	✓	Écrase l'ensemble de l'arborescence et du thème du projet.
`save_as_template`	`templates:write`		Capture le projet actuel dans un modèle réutilisable.
`publish_landing_page`	`projects:write`		Publie un e-mail comme page web publique à l'adresse `/lp/<slug>` et renvoie son URL. L'assistant a pour consigne de vous montrer l'e-mail et d'obtenir votre accord d'abord, comme pour un envoi.
`unpublish_landing_page`	`projects:write`		Retire la page. L'adresse reste réservée pour vous.

Audience

Outil	Portée	Destructive	Notes
`list_data_sources`	`contacts:read`		Chaque source de données, listes de contacts comprises. Les valeurs d'identifiants ne sont jamais renvoyées.
`list_contact_lists`	`contacts:read`		Les listes de contacts spécifiquement — identifiant, nom, champs, nombre de lignes.
`get_contact_list_summary`	`contacts:read`		Comptes, totaux de suppression et répartition de la vérification des e-mails, plus l'état de la dernière revérification — aucune donnée de contact individuelle.
`find_contacts`	`contacts:read`		Recherche bornée (≤25 lignes, paginée par curseur). `sortBy: "engagementScore"` renvoie d'abord les contacts les plus chauds de la liste, avec leur score et l'évolution de la semaine. Chaque appel est écrit dans le journal d'accès aux données personnelles, comme une lecture de contact depuis le tableau de bord.
`upsert_contacts`	`contacts:write`		Ajoute ou met à jour des lignes ; applique le plafond de contacts de votre forfait.
`remove_contact`	`contacts:write`	✓	Retire une ligne de façon permanente.
`add_suppression` / `remove_suppression`	`contacts:write`		Bloque ou débloque une adresse à l'échelle du compte, même effet que le propre lien de désabonnement d'un destinataire.

Résultats

Outil	Portée	Destructive	Notes
`get_campaign_results`	`analytics:read`		Ouvertures/clics/réponses/revenus, comparaison de variantes A/B, carte de chaleur des clics. Synthétisé uniquement — jamais les événements bruts par destinataire. Associé à un widget.
`get_form_responses`	`analytics:read`		Synthèses par question ; les réponses en texte libre sont un échantillon plafonné et encadré.
`list_orders`	`analytics:read`		Commandes de paiement du bloc Produit.
`list_campaign_sends`	`analytics:read`		Envois groupés passés, du plus récent au plus ancien.
`list_schedules`	`analytics:read`		Envois récurrents configurés sur un projet.
`mark_order_fulfilled`	`commerce:write`		Marque une commande physique comme expédiée et envoie un email à l'acheteur.
`create_schedule`	`campaigns:send`		Configure un nouvel envoi récurrent.
`set_schedule_enabled`	`campaigns:send`	✓	Marqué destructif car désactiver une programmation active arrête les envois futurs silencieusement.

Envoi

Outil	Portée	Destructive	Notes
`send_test_email`	`campaigns:read`		Une seule copie préfixée `[Test]` vers une adresse que vous spécifiez — ne touche pas votre audience réelle et n'a pas besoin de `campaigns:send`.
`prepare_send`	`campaigns:send`		En lecture seule par annotation — résout l'audience et génère un aperçu, n'envoie rien. Renvoie un `confirmationToken`, et le nombre de contacts qui seront ignorés pour adresse invalide ou absence de consentement. Associé à un widget (carte de confirmation d'envoi).
`confirm_send`	`campaigns:send`	✓	Exige le `confirmationToken` exact renvoyé par `prepare_send`, inchangé, dans un délai de 10 minutes. Voir Sécurité pour comprendre pourquoi.

Messagerie et tickets

Outil	Portée	Notes
`list_mailbox_threads` / `get_mailbox_thread`	`mailbox:read`	Courrier entrant sur votre domaine vérifié. Les corps de message sont encadrés comme du contenu non fiable, rédigé par le destinataire.
`reply_to_mailbox_thread`	`mailbox:write`	Envoie depuis l'adresse de messagerie exacte où le courrier original est arrivé, correctement enchaîné.
`list_tickets` / `get_ticket`	`mailbox:read`	Conversations de tickets d'assistance. Même encadrement du contenu non fiable.
`reply_to_ticket`	`mailbox:write`	Ajoute un message du propriétaire et envoie un email au destinataire avec un lien de retour.

Parcours et segments

Outil	Portée	Destructive	Notes
`list_journeys`	`journeys:read`		Id, nom, activé ou non, type de déclencheur et nombre d'étapes de chaque parcours.
`get_journey`	`journeys:read`		Le déroulé complet d'un parcours, avec les noms de vos e-mails, listes et segments, et tout ce qui l'empêcherait de s'exécuter. Pour un parcours désactivé et prêt à tourner, renvoie aussi un `enableToken`.
`list_segments`	`journeys:read`		Les segments enregistrés, avec leur liste de contacts et leurs règles.
`create_segment`	`journeys:write`		Enregistre un segment sur une liste de contacts. Respecte la limite de segments de votre forfait.
`build_journey`	`journeys:write`		Crée un parcours, ou modifie un parcours désactivé, à partir d'une demande en langage courant, avec le copilote IA du générateur de parcours. Consomme un tour du copilote IA. Le résultat est toujours enregistré désactivé, et un parcours activé n'est jamais modifié.
`set_journey_enabled`	`journeys:write` (+ `campaigns:send` pour activer)	✓	Activer un parcours exige l'`enableToken` renvoyé par `get_journey`, inchangé, dans un délai de 10 minutes et sans modification entre-temps. Même principe en deux étapes que `prepare_send`/`confirm_send`. La mise en pause n'exige ni l'un ni l'autre.

Compte

Outil	Portée	Notes
`get_plan_usage`	aucune — toujours disponible	Forfait, quotas et utilisation du mois en cours. En lecture seule, et pas une donnée de compte sensible comme le sont les projets/contacts/messagerie, donc disponible quelles que soient les portées que vous avez accordées.

Widgets

Trois outils associent un widget interactif sur les hôtes qui prennent en charge les MCP Apps (Claude — Gemini n'a pas de couche de widget et reçoit toujours le résultat en texte brut/JSON à la place) : preview_email (aperçu d'email bureau/mobile en direct), get_campaign_results (tableau de bord de résultats), et prepare_send (la carte de confirmation d'envoi, dont le propre bouton Confirm & Send est ce qui appelle réellement confirm_send).