Meta Ads MCP — Les 59 fonctions expliquées
Référentiel pédagogique complet de l'ensemble des outils de l'API Meta Ads connectés via le protocole MCP. Pour chaque fonction : rôle, usage, paramètres clés, et points de vigilance.
Compte & Account Management
5 fonctionsPoint d'entrée de tout workflow Meta Ads. Ces outils permettent de découvrir les comptes accessibles, interroger leur structure, lire les performances, comprendre les champs disponibles et diagnostiquer les erreurs bloquantes.
Liste l'ensemble des comptes publicitaires auxquels l'utilisateur a accès, avec leur statut, devise, business owner, et capacité MCP activée.
Tool central de reporting. Récupère les entités d'un compte (account / campaign / adset / ad) avec leurs métriques (CTR, CPM, ROAS, conversions...), avec filtres, tri, breakdowns par device/pays/placement, et fenêtres temporelles configurables.
ads_get_field_context avant l'appel.Récupère les erreurs bloquant la diffusion d'une campagne, ad set ou ad. Ces erreurs empêchent la publication ou la delivery.
Retourne les métadonnées d'un champ Meta Ads (type, description, filtrable, triable, niveaux où le champ existe, opérateurs et valeurs supportés).
ads_get_ad_entities — vérifier qu'un champ est valide pour le niveau interrogé et connaître les opérateurs de filtre disponibles.Récupère les articles d'aide du Help Center Meta Business pertinents pour une question donnée sur la publicité.
Pages Facebook
3 fonctionsLes Pages Facebook sont indispensables pour publier des créatifs et lancer des ads. Ces 3 tools permettent de découvrir les Pages liées à l'utilisateur, au business ou à un compte publicitaire spécifique.
Récupère les IDs des Pages Facebook associées à un compte publicitaire (Pages promues sous ce compte).
Récupère les Pages Facebook détenues par un Business Manager donné.
Récupère toutes les Pages Facebook que l'utilisateur courant peut utiliser pour faire de la publicité.
Campagne / Ad Set / Ad
5 fonctionsLe cœur opérationnel : création, modification, activation des trois niveaux de la hiérarchie publicitaire Meta. Les entités sont créées en statut PAUSED par défaut — il faut les activer explicitement.
Crée une campagne (campaign group) en statut PAUSED. Définit l'objectif marketing (OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC, OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_APP_PROMOTION) et la stratégie d'enchère.
valid_optimization_goals à utiliser pour les ad sets enfants — toujours s'y référer pour éviter les rejets.Crée un ad set sous une campagne existante. Définit le ciblage (geo, age, gender, interests, custom audiences), le budget, l'optimization goal, le placement, le bid strategy, et le promoted object (pixel/event pour les conversions).
promoted_object pour les goals de conversion, ne pas passer de budget ad set si la campagne est en CBO.Crée une ad (annonce individuelle) sous un ad set existant. Lie un créatif (existing creative_id, post existant, ou spec inline) à un ad set.
Modifie n'importe quel champ d'une campagne, ad set ou ad existant (nom, budget, ciblage, créatif, planning, statut).
Active une entité (passe son statut de PAUSED à ACTIVE) — c'est l'action qui PUBLIE et démarre la dépense.
Créatifs publicitaires
5 fonctionsLes créatifs (creatives) sont les unités visuelles et textuelles d'une ad. Ces tools permettent de les créer, les lister, prévisualiser leur rendu sur chaque placement, et lister les ads qui les utilisent.
Crée un ad creative selon 3 formats : image unique, vidéo unique, ou carousel Advantage+ catalogue (alimenté par un product set).
Liste les créatifs d'un compte publicitaire. Sans creative_ids, retourne seulement id/name/account_id/status. Pour les détails (body, title, link_url, image_hash...), il faut spécifier les IDs ou les champs explicitement.
À partir d'un créatif, liste toutes les ads (adgroups) qui l'utilisent. Outil de traçabilité créatif → diffusion.
Génère une prévisualisation visuelle d'un créatif ou d'une ad sur un placement spécifique (Facebook Feed, Instagram Feed, Story, Reels, Messenger, Threads...).
Listent respectivement les images et vidéos uploadées dans la bibliothèque média d'un compte publicitaire.
image_hash ou video_id nécessaires pour créer de nouveaux créatifs sans réuploader le média.Custom Audiences
7 fonctionsLes audiences personnalisées sont la clé du retargeting et du ciblage avancé. 3 types supportés : CUSTOM (listes CRM uploadées), WEBSITE (pixel WCA), ENGAGEMENT (engageurs IG/FB/Shop).
Crée une audience selon 3 subtypes : CUSTOM (liste clients à peupler par upload), WEBSITE (règles pixel, auto-peuplée), ENGAGEMENT (engageurs IG / Page FB / Shop, auto-peuplée).
Détails d'une audience spécifique : taille, statut de livraison, type, dates création/MAJ, code de statut opérationnel.
Liste toutes les audiences d'un compte, filtrable par type (CUSTOM, WEBSITE, LOOKALIKE, APP, ENGAGEMENT, OFFLINE_CONVERSION).
Liste tous les ad sets qui utilisent une audience donnée dans leur ciblage.
ads_delete_custom_audience — savoir quels ad sets vont être mis en pause automatiquement.Met à jour les métadonnées d'une audience existante (nom, description).
Ajoute ou retire des utilisateurs d'une Data File Custom Audience (liste CRM). Accepte les PII bruts ou pré-hashés — le tool normalise et hashe en SHA-256 automatiquement.
Supprime DÉFINITIVEMENT une audience. Les ad sets qui l'utilisent sont automatiquement mis en pause.
ads_get_custom_audience_adsets en amont, (2) si l'audience a des Lookalikes dérivés, les supprimer d'abord, (3) confirmer explicitement avec l'utilisateur.Datasets / Pixels (signaux)
5 fonctionsLes datasets (alias "pixels" ou "applications") sont les sources de signaux de conversion. Ces outils permettent d'auditer leur configuration, leur qualité (EMQ), leur volume d'événements, et les conversions personnalisées qui en dérivent.
Liste les datasets (pixels et apps) accessibles par un business ou un compte publicitaire, avec nom, statut, date de création et dernière activation.
dataset_id à utiliser pour les autres tools.Métadonnées d'identité et de configuration d'un pixel : nom, statut, date de création, business propriétaire, paramètres data-use, statut first-party cookie.
Métriques de qualité du signal d'un pixel : EMQ (Event Match Quality, 0-10), couverture par match key (email, phone, IP, fbp...), fraîcheur des données, par canal (web, offline, CRM, custom_attribution).
Statistiques de volume d'événements d'un pixel sur une fenêtre temporelle (max 28 jours). Aggregation par event, device, source (WEB_ONLY vs SERVER_ONLY), URL, host.
Liste les Custom Conversions d'un compte publicitaire (règles personnalisées dérivées d'événements pixel : URL spécifique, valeur seuil, segmentation).
promoted_object d'ad set.Événements Pixel (CRUD)
4 fonctionsPour ajouter des événements de conversion sans toucher au code du site (Event Setup Tool — EST). Permet de créer des règles d'événements basées sur des clics boutons (TOKENIZED_BUTTON_TEXT) ou URLs (URL). Tous les tools sont batch-capables.
Crée des règles d'événements Pixel — soit déclenchées par un texte de bouton (Purchase, AddToCart...), soit par une URL (page de confirmation). Permet d'embarquer des paramètres (value, currency, content_ids) atomiquement.
Lit les règles d'événements Pixel — un événement spécifique par event_rule_id, ou toutes les règles d'un pixel.
Met à jour le statut d'une règle d'événement (ACTIVE / INACTIVE). Currently status-only.
facebook.com/tr.Supprime des règles d'événements Pixel. Soft-delete pour les règles MCP/API, hard-delete pour les règles créées via l'UI Events Manager.
ads_pixel_parameter_delete.Paramètres Pixel (CRUD)
4 fonctionsLes paramètres pixel sont les extracteurs de données qui enrichissent les événements (value, currency, content_ids...). Deux types d'extracteurs : CSS (lecture du DOM via sélecteur) ou CONSTANT_VALUE (valeur fixe hardcodée).
Crée des extracteurs de paramètres pixel. CSS lit element.innerText du premier nœud DOM match. CONSTANT_VALUE hardcode une valeur fixe (typique pour currency='EUR').
Lit les extracteurs de paramètres d'un pixel — un par parameter_id, ou tous (filtrables par event_type / domain_uri).
Met à jour un extracteur existant (sélecteur CSS, valeur constante, event_rule_id de liaison).
Supprime des extracteurs de paramètres (soft-delete). N'affecte pas la règle d'événement liée.
Catalogues produits (e-commerce)
14 fonctionsLe module le plus dense — destiné aux acteurs e-commerce. Permet de gérer les catalogues produits, les flux de données (feeds), les règles de transformation, les product sets, et la recherche/diagnostic produit. Indispensable pour les Advantage+ Catalog Ads et le retargeting dynamique.
Crée un nouveau catalogue ET upload les produits en une seule opération — soit via une URL de feed (CSV/TSV/XML), soit via un fichier base64, soit via batch d'items inline.
Liste les catalogues accessibles (jusqu'à 100), filtrable par business_id et par nom.
Détails d'un catalogue : nom, vertical, nombre de produits, nombre de product sets, business owner, et optionnellement la liste paginée des feeds.
Diagnostics d'un catalogue — erreurs et avertissements affectant la délivrabilité (champs manquants, images cassées, violations de politique).
Crée une règle de transformation sur un feed — fix les mismatch de schéma sans toucher au fichier source. Types : mapping_rule, value_mapping_rule, letter_case_rule, fallback_rule, regex_replace_rule.
Liste les règles de transformation appliquées à un feed.
Détails d'un feed produit : nom, planning d'upload (replace / update schedule), source type (primary / supplementary), statut de la dernière session d'upload, compteurs (detected, persisted, invalid, deleted).
Crée un product set DYNAMIQUE à partir d'une règle de filtre structurée (and/or/not, eq/contains/lt/gte, is_any...). Indispensable pour le retargeting catalog ciblé sur une sous-section.
ads_catalog_search_product avec le même filtre avant pour valider le nombre et la nature des produits matchés.Liste les product sets d'un catalogue, avec nom, retailer_id, filter_rule, type, visibilité, compteur de produits visibles.
Liste les produits contenus dans un product set, avec filtres additionnels (availability, brand, category, condition, product_type, prix).
Récupère les détails d'un produit par son FBID numérique Meta (pas par retailer_id/SKU — pour ça, utiliser ads_catalog_search_product).
Recherche/liste les produits d'un catalogue par filtre structuré (mêmes opérateurs que ads_catalog_create_product_set). Retourne sample + total_count exact.
DÉPRÉCIÉ — ne plus appeler ce tool.
ads_catalog_search_product pour toutes les recherches de produits.Insights & Performance
6 fonctionsModule d'analyse avancée. Au-delà du simple reporting (ads_get_ad_entities), ces tools apportent du contexte, des benchmarks industriels, de la détection d'anomalies et des recommandations actionnables avec lift estimé.
Vue d'ensemble du business de l'annonceur et de son funnel marketing pour contextualiser les performances.
Analyse l'évolution dans le temps des KPIs clés : CPC, CPM, CPR, ROAS, CTR, CVR. Vue time-series.
Détecte les patterns inhabituels ou déviations dans les performances qui méritent investigation.
Identifie les ads qui gagnent en auction, et les facteurs optimisables (bid, ad quality). Recommande consolidation et réduction du fragment d'audience en cas d'auction overlap.
Compare les performances d'un ad set à des benchmarks agrégés d'annonceurs similaires (spend tier, optimization goal).
Score d'opportunité (0-100) du compte + recommandations actionnables triées par lift estimé. Met à jour en temps réel à mesure que les recommandations sont appliquées.
opportunity_score_lift et présenter en "points" gagnés potentiels.Ad Library (veille concurrentielle)
1 fonctionAccès à la bibliothèque publique de Meta — toutes les publicités actives ou récentes sur Facebook et Instagram, par mot-clé, page ou pays. Outil de référence pour la veille concurrentielle et la recherche d'inspiration créa.
Recherche des ads dans la Meta Ad Library publique. Filtres : mots-clés, page IDs, pays (ISO-2), statut actif/inactif, type (incluant POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, EMPLOYMENT_ADS, CREDIT_ADS).
