Référence des outils

Référence

Le serveur MCP propose 46 outils : 30 en lecture et 16 en écriture, dont 5 qui consomment des crédits et 2 destructifs. Votre assistant les choisit seul. Cette page sert à savoir ce qu'il peut faire et ce que chaque outil touche.

Type	Signification
Lecture	Consulte vos données, ne modifie rien.
Écriture	Modifie vos données CiteMe. Demande le rôle Propriétaire, Administrateur ou Membre.
Consomme	Écriture qui consomme des crédits ou un quota. Aperçu avec confirm: false, lancement avec confirm: true.
Destructif	Écriture qui supprime des données.

Presque tous les outils prennent un projectId. Il est facultatif quand l'organisation n'a qu'un projet. Sinon, l'assistant le trouve avec list_projects.

Votre client affiche le détail des paramètres de chaque outil. Les règles communes sont dans Sécurité et confirmations.

---

Projets et usage

Outil	Type	Ce qu'il fait
list_projects	Lecture	Les projets de l'organisation, avec leur URL et leur statut de crawl.
get_usage	Lecture	Le forfait et les quotas de l'organisation (projets, sièges, audits du mois). Pour un projet, ajoute ses audits manuels, ses prompts actifs et ses suivis manuels restants.
get_portfolio	Lecture	Tous les projets côte à côte sur 7, 30 ou 90 jours : score, taux de citation, visiteurs envoyés par l'IA, évolution, rang et points d'attention. Peut comparer 2 à 10 projets. Forfait Expert.

---

Audits et citations

Outil	Type	Ce qu'il fait
get_latest_audit	Lecture	Le dernier audit terminé : score global, scores par moteur et jusqu'à 50 réponses, celles qui citent la marque en premier.
list_audits	Lecture	L'historique des audits, tous statuts confondus, avec le score, les moteurs, la durée et la cause d'un échec.
get_audit	Lecture	Un audit précis, même en cours : progression, scores, et les réponses page par page avec les URL citées.
list_prompts	Lecture	Les questions posées lors d'un audit et, pour chacune, si la marque est citée, à quelle position et avec quel sentiment.
list_citations	Lecture	Les extraits cités par les moteurs sur la marque, avec la page d'origine, la confiance et le sentiment.
visibility_by_model	Lecture	La fréquence de citation par moteur IA sur les audits récents.
visibility_trend	Lecture	Le score et le détail par moteur sur les derniers audits, pour voir ce qui monte ou baisse.
list_alerts	Lecture	Les alertes du projet : score en baisse ou en hausse, citations perdues ou gagnées, concurrent qui passe devant, audit en échec.

---

Prompts et sujets

Outil	Type	Ce qu'il fait
list_markets	Lecture	Les marchés du projet, un par couple pays et langue, avec leur identifiant.
list_topics	Lecture	Les sujets, leur marché et leur nombre de prompts actifs.
list_topic_prompts	Lecture	Les prompts de la bibliothèque, avec texte, langue, marché et statut, pour tout le projet ou un seul sujet.
list_prompt_performance	Lecture	Les prompts actifs avec leur taux de citation, les moteurs qui les citent, le volume estimé, le score d'opportunité et la tendance.
get_prompt_detail	Lecture	Un prompt en détail : dernière réponse de chaque moteur et ses sources, tendance et part de voix.
create_topic	Écriture	Crée un sujet, sur un marché donné ou sur le marché principal.
rename_topic	Écriture	Renomme un sujet et, si demandé, change sa description.
delete_topic	Destructif	Supprime un sujet. Ses prompts restent, sans sujet.
create_prompts	Écriture	Ajoute jusqu'à 50 prompts actifs à un sujet. Chacun prend une place du quota de prompts. Ne lance pas d'audit.
move_prompts	Écriture	Déplace jusqu'à 100 prompts dans un sujet, qui leur donne son marché.
archive_prompts	Écriture	Archive jusqu'à 100 prompts : ils sortent des audits et du quota, leurs résultats sont conservés.
activate_prompts	Écriture	Active jusqu'à 100 prompts archivés, écartés ou suggérés, dans la limite du quota.
remove_prompts	Destructif	Retire jusqu'à 100 prompts : suppression définitive, ou mise à l'écart pour ceux que CiteMe a trouvés lui-même.

---

Analytique et trafic IA

Ces outils lisent les visites captées par le beacon CiteMe, sur les forfaits Pro et Expert.

Outil	Type	Ce qu'il fait
get_ai_traffic_summary	Lecture	Les robots IA (par fournisseur, pages les plus lues) et les visiteurs arrivés depuis une réponse IA, sur 7, 30 ou 90 jours.
list_ai_visits	Lecture	Les visites une par une, robot ou humain, avec la page, la date et la requête quand elle est connue.
get_ai_impact	Lecture	Visites, conversions, pipeline et revenus apportés par l'IA, par moteur, comparés à la période précédente.
list_discovered_queries	Lecture	Les requêtes réelles détectées dans les visites IA, et si elles sont déjà suivies comme prompts.

---

