# Référence des outils

> Les outils du serveur MCP CiteMe classés par usage, avec leur effet sur vos données, lecture, écriture, consommation de crédits ou suppression.

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](./safety.md).

---

## 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 →](./troubleshooting.md)**