Référence des tools Mentionable MCP | 65 tools, schémas, exemples
Vue d'ensemble du serveur MCP de Mentionable : 65 tools (44 en lecture, 21 en écriture) sur un seul endpoint. Chaque tool a sa page dédiée avec schéma, réponse et exemple JSON.
Mis à jour le 2026-10-19
Le serveur MCP Mentionable expose 65 tools sur un seul endpoint (POST https://mentionable.ai/api/mcp). 44 sont en lecture, 21 sont en écriture.
Chaque tool a sa propre page dédiée avec le schéma d'input complet, la shape de réponse et un exemple JSON réel.
Tous les tools
| Tool | Rôle | Type |
|---|---|---|
list_projects |
Liste les projets accessibles à l'API key | Lecture |
list_prompts |
Prompts trackés avec taux de mention par LLM | Lecture |
list_scans |
Tracking runs (scans) avec statut, LLMs couverts et taux de mention | Lecture |
list_prompt_results |
L'historique d'un prompt : une ligne légère par LLM et par scan | Lecture |
list_fan_outs |
Queries fan-out brutes lancées par les LLMs, dédupliquées et classées | Lecture |
list_llm_sources |
Domaines cités ou cherchés par les LLMs | Lecture |
list_local_places |
Établissements affichés dans la carte de ChatGPT et Google AI Overview, avec la synthèse de visibilité locale | Lecture |
list_recommendations |
Les actions qui feraient citer le projet, classées par impact, avec les prompts et zones à conquérir | Lecture |
list_competitors |
Concurrents trackés avec totaux de mentions et Share of Voice, filtrables par verdict de l'IA (revendeurs et produits sur les projets e-commerce) | Lecture |
list_competitor_sources |
Domaines où un concurrent donné est cité | Lecture |
list_retailers |
Revendeurs vers lesquels les IA envoient l'acheteur (projets e-commerce), avec la présence de la marque à côté de chacun | Lecture |
list_products |
Produits d'un projet e-commerce, ceux de la marque et de ses concurrents, avec les réponses qui citent chacun, filtrables par catégorie de produit | Lecture |
list_product_prompt_matrix |
Prompts croisés avec les produits : quel prompt fait remonter quel produit, les prompts perdus face au produit d'un concurrent d'abord | Lecture |
list_backlink_opportunities |
Domaines à fort impact avec offres marketplace et prix | Lecture |
list_tracked_links |
Liens achetés ou placés, avec prix, citations et coût par lien cité | Lecture |
list_ai_crawler_pages |
Pages visitées par les robots IA, avec lectures pour répondre, indexation recherche, collecte entraînement et citations | Lecture |
list_ai_crawler_visits |
Visites brutes des robots IA, une ligne par jour, chemin, robot et statut HTTP | Lecture |
list_geo_audits |
GEO Audits (one-shot white-label) du workspace, avec status, progression et URL de rapport ; filtres status, période, campagne ou portée | Lecture |
list_bulk_audits |
Campagnes d'audit GEO en masse (un scan mutualisé, N cibles) avec status, nombre de cibles et progression | Lecture |
list_bulk_audit_competitors |
Concurrents candidats d'une campagne (classés) + la sélection figée | Lecture |
list_geo_audit_competitors |
Concurrents candidats d'un GEO Audit (classés) + la sélection actuelle | Lecture |
list_geo_audit_recommendations |
Recommandations générées + custom d'un rapport (audit simple ou campagne) | Lecture |
list_geo_audit_content_ideas |
Idées de contenu générées + custom d'un rapport (audit simple ou campagne) | Lecture |
list_audit_ctas |
Les CTAs d'audit du compte (pour teaser des sections) | Lecture |
list_reddit_threads |
Threads Reddit cités par les LLMs, avec signaux GEO et contenu scrapé | Lecture |
list_action_logs |
Le journal d'actions du projet, filtrable par plage de dates pour les rapports mensuels | Lecture |
get_site_health |
La santé technique du site à son dernier crawl mensuel : scores par niveau, correctifs avec leur nombre de pages, évolution depuis le crawl précédent | Lecture |
list_site_issues |
Les problèmes du dernier crawl, une ligne par page et par check, avec la façon de corriger chacun (correctifs ouverts seulement) | Lecture |
list_priority_pages |
Le plan du site : les pages et correctifs à traiter d'abord, dans l'ordre, avec la preuve pour chacun | Lecture |
get_site_page |
Une page au dernier crawl : code HTTP, title, meta, H1, profondeur, liens internes, indexabilité, et ses problèmes (correction des problèmes ouverts) | Lecture |
list_content_plan |
Le plan de contenu tel qu'il se lit aujourd'hui : les missions de la semaine, le reste du mois et les mois suivants, chacune avec sa raison | Lecture |
get_content_mission |
Une mission du plan de contenu avec sa raison complète (composantes du score d'opportunité pour une page) | Lecture |
get_content_map |
Les pages du plan de contenu par thème, pilier puis satellites, et les liens internes posés ou manquants | Lecture |
get_page_fix |
Récupérer le dernier correctif d'une page : points à corriger par gravité avec leur correction, JSON-LD à coller, liens à ajouter (polling jusqu'à COMPLETED) | Lecture |
get_geo_audit |
Récupérer un GEO Audit (status, progression, puis metrics structurées, prompts joués, sources citées et contenu complet quand COMPLETED) | Lecture |
get_bulk_audit |
Récupérer une campagne : status, compte de cibles par status et, quand COMPLETED, ses insights de segment | Lecture |
get_prompt_result |
Détail complet d'un ou plusieurs résultats : réponse brute (opt-in), sources, fan-out, concurrents | Lecture |
get_reddit_thread |
Récupérer un thread Reddit par ID (polling de l'enrichissement) | Lecture |
get_ai_crawler_overview |
Visites des robots IA sur le site : totaux, période précédente, par type et par robot, courbe quotidienne, erreurs, pages publiées et actions | Lecture |
get_ai_crawler_page |
L'activité des robots IA sur une page, ses citations par LLM et la chronologie de la publication à la première citation | Lecture |
get_recommendation |
Le plan pas à pas d'un prompt ou d'une zone locale, avec la preuve et l'effet mesuré | Lecture |
get_retailer |
Un revendeur : présence de la marque, prompts, marques recommandées avec lui, pages citées et sources | Lecture |
get_product |
Un produit : noms bruts, moteurs, prompts, et les revendeurs, prix et notes vus sur les cartes produits | Lecture |
get_product_share_of_voice |
Par catégorie de produit : réponses qui citent la catégorie, part de voix de votre marque par moteur, marques et produits en tête | Lecture |
bulk_update_competitor_status |
Confirmer ou rejeter des concurrents suggérés en masse, ou les classer en revendeurs ou produits (projets e-commerce) | Écriture |
bulk_update_reddit_thread_status |
Marquer des threads Reddit comme commentés, ignorés ou rouverts en masse | Écriture |
bulk_update_product_status |
Confirmer ou rejeter des produits d'un projet e-commerce en masse, jusqu'à 50 par appel | Écriture |
update_product |
Renommer un produit, changer sa marque ou sa catégorie, ou écarter sa suggestion de fusion | Écriture |
merge_products |
Fusionner des produits en double d'une même marque dans un produit cible, historique compris | Écriture |
split_product |
Sortir des noms bruts d'un produit vers un nouveau produit de la même marque | Écriture |
run_page_fix |
Lister tout ce qu'il faut corriger sur une page pour que Google et les IA la lisent (sans crédit sur toute page crawlée, un correctif par page et par crawl) | Écriture |
select_geo_audit_competitors |
Fige la sélection des concurrents d'un GEO Audit et passe REVIEWING → GENERATING | Écriture |
select_bulk_audit_competitors |
Fige la sélection des concurrents d'une campagne et passe CURATING → GENERATING | Écriture |
add_geo_audit_recommendation |
Ajoute une recommandation custom à un rapport | Écriture |
remove_geo_audit_recommendation |
Supprime une reco custom, ou retire une reco générée en la masquant | Écriture |
add_geo_audit_content_idea |
Ajoute une idée de contenu custom à un rapport | Écriture |
remove_geo_audit_content_idea |
Supprime une idée custom, ou retire une idée générée en la masquant | Écriture |
set_geo_audit_section_visibility |
Passe une section de GEO Audit en visible, teasé (derrière un CTA) ou masqué | Écriture |
set_geo_audit_recommendation_visibility |
Affiche ou masque une recommandation générée d'un rapport | Écriture |
set_geo_audit_content_idea_visibility |
Affiche ou masque une idée de contenu générée d'un rapport | Écriture |
enrich_reddit_thread |
Déclencher le scrape Bright Data d'un thread Reddit (50 credits par enrichissement) | Écriture |
create_action_log |
Logger une action réalisée sur le projet (visible dans le journal et les rapports) | Écriture |
set_recommendation_status |
Marquer une recommandation ou une étape faite, exclue, ou à refaire (les actions faites vont au journal) | Écriture |
create_prompts |
Ajouter des prompts à suivre (avertit quand un prompt ne nomme aucun lieu sur un projet local) | Écriture |
update_project_settings |
Activer ou couper le mode e-commerce d'un projet (revendeurs et produits triés à part des concurrents) | Écriture |
Conventions communes
- Pagination. Tous les tools de listing acceptent
cursoretlimit(1 à 100, défaut 20). Les réponses incluent un objetpageInfoavechasMore,nextCursorettotalCount. - Enum LLM.
CHATGPT,CLAUDE,PERPLEXITY,GEMINI,GOOGLE_AI_MODE,GOOGLE_AIO. - IDs.
id,projectId,promptId,competitorIdsont tous des CUIDs. - Dates. Tous les timestamps sont des strings ISO 8601 UTC.
- Erreurs.
Project not found,Project not in API key scope, erreurs de validation Zod. Les erreurs métier reviennent en{ success: false, error }avec un code snake_case (ex.competitor_not_found).
Exigences d'authentification
Les tools en lecture acceptent tout rôle non-customer. Les tools en écriture exigent member ou plus. Tout tool scopé projet vérifie le scope effectif de l'API key avant dispatch. Voir Authentification pour les détails.