Concurrents et autorité

Outil	Type	Ce qu'il fait
compare_visibility	Lecture	Votre score GEO à côté de celui de chaque concurrent suivi, du meilleur au moins bon.
get_competitor_insights	Lecture	La part de voix de la marque face à chaque concurrent, et les sites cités qui ressemblent à des concurrents pas encore suivis.
list_cited_sources	Lecture	Les sites cités comme sources sur 30 ou 90 jours, répartis entre les vôtres, les concurrents, les réseaux sociaux, Wikipedia et les autres, par moteur.
get_authority_report	Lecture	Le dernier audit d'autorité de marque : score par dimension, actions recommandées, mentions presse récentes.

---

Suggestions et changements

Outil	Type	Ce qu'il fait
list_suggestions	Lecture	Les suggestions d'optimisation, des plus récentes aux plus anciennes, filtrables par statut.
get_suggestion	Lecture	Une suggestion complète : contenu, raisonnement, impact attendu, effort, et dernière vérification sur le site.
set_suggestion_status	Écriture	Approuve ou rejette jusqu'à 50 suggestions. Ne publie et n'applique rien.
record_change_event	Écriture	Enregistre qu'une page a changé à une date donnée, pour comparer la visibilité avant et après.

---

Exécutions qui consomment des crédits

Outil	Type	Ce qu'il fait
run_audit	Consomme	Lance un audit GEO complet sur les moteurs choisis. Utilise un audit manuel de la semaine par moteur. Forfaits Pro et Expert.
run_prompt_tracking	Consomme	Mesure à nouveau les prompts actifs sur un moteur, en dehors du calendrier. Utilise un suivi manuel du mois.
get_tracking_run	Lecture	La progression d'un suivi : statut, prompts traités ou en échec, cause d'un échec.
get_tracking_status	Lecture	La cadence du suivi, le dernier et le prochain passage, les suivis manuels restants et le dernier résultat de chaque prompt par moteur.
import_prompts	Consomme	Importe jusqu'à 500 prompts répartis par sujet et par marché, en créant les sujets manquants.
run_prompt_discovery	Consomme	Cherche de nouvelles questions posées dans votre marché et les ajoute comme prompts suggérés. Utilise une découverte du mois.
get_prompt_discovery	Lecture	Le résultat d'une découverte : sources utilisées et prompts suggérés.

---

Réseaux sociaux

Outil	Type	Ce qu'il fait
get_social_analysis	Lecture	Comment les moteurs IA voient vos profils sociaux : profils connus, dernière analyse, score et recommandations.
set_social_profiles	Écriture	Enregistre ou retire l'URL d'un ou plusieurs profils : LinkedIn, YouTube, X, Instagram, TikTok, Reddit, Facebook.
run_social_analysis	Consomme	Lance l'analyse des profils sociaux. Une à la fois, puis une heure d'attente. Forfaits Pro et Expert.

Arguments par outil

Colonnes : Requis indique si l'argument est obligatoire. projectId est facultatif partout où il figure : sans lui, l'outil prend l'unique projet de l'organisation et refuse si elle en a plusieurs. Les types et bornes sont ceux que le serveur impose, il refuse tout appel qui sort du schéma.

list_projects

Type : lecture seule.

Aucun argument.

get_latest_audit

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère

compare_visibility

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère

visibility_by_model

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère

visibility_trend

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
limit	entier	non	1 à 30, défaut 5

list_prompts

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
auditId	texte	non	au moins 1 caractère
citedOnly	booléen	non
limit	entier	non	1 à 100, défaut 30

list_citations

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
auditId	texte	non	au moins 1 caractère
limit	entier	non	1 à 100, défaut 25

list_ai_visits

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
visitors	texte	non	parmi all, humans, bots, all (défaut all)
days	entier	non	1 à 90, défaut 7
limit	entier	non	1 à 200, défaut 50

list_suggestions

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
status	texte	non	parmi PENDING, APPROVED, EDITED, REJECTED, PUBLISHED, FAILED, APPLIED, DELETED
limit	entier	non	1 à 100, défaut 20

list_markets

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère

list_topics

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
status	texte	non	parmi ACTIVE, SUGGESTED, ARCHIVED

list_topic_prompts

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
topicId	texte	non	au moins 1 caractère
status	texte	non	parmi ACTIVE, SUGGESTED, ARCHIVED, DISMISSED
limit	entier	non	1 à 500, défaut 100
offset	entier	non	0 à 100000, défaut 0

create_topic

Type : écriture, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
name	texte	oui	au moins 2 caractères
description	texte	non
marketId	texte	non	au moins 1 caractère

create_prompts

Type : écriture, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
topicId	texte	oui	au moins 1 caractère
prompts	liste de textes	oui	1 à 50 éléments, chacun de 10 à 1000 caractères
language	texte	non	parmi fr, en, es, de, it, pt, nl, af, …

get_social_analysis

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère

run_social_analysis

Type : écriture, consomme des crédits ou un quota, confirm obligatoire, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
confirm	booléen	oui

set_social_profiles

