Référence des outils
Le serveur MCP propose 47 outils : 30 en lecture et 17 en écriture, dont 6 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, l'identifiant de la marque. Il est facultatif quand l'organisation n'a qu'une marque. Sinon, l'assistant le trouve avec list_projects. L'interface parle de marques, mais les identifiants gardent le mot project : projectId, list_projects.
Votre client affiche le détail des paramètres de chaque outil. Les règles communes sont dans Sécurité et confirmations.
Marques et usage
| Outil | Type | Ce qu'il fait |
|---|---|---|
list_projects | Lecture | Les marques de l'organisation, avec leur URL et leur statut de crawl. |
get_usage | Lecture | Le forfait et les quotas de l'organisation (marques, sièges, audits du mois). Pour une marque, ajoute ses audits manuels, ses prompts actifs et ses suivis manuels restants. |
get_portfolio | Lecture | Toutes les marques 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 marques. Avec un abonnement CiteMe. |
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 de la marque : 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 de la marque, 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 toute la marque 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, avec un abonnement CiteMe.
| 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. Avec un abonnement CiteMe. |
add_competitor | Consomme | Suit un nouveau concurrent à partir de son site et met en file sa première analyse GEO sur les moteurs choisis, OpenAI par défaut, dans la limite de concurrents et de moteurs du forfait. Une marque lance au plus 5 analyses de concurrents par jour. |
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. Avec un abonnement CiteMe. |
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 24 heures d'attente. Avec un abonnement CiteMe. |
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 marque 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 (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 |
socialAuditId | texte | non | au moins 1 caractère, l'exécution renvoyée par run_social_analysis |
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 | texte ou null | oui | null retire le profil |
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 |
full | booléen | non | true renvoie chaque réponse en entier au lieu des 500 premiers caractères, 10 réponses par page au plus |
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 (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 (défaut 30) |
state | texte | non | parmi NEW, TRACKED, SUGGESTED, INACTIVE, DISMISSED |
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 (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 (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 (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 (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 |
full | booléen | non | true renvoie chaque réponse en entier au lieu des 500 premiers caractères |
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 | texte ou null | non | au plus 1000 caractères, null l'efface |
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, SIRI, GOOGLE_AIO |
scope | texte | non | parmi FULL, PRIORITY (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 |
add_competitor
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 |
url | texte | oui | 3 à 2048 caractères |
providers | liste de textes | non | 1 à 10 éléments, chacun parmi OPENAI, ANTHROPIC, GOOGLE, PERPLEXITY, XAI, GOOGLE_AIO, DEEPSEEK, META, MISTRAL, SIRI |
confirm | booléen | oui |