Le serveur MCP Mentionable expose 30 tools sur un seul endpoint (POST https://mentionable.ai/api/mcp). 20 sont en lecture, 10 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_competitors`	Concurrents trackés avec totaux de mentions et Share of Voice	Lecture
`list_competitor_sources`	Domaines où un concurrent donné est cité	Lecture
`list_backlink_opportunities`	Domaines à fort impact avec offres marketplace et prix	Lecture
`list_page_audits`	Page Audits d'un projet, avec status et score	Lecture
`list_geo_audits`	GEO Audits (one-shot white-label) du workspace, avec status et progression	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 GEO Audit	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_page_audit`	Récupérer un Page Audit (polling jusqu'à COMPLETED)	Lecture
`get_geo_audit`	Récupérer un GEO Audit (status, progression, contenu complet quand COMPLETED)	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
`bulk_update_competitor_status`	Confirmer ou rejeter des concurrents suggérés en masse	Écriture
`bulk_update_reddit_thread_status`	Marquer des threads Reddit comme commentés, ignorés ou rouverts en masse	Écriture
`run_page_audit`	Queue un Page Audit sur une URL (100 credits par audit)	Écriture
`select_geo_audit_competitors`	Fige la sélection des concurrents d'un GEO Audit et passe REVIEWING → GENERATING	Écriture
`add_geo_audit_recommendation`	Ajoute une recommandation custom au rapport d'un GEO Audit	Écriture
`remove_geo_audit_recommendation`	Retire une recommandation custom d'un GEO Audit	É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 GEO Audit	É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

Conventions communes

Pagination. Tous les tools de listing acceptent cursor et limit (1 à 100, défaut 20). Les réponses incluent un objet pageInfo avec hasMore, nextCursor et totalCount.
Enum LLM. CHATGPT, CLAUDE, PERPLEXITY, GEMINI, GROK, COPILOT, GOOGLE_AI_MODE, GOOGLE_AIO.
IDs. id, projectId, promptId, competitorId sont tous des CUIDs.
Dates. Tous les timestamps sont des strings ISO 8601 UTC.
Erreurs. Project not found, Project not in API key scope, Competitor not found, erreurs de validation Zod.

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.