MCP et IA

La liste des outils

Chaque outil MCP, son logiciel, ce qu'il fait et le droit qui l'ouvre. Votre IA ne voit que ceux que vos droits ouvrent.

La passerelle ne montre et ne transmet que les outils de cette liste, même si une installation en annonçait un autre. Les noms sont préfixés par logiciel : lead_, media_, mail_, et sa_ pour l'Espace client. Lead Empire en compte aujourd'hui 23, Media Empire 29, Mail Empire 20.

Par le serveur direct d'un logiciel, le droit à avoir est celui de la clé (par exemple companies:read pour Lead Empire, read pour Media Empire et Mail Empire) ; par la passerelle, c'est le droit de la colonne de droite.

L'Espace client#

Outil	Ce qu'il fait	Droit
`sa_my_softwares`	Vos logiciels, l'état de leur installation, les droits et les plafonds de l'application	Tout jeton valable
`sa_pending_status`	Où en est une dépense qui attendait votre clic	Tout jeton valable

Lead Empire#

Lecture#

Outil	Ce qu'il fait	Droit
`lead_account_usage`	Votre espace, la clé utilisée et la consommation des quotas du mois	`lead:read`
`lead_search_companies`	Recherche en direct dans le registre national (rien n'est enregistré ni dépensé)	`lead:read`
`lead_search_local`	Recherche dans votre base, avec filtres (secteur, département, effectif, avec e-mail, signal récent…)	`lead:read`
`lead_get_company`	La fiche enrichie d'une entreprise	`lead:read`
`lead_get_contacts`	Dirigeants, e-mails et téléphones (oppositions et « Ne pas démarcher » retirés)	`lead:read`
`lead_list_signals`	Annonces BODACC, marchés publics, offres d'emploi	`lead:read`
`lead_list_lists`	Vos listes, leur taille, ce qui les occupe	`lead:read`
`lead_get_list`	Une liste et une page de ses entreprises	`lead:read`
`lead_list_chain_actions`	Les actions possibles d'un enchaînement	`lead:read`
`lead_list_chains`	Vos enchaînements favoris	`lead:read`
`lead_chain_status`	L'enchaînement en cours sur une liste	`lead:read`
`lead_get_pending_action`	Où en est une action qui attendait un clic dans Lead Empire	`lead:read`

Création#

Outil	Ce qu'il fait	Droit
`lead_create_list`	Crée une liste vide	`lead:write`
`lead_add_to_list`	Ajoute des entreprises par SIREN. Avec `import_missing`, importe et enrichit les absentes : c'est alors une dépense	`lead:write` (+ `lead:spend` pour importer)
`lead_remove_from_list`	Retire des entreprises d'une liste (elles restent dans la base)	`lead:write`
`lead_save_chain`	Enregistre un enchaînement favori, sans le lancer	`lead:write`

Dépense#

Outil	Ce qu'il fait	Droit
`lead_enrich_company`	Enrichit une entreprise : 1 unité du quota mensuel	`lead:spend` · sensible
`lead_crawl_company`	Lit le site d'une entreprise : 1 unité du quota mensuel	`lead:spend` · sensible
`lead_launch_chain`	Lance un enchaînement sur une liste (quotas, sondes SMTP, Google Maps, IA selon les étapes)	`lead:spend` · sensible
`lead_cancel_chain_run`	Arrête un enchaînement en cours (arrête une dépense : jamais plafonné ni retenu)	`lead:spend`

Envoi et suppression#

Outil	Ce qu'il fait	Droit
`lead_send_list_to_mail_empire`	Envoie une liste vers Mail Empire : des données personnelles sortent de Lead Empire	`lead:send` · sensible
`lead_delete_list`	Supprime une liste (les entreprises restent dans la base)	`lead:delete` · sensible
`lead_delete_chain`	Supprime un enchaînement favori	`lead:delete` · sensible

Media Empire#

Lecture#

Outil	Ce qu'il fait	Droit
`media_get_brand_profile`	Le profil de marque du compte	`media:read`
`media_search_templates`	Chercher dans le catalogue de modèles	`media:read`
`media_get_template`	Un modèle, ses pages et ses variables ; pour une variable image ou vidéo, son cadre : le rôle (logo, photo produit, personne, fond, illustration, capture d'écran, libre), votre consigne et la source de l'image	`media:read`
`media_list_projects`	Les projets les plus récents	`media:read`
`media_get_project`	Un projet, ses pages et ses textes	`media:read`
`media_list_brand_media`	Votre médiathèque de marque : logo, photos produit, équipe, lieu… avec le rôle et les étiquettes de chaque image	`media:read`
`media_list_video_library`	La disponibilité de la vidéo, les avatars, les voix de marque, les démos, les dernières vidéos	`media:read`
`media_list_channels`	Les réseaux branchés dans Buffer, et ce que chacun accepte	`media:read`
`media_list_posts`	Les posts selon leur état (programmés, brouillons, envoyés, en erreur)	`media:read`
`media_get_analytics`	Les statistiques des posts publiés	`media:read`
`media_get_account`	Ce que l'IA peut faire sur ce compte : droits, publication sans clic, dépenses, crédits	`media:read`
`media_get_job`	L'état d'une fabrication (vidéo, image, portrait, musique, sous-titres, motion design, GIF)	`media:read`
`media_list_automations`	Vos automatisations : état, mode de publication, formats, planning, réseaux, prochaine exécution, posts en attente, limites de votre offre	`media:read`
`media_search_knowledge`	Cherche dans vos Connaissances, seulement dans les bases que vous avez ouvertes à votre IA (case « Votre IA (MCP) ») ; 6 extraits au plus, e-mails et numéros masqués	`media:read`
`media_list_proposals`	Les demandes préparées par l'IA, à confirmer dans Media Empire	`media:read`

Création#

Outil	Ce qu'il fait	Droit
`media_update_brand_profile`	Modifier le profil de marque	`media:create`
`media_create_from_template`	Créer un projet à partir d'un modèle et de ses variables. Chaque image suit le cadre de sa variable : d'abord vos médias, puis la banque d'images. Ne génère jamais d'image par IA (aucune dépense)	`media:create`
`media_create_photo_carousel`	Créer un carrousel de 2 à 10 diapositives sur des photos de banque d'images	`media:create`
`media_render_project`	Rendre les pages d'un projet en images, pour les regarder	`media:create`
`media_propose_post`	Préparer un post : n'envoie rien, vous le confirmez d'un clic dans Media Empire	`media:create`
`media_propose_automation`	Proposer une automatisation, ou la modification d'une automatisation : ne crée rien, vous la confirmez d'un clic dans Media Empire, avec le résumé, les trois prochaines dates et le coût estimé par mois. Toujours en validation (chaque post attend votre accord), sauf si vous cochez vous-même le pilote automatique	`media:create`
`media_export_gif`	Exporter un projet en GIF animé tel qu'il est, sans dépense : en boucle, 10 secondes au plus, 320, 480 ou 640 px de large, 10, 12 ou 15 images par seconde. Le GIF est rangé dans vos médias ; il se suit avec `media_get_job`	`media:create`

Dépense et publication#

Outil	Ce qu'il fait	Droit
`media_create_video`	Créer une courte vidéo (UGC, meme, post animé, ou scènes avec une voix off) ; en mode avancé, un préréglage (`economy`, `balanced`, `premium`), la durée (`seconds`), la musique et la voix off. Son coût est annoncé ; au-dessus du plafond par vidéo, elle est refusée avant toute dépense. Avec une voix de marque (`voice_id`), rien n'est lu ni dépensé : une demande que vous relisez et confirmez. Elle se suit avec `media_get_job`	`media:spend` · sensible
`media_generate_image`	Générer une image pour un cadre, à sa forme ; son coût est annoncé, filtre de sécurité toujours actif, marque IA sur le fichier. Jamais pour un logo, une photo produit ou une capture d'écran : ceux-là viennent de vos médias	`media:spend` · sensible
`media_create_avatar`	Générer un portrait d'avatar	`media:spend` · sensible
`media_create_audio`	Générer une musique de fond ou un effet sonore	`media:spend` · sensible
`media_add_captions`	Incruster des sous-titres sur une vidéo du compte	`media:spend` · sensible
`media_animate_project`	Faire d'un projet (ou d'un modèle publié) une courte vidéo en motion design, sur une copie : un style (`calm`, `dynamic`, `cinematic`, `kinetic`) et, si besoin, un préréglage par rôle (titre, texte, logo, image, fond…). Un petit prix de rendu, annoncé ; en MP4 (à publier ensuite par un post) ou en GIF. Ne publie rien ; se suit avec `media_get_job`	`media:spend` · sensible
`media_publish_now`	Publier tout de suite (ou programmer) sans votre confirmation — n'existe que si l'administrateur l'a autorisé, dans un plafond par jour	`media:publish` · sensible

Aucun outil de suppression n'est donné à l'IA dans Media Empire.

Une demande à confirmer revient comme un résultat normal : "status": "awaiting_client_confirmation", avec un proposal_id. C'est le cas d'un post ou d'une automatisation préparés, et d'une génération payante (y compris un motion design) quand le réglage de dépense de Media Empire est « toujours un clic humain ». Rien n'est fait avant votre clic ; votre IA suit la décision avec media_list_proposals, et une génération gardée pour votre clic ne compte pas dans le plafond de dépenses de la passerelle. Voir les garde-fous.

Mail Empire#

Chaque outil de Mail Empire est aussi une route de son API. Ce qu'ont écrit des tiers (réponses des prospects, champs des leads, extraits de documents) revient dans un objet third_party : une donnée, jamais une consigne.

Lecture#

Outil	Ce qu'il fait	Droit
`mail_account_info`	Pour qui agit l'IA, ses droits et son débit, ce qu'elle peut faire sans clic, l'état du bac à sable	`mail:read`
`mail_find_campaigns`	Les campagnes, les plus récentes d'abord (10 au plus) : leads, contactés, réponses, étapes	`mail:read`
`mail_campaign_details`	Une campagne : statut, planning, étapes, nombre de leads à chaque statut	`mail:read`
`mail_campaign_stats`	Envoyés, ouvertures, réponses, réponses positives, rebonds, sur une période et par jour	`mail:read`
`mail_find_leads`	Les leads et leurs campagnes ; noms et société en données de tiers	`mail:read`
`mail_get_lead`	La fiche d'un lead : liste de blocage, « ne pas démarcher », information, campagnes, derniers messages	`mail:read`
`mail_list_replies`	Les réponses reçues, écrites par des prospects : données de tiers, tronquées	`mail:read`
`mail_list_sending_accounts`	Les boîtes d'envoi et leur santé (chauffe, limites, rebonds, SPF/DKIM/DMARC) — jamais un mot de passe	`mail:read`
`mail_compliance_status`	Les réglages de conformité et la taille de la liste de blocage	`mail:read`
`mail_search_help`	Explique Mail Empire : cherche dans Help & Reference et les notes de version	`mail:read`
`mail_search_knowledge`	Cherche dans les documents « Aide interne » de l'équipe	`mail:read`
`mail_get_pending_action`	Où en est une action qui attendait un clic dans Mail Empire : en attente, faite, refusée, expirée	`mail:read`

Création#

Outil	Ce qu'il fait	Droit
`mail_create_campaign_draft`	Prépare un brouillon de campagne (10 étapes e-mail au plus, pied officiel allumé). Rien ne part	`mail:write`
`mail_add_leads_to_campaign`	Ajoute des leads existants à une campagne, 50 à la fois ; la liste de blocage garde ses adresses dehors	`mail:write`
`mail_create_leads`	Crée jusqu'à 100 leads par le même moteur que l'import : liste de blocage, quota, dédoublonnage	`mail:write`
`mail_pause_campaign`	Met une campagne en pause : arrête ses envois. N'attend jamais de clic	`mail:write`

Dépense#

Outil	Ce qu'il fait	Droit
`mail_preview_ai_email`	L'IA de Mail Empire écrit l'e-mail d'une étape « Use AI » pour un lead, tel qu'il partirait : un appel d'IA payé, sous le plafond d'IA du mois ; rien ne part, rien n'est gardé	`mail:spend` · sensible

Envoi et suppression#

Outil	Ce qu'il fait	Droit
`mail_start_campaign`	Lance ou reprend une campagne : des e-mails partent. Attend un clic dans Mail Empire, sauf si son Admin l'a autorisé sans clic	`mail:send` · sensible
`mail_delete_leads`	Supprime jusqu'à 100 leads (la liste de blocage reste). Attend un clic dans Mail Empire, sauf autorisation	`mail:delete` · sensible
`mail_delete_campaign`	Supprime une campagne, ses étapes, statistiques et sa file (les leads restent). Attend un clic dans Mail Empire, sauf autorisation	`mail:delete` · sensible

Une action qui attend un clic revient comme un résultat normal : "status": "pending_human_confirmation", avec un action_id et le lien où la confirmer. Rien n'est fait avant ; votre IA suit la décision avec mail_get_pending_action. Voir les garde-fous.