Type : écriture, idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
profiles	liste d'objets	oui	1 à 7 éléments
profiles[].platform	texte	oui	parmi linkedin, youtube, x, instagram, tiktok, reddit, facebook
profiles[].url	string or null	oui

get_audit

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
auditId	texte	oui	au moins 1 caractère
limit	entier	non	1 à 50, défaut 15
offset	entier	non	0 à 10000, défaut 0

list_audits

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
status	texte	non	parmi PENDING, RUNNING, COMPLETED, FAILED
limit	entier	non	1 à 50, défaut 10

list_cited_sources

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
days	entier	non	parmi 30, 90, 30 (défaut 30)
limit	entier	non	1 à 50, défaut 20

get_usage

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère

get_suggestion

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
suggestionId	texte	oui	au moins 1 caractère

list_discovered_queries

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
days	entier	non	parmi 7, 30, 90, 30 (défaut 30)
state	texte	non	parmi NEW, TRACKED, SUGGESTED, INACTIVE
limit	entier	non	1 à 100, défaut 25

get_tracking_status

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
limit	entier	non	1 à 100, défaut 30

list_alerts

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
unreadOnly	booléen	non
limit	entier	non	1 à 100, défaut 20

get_portfolio

Type : lecture seule.

Argument	Type	Requis	Valeurs
days	entier	non	parmi 7, 30, 90, 7 (défaut 7)
limit	entier	non	1 à 200, défaut 50
benchmarkProjectIds	liste de textes	non	2 à 10 éléments, chacun au moins 1 caractère

get_ai_impact

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
days	entier	non	parmi 7, 30, 90, 30 (défaut 30)
from	texte	non	10 à 10 caractères
to	texte	non	10 à 10 caractères

get_ai_traffic_summary

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
days	entier	non	parmi 7, 30, 90, 30 (défaut 30)

get_competitor_insights

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère

list_prompt_performance

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
topicId	texte	non	au moins 1 caractère
marketId	texte	non	au moins 1 caractère
sort	texte	non	parmi opportunity_score, estimated_monthly_volume, citation_rate, created_at, opportunity_score (défaut opportunity_score)
limit	entier	non	1 à 50, défaut 20
cursor	texte	non	1 à 32 caractères

get_prompt_detail

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
promptId	texte	oui	au moins 1 caractère

get_authority_report

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère

rename_topic

Type : écriture, idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
topicId	texte	oui	1 à 64 caractères
name	texte	oui	2 à 200 caractères
description	string or null	non	at most 1000 caractères

delete_topic

Type : écriture, destructif, idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
topicId	texte	oui	1 à 64 caractères

move_prompts

Type : écriture, idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
promptIds	liste de textes	oui	1 à 100 éléments, chacun de 1 à 64 caractères
topicId	texte	oui	1 à 64 caractères

archive_prompts

Type : écriture, idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
promptIds	liste de textes	oui	1 à 100 éléments, chacun de 1 à 64 caractères

activate_prompts

Type : écriture, idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
promptIds	liste de textes	oui	1 à 100 éléments, chacun de 1 à 64 caractères

remove_prompts

Type : écriture, destructif, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
promptIds	liste de textes	oui	1 à 100 éléments, chacun de 1 à 64 caractères

set_suggestion_status

Type : écriture, idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
suggestionIds	liste de textes	oui	1 à 50 éléments, chacun de 1 à 64 caractères
status	texte	oui	parmi APPROVED, REJECTED

record_change_event

Type : écriture, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
pageUrl	texte	oui	4 à 2048 caractères
shippedAt	texte	oui	4 à 64 caractères

run_prompt_tracking

Type : écriture, consomme des crédits ou un quota, confirm obligatoire, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
provider	texte	non	parmi PERPLEXITY, OPENAI, GOOGLE, ANTHROPIC, XAI, DEEPSEEK, META, MISTRAL, …
scope	texte	non	parmi FULL, PRIORITY, FULL (défaut FULL)
confirm	booléen	oui

get_tracking_run

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
runId	texte	non	1 à 64 caractères

run_audit

Type : écriture, consomme des crédits ou un quota, confirm obligatoire, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
providers	liste de textes	non	1 à 10 éléments, chacun parmi chatgpt, claude, gemini, perplexity, grok, google-aio, siri, deepseek, meta, mistral
confirm	booléen	oui

import_prompts

Type : écriture, consomme des crédits ou un quota, confirm obligatoire, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
rows	liste d'objets	oui	1 à 500 éléments
rows[].prompt	texte	oui	1 à 2000 caractères
rows[].topic	texte	oui	1 à 200 caractères
rows[].market	texte	non	1 à 64 caractères
confirm	booléen	oui

run_prompt_discovery

Type : écriture, consomme des crédits ou un quota, confirm obligatoire, non idempotent.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
confirm	booléen	oui

get_prompt_discovery

Type : lecture seule.

Argument	Type	Requis	Valeurs
projectId	texte	non	au moins 1 caractère
runId	texte	non	1 à 64 caractères

---

Limites et dépannage →