tools/list, puis appelle chaque outil avec tools/call. Le serveur prend en charge à la fois la révision actuelle de MCP (2026-07-28, où le client commence par server/discover) et les révisions antérieures (où il commence par initialize), et s’identifie sous le nom scanova-mcp. Les 82 outils agissent sur votre propre compte Scanova, avec l’identifiant utilisé par votre client pour s’authentifier — voir Setup.
Le type de chaque outil reprend son annotation MCP : les outils en lecture seule ne font que lire, ceux en écriture ajoutent ou modifient quelque chose sans rien retirer, et les destructifs peuvent supprimer, écraser ou désactiver un élément en service — ce qui inclut le fait de changer ce qu’affiche un QR Code déjà imprimé. Le regroupement ci-dessous est le nôtre, pour rendre la liste plus lisible — le serveur, lui, renvoie une seule liste à plat.
Passerelle vers la documentation Scanova
Permet à l’assistant de consulter ce site de documentation en direct, au fil de la conversation.| Outil | Type | Description |
|---|---|---|
probe_docs_mcp | Lecture seule | Vérifie la connectivité au serveur MCP de documentation de Scanova et liste ses outils disponibles |
query_docs | Lecture seule | Recherche dans cette documentation (mode="search"), ou exécute une commande en lecture seule de type système de fichiers — cat, head, rg, tree, jq — pour lire directement une page de référence précise (mode="filesystem") |
Catégories et validation
Données de référence que l’assistant peut consulter avant de créer quoi que ce soit.| Outil | Type | Description |
|---|---|---|
get_qr_categories | Lecture seule | Liste les catégories de QR Codes disponibles (URL, vCard, WiFi, Document, Social Media, etc.) |
get_qr_category_fields | Lecture seule | Renvoie la référence des champs info obligatoires et facultatifs d’une catégorie, ou de toutes les catégories d’un coup. Données de référence statiques, donc sans appel d’API |
validate_qr_info | Lecture seule | Contrôle une catégorie et sa charge info avant l’exécution de create_qr_code ou update_qr_code, et repère un JSON mal formé, un champ obligatoire manquant ou une valeur invalide |
Habillage des QR Codes
Les aperçus d’habillage ne sont jamais enregistrés : l’assistant vous montre d’abord les options, puis applique celle que vous choisissez avecset_qr_design.
| Outil | Type | Description |
|---|---|---|
get_qr_design_options | Lecture seule | Renvoie le catalogue complet des options de design — motifs, styles de dégradé, formes d’œil, cadres, niveaux de correction d’erreur et polices — afin que l’assistant puisse proposer de vrais choix avant d’appeler set_qr_design |
preview_qr_design | Lecture seule | Affiche l’aperçu d’un habillage sans l’enregistrer : l’habillage fusionné, les contrôles de lisibilité au scan (contraste des couleurs des modules et des yeux, correction d’erreur en présence d’un logo, fonds inversés ou transparents), un vrai test de scan sur un rendu, et l’image. Fonctionne pour un QR Code existant comme pour un nouveau contenu |
set_qr_design | Destructif | Applique un habillage visuel à un QR Code existant à partir de paramètres aux noms explicites. Seuls les champs que vous indiquez changent ; le reste est fusionné avec l’habillage actuel du QR Code. Refuse un habillage qui échoue aux contrôles de lisibilité au scan, sauf si vous acceptez le risque (accept_risk) |
Gestion des QR Codes
| Outil | Type | Description |
|---|---|---|
create_qr_code | Écriture | Crée un QR Code, dès lors que le nom, la catégorie, le type et la charge info sont connus |
open_qr_code_creation_form | Lecture seule | Ouvre à la place un formulaire interactif, lorsque vous avez demandé un QR Code sans fournir tout ce qu’il lui faut |
list_qr_codes | Lecture seule | Liste les QR Codes et les Pages du compte, avec pagination et recherche, ou se limite à l’un des deux |
retrieve_qr_code | Lecture seule | Récupère les détails d’un QR Code spécifique |
update_qr_code | Destructif | Met à jour un QR Code existant |
activate_qr_code | Écriture | Active un QR Code |
deactivate_qr_code | Destructif | Désactive un QR Code |
delete_qr_code | Destructif | Supprime définitivement un QR Code |
download_qr_code | Lecture seule | Télécharge l’image d’un QR Code en PNG, JPG ou PDF |
list_tags | Lecture seule | Liste les étiquettes présentes sur les QR Codes du compte. En lecture seule par conception : une étiquette naît quand vous l’attachez à un QR Code, pas via un appel de création |
update_qr_tags | Destructif | Remplace les étiquettes d’un QR Code par celles que vous indiquez (une liste vide les retire toutes). Les étiquettes qui n’existent pas encore sont créées |
Corbeille et santé
| Outil | Type | Description |
|---|---|---|
list_trashed_qr_codes | Lecture seule | Liste les QR Codes placés dans la corbeille — supprimés mais encore restaurables — avec la date de suppression et le nombre de scans de chacun |
restore_qr_codes | Écriture | Restaure des QR Codes depuis la corbeille pour qu’ils fonctionnent à nouveau, par qrid. Compte dans les limites de QR Codes de votre formule, et ne restaure jamais toute la corbeille en un seul appel |
get_qr_health | Lecture seule | Lance le bilan de santé des QR Codes du compte : les problèmes qui empêchent des codes de fonctionner comme prévu, par exemple des codes inactifs ou expirés, des destinations cassées, ou des formulaires et des domaines personnalisés qui demandent votre attention |
Rappels GS1
| Outil | Type | Description |
|---|---|---|
list_gs1_recalls | Lecture seule | Liste les avis de rappel GS1 par lot du compte — le GTIN et le lot concernés, le message affiché aux personnes qui scannent un produit touché, et si chaque avis est actif |
create_gs1_recall | Écriture | Rappelle un lot de produits : toute personne qui scanne un QR Code GS1 pour ce GTIN et ce lot voit votre message à la place |
update_gs1_recall | Destructif | Modifie le message d’un avis de rappel, ou le désactive une fois le rappel terminé. Son historique est conservé |
Dossiers
| Outil | Type | Description |
|---|---|---|
create_folder | Écriture | Crée un nouveau dossier pour organiser des QR Codes ou des pages |
list_folders | Lecture seule | Liste tous les dossiers d’un type donné (qr ou page) |
update_folder | Écriture | Renomme un dossier existant |
delete_folder | Destructif | Supprime un dossier. L’outil demande d’abord ce qu’il faut faire des QR Codes qu’il contient : les déplacer vers Uncategorized, ou les supprimer avec le dossier |
move_qr_codes_to_folder | Écriture | Déplace plusieurs QR Codes vers un dossier |
unassign_qr_codes_from_folder | Écriture | Retire plusieurs QR Codes d’un dossier (ils deviennent Uncategorized) |
Formulaires
| Outil | Type | Description |
|---|---|---|
list_forms | Lecture seule | Liste tous les formulaires de capture de leads, éventuellement filtrés par statut actif |
retrieve_form | Lecture seule | Récupère des informations détaillées sur un formulaire spécifique, y compris sa configuration |
create_form | Écriture | Crée un formulaire à partir d’un titre et de ses questions — chacune avec un type de réponse (réponse courte, e-mail, choix multiple, note par étoiles, etc.) et des options pour les questions à choix — et l’attache immédiatement à un QR Code dynamique si vous en passez un. Accepte aussi la structure complète des blocs d’un formulaire |
update_form | Destructif | Met à jour le nom ou le statut actif d’un formulaire |
delete_form | Destructif | Supprime définitivement un formulaire |
attach_form_to_qr | Écriture | Rattache un formulaire de capture de leads à un QR Code, via l’id numérique du formulaire ou son form_id |
detach_form_from_qr | Destructif | Retire le formulaire de capture de leads d’un QR Code |
list_form_templates | Lecture seule | Liste des modèles de formulaire prêts à l’emploi pour démarrer un nouveau formulaire |
list_form_responses | Lecture seule | Liste les réponses recueillies par un formulaire, des plus récentes aux plus anciennes : les réponses, leur date d’arrivée et le QR Code par lequel chacune est passée. Filtre par période, par QR Code ou par terme de recherche |
get_form_analytics | Lecture seule | Récupère les performances d’un formulaire : le total des réponses et des abandons par rapport à la période précédente, tous deux par date, et les réponses par QR Code d’origine |
get_form_question_analytics | Lecture seule | Récupère la façon dont chaque question d’un formulaire a été renseignée : le nombre de réponses qui y ont répondu et, pour les questions à choix, de notation et d’échelle, la fréquence de chaque réponse |
list_form_notifications | Lecture seule | Liste les alertes e-mail configurées pour les nouvelles réponses aux formulaires — à qui elles sont envoyées, à quelle fréquence, pour quels formulaires, et si chacune est active |
create_form_notification | Écriture | Envoie un e-mail à quelqu’un quand des formulaires reçoivent de nouvelles réponses — à chaque réponse, ou sous forme de récapitulatif quotidien, hebdomadaire ou mensuel. L’adresse reçoit les réponses des participants |
update_form_notification | Destructif | Modifie le destinataire, la fréquence ou les formulaires d’une alerte, ou la désactive. Ses formulaires sont conservés, sauf si vous en indiquez de nouveaux |
Listes de leads
| Outil | Type | Description |
|---|---|---|
list_lead_lists | Lecture seule | Liste toutes les listes de leads, avec un filtre facultatif sur le statut actif. Pour un nouveau projet, les formulaires sont l’outil à privilégier |
retrieve_lead_list | Lecture seule | Récupère des informations détaillées sur une liste de leads spécifique, y compris sa configuration de webhook |
update_lead_list | Destructif | Met à jour le nom ou le statut actif d’une liste de leads |
delete_lead_list | Destructif | Supprime définitivement une liste de leads |
attach_lead_list_to_qr | Écriture | Rattache une liste de leads à un QR Code pour la capture de leads |
detach_lead_list_from_qr | Destructif | Retire la liste de leads d’un QR Code |
Analytique et rapports
| Outil | Type | Description |
|---|---|---|
get_account_stats | Lecture seule | Récupère les compteurs d’utilisation au niveau du compte — total des QR Codes, scans, utilisateurs, etc |
get_qr_analytics | Lecture seule | Récupère les indicateurs de performance d’un QR Code, ventilés par appareil, géographie, date et autres dimensions |
get_analytics_overview | Lecture seule | Récupère la vue d’ensemble des scans du compte : totaux depuis l’origine, mois en cours, mois récents et scans par date |
list_analytics_reports | Lecture seule | Liste les rapports d’analyse des scans générés pour le compte, avec pour chacun son périmètre, ses dates, son statut et un lien de téléchargement une fois prêt |
create_analytics_report | Écriture | Génère un rapport d’analyse des scans — analyses synthétiques, données de scan brutes, ou les deux — pour les QR Codes, étiquettes ou dossiers choisis sur une période donnée. Il est produit en arrière-plan et envoyé par e-mail à la personne qui l’a demandé |
Formule et facturation
En lecture seule : l’assistant peut expliquer la formule et l’historique de facturation, mais les modifications d’abonnement se font dans l’application.| Outil | Type | Description |
|---|---|---|
get_current_plan | Lecture seule | Récupère la formule active du compte : échéance, état de facturation et la liste complète des quotas qu’elle accorde |
list_available_plans | Lecture seule | Liste les formules vers lesquelles le compte peut passer, avec leurs fonctionnalités et leurs quotas |
get_downgrade_impact | Lecture seule | Avant un passage à une formule inférieure, indique quels QR Codes, utilisateurs, domaines et autres ressources du compte dépassent cette formule |
list_payments | Lecture seule | Liste l’historique des paiements du compte — montant, date et statut de chaque paiement |
list_orders | Lecture seule | Liste les commandes du compte — achats de formule, renouvellements et recharges — et leur statut |
list_quota_topups | Lecture seule | Liste les quotas supplémentaires achetés en plus de la formule, et la date d’expiration de chaque recharge |
Utilisateurs et rôles
| Outil | Type | Description |
|---|---|---|
list_users | Lecture seule | Liste tous les utilisateurs du compte |
get_user | Lecture seule | Récupère les détails d’un utilisateur spécifique |
add_user | Écriture | Invite un nouvel utilisateur au compte par e-mail |
resend_user_invitation | Écriture | Renvoie l’e-mail d’invitation d’un membre de l’équipe qui ne l’a pas encore acceptée |
remove_user | Destructif | Retire un utilisateur du compte |
list_user_roles | Lecture seule | Liste tous les rôles utilisateur pouvant être attribués |
create_custom_role | Écriture | Crée un rôle sur mesure. Exige un quota de formule dédié et renvoie 403 lorsque la formule ne l’accorde pas. Appelez d’abord list_user_roles pour voir ce qui existe déjà |
update_user_role | Destructif | Modifie le rôle d’un utilisateur existant |
Activité
| Outil | Type | Description |
|---|---|---|
get_activity_feed | Lecture seule | Liste ce qui s’est passé dans le compte — qui a créé, modifié ou supprimé quoi, et quand — avec un filtre par type d’événement, membre de l’équipe ou date |
get_activity_summary | Lecture seule | Récupère le décompte de l’activité du compte sur une période |
Domaines personnalisés
| Outil | Type | Description |
|---|---|---|
list_custom_domains | Lecture seule | Liste les domaines personnalisés de liens courts du compte (par exemple qr.example.com), celui qui est défini par défaut, et si chacun est vérifié |
get_custom_domain | Lecture seule | Récupère les détails d’un domaine personnalisé — sa vérification DNS (TXT/CNAME), l’état de son certificat SSL, et s’il est défini par défaut |
Opérations en masse et médias
| Outil | Type | Description |
|---|---|---|
list_bulk_operations | Lecture seule | Liste les opérations en masse du compte — génération et mises à jour de QR Codes en masse — avec le statut et les résultats de chacune |
get_bulk_operation_stats | Lecture seule | Récupère les totaux de l’ensemble des opérations en masse du compte |
list_media | Lecture seule | Liste les fichiers de la médiathèque du compte — images, PDF, vidéos, etc. — par exemple pour choisir un logo ou un document pour un QR Code |
Intégrations et suivi des conversions
| Outil | Type | Description |
|---|---|---|
get_integrations_overview | Lecture seule | Indique quelles intégrations le compte a connectées — webhooks, Zapier, Slack, HubSpot, Google Analytics — et leur état |
list_webhooks | Lecture seule | Liste les webhooks du compte : où chacun envoie ses événements, pour quels formulaires ou QR Codes, et s’il est actif |
list_tracking_sites | Lecture seule | Liste les sites web configurés pour le suivi des conversions, avec leurs domaines |
list_tracking_funnels | Lecture seule | Liste les entonnoirs de conversion d’un site suivi — les étapes qui mènent du scan à la conversion |
Pages d’atterrissage
| Outil | Type | Description |
|---|---|---|
list_page_templates | Lecture seule | Liste les modèles de page d’atterrissage pour les QR Codes qui ouvrent une page — ceux de Scanova, ou uniquement ceux enregistrés par le compte |
Les outils destructifs sautent volontairement la boîte de confirmation — le protocole MCP n’a pas d’étape « en êtes-vous sûr ? » intégrée ; la confirmation éventuelle dépend des conventions de votre client IA. Vérifiez ce qu’un appel à
delete_*, update_* ou remove_user est sur le point de faire avant de l’approuver, comme pour toute autre action d’écriture que vous déléguez à un assistant.À voir aussi
- Présentation de MCP — ce qu’est le serveur, ce qu’il sait faire en bref, et ses conditions d’accès
- Configuration de MCP — connecter un client IA au serveur qui expose ces outils
- Présentation de l’API de gestion — l’API sous-jacente que ces outils appellent en votre nom