Available tools - Scanova API Documentation

Source de vérité de cette page. Cette liste est transcrite directement depuis list_mcp_tools() dans src/mcp_http/registry.py du dépôt public trycon/scanova-mcp — exactement le code qui répond à l’appel tools/list d’un vrai client MCP contre https://mcp.scanova.io/mcp. Elle ne provient pas du README de ce dépôt, qui est obsolète : le README ne fait la promotion que de 7 outils de gestion des QR codes, alors que le serveur déployé en enregistre en réalité 42 répartis en 8 catégories. Le Type de chaque outil ci-dessous reflète sa véritable annotation MCP (readOnlyHint/destructiveHint) issue du même fichier.

Un assistant IA connecté appelle d’abord initialize (le serveur signale protocolVersion: "2025-03-26", serverInfo: { name: "scanova-mcp", version: "1.0.0" }), puis tools/list pour découvrir tout ce qui suit, puis tools/call par outil. Les 42 outils agissent sur votre propre compte Scanova, avec les identifiants utilisés par votre client pour s’authentifier (voir Setup).

Passerelle vers la documentation Scanova

Permet à l’assistant de consulter ce site de documentation en direct, en cours de conversation.

Tool	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 la documentation API de Scanova (`mode="search"`), ou exécute une commande en lecture seule de type système de fichiers — `cat`, `head`, `rg`, `tree`, `jq` — contre la documentation (`mode="filesystem"`), par exemple pour lire directement une page de référence spécifique.

Conception des QR codes

Tool	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`.
`set_qr_design`	Écriture	Applique un design visuel à un QR code existant à partir de paramètres nommés conviviaux (motif, couleurs, forme d’œil, cadre, logo, etc.). Seuls les champs que vous précisez changent — tout le reste est conservé en fusionnant avec le design actuel du QR code.

Gestion des QR codes

Tool	Type	Description
`create_qr_code`	Écriture	Crée un nouveau QR code.
`list_qr_codes`	Lecture seule	Liste les QR codes et/ou pages du compte, avec pagination et recherche ; peut filtrer sur les QR codes seuls ou les pages seules.
`update_qr_code`	Écriture	Met à jour un QR code existant.
`retrieve_qr_code`	Lecture seule	Récupère les détails d’un QR code spécifique.
`download_qr_code`	Lecture seule	Télécharge l’image d’un QR code au format PNG, JPG, PDF, SVG ou EPS.
`activate_qr_code`	Écriture	Active un QR code.
`deactivate_qr_code`	Écriture	Désactive un QR code.
`delete_qr_code`	Destructif	Supprime définitivement un QR code.
`get_qr_categories`	Lecture seule	Liste les catégories de QR codes disponibles (URL, vCard, WiFi, Document, Social Media, etc.).
`download_qr_printable`	Lecture seule	Génère une version PDF optimisée pour l’impression d’un QR code.
`attach_form_to_qr`	Écriture	Rattache un formulaire de capture de leads à un QR code.
`detach_form_from_qr`	Écriture	Retire le formulaire de capture de leads d’un QR code.
`attach_lead_list_to_qr`	Écriture	Rattache une liste de leads à un QR code pour la capture de leads.
`detach_lead_list_from_qr`	Écriture	Retire la liste de leads d’un QR code.

Analytique

Tool	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.
`export_analytics`	Lecture seule	Exporte les analyses d’un QR code sous forme de rapport Excel ou PDF.
`export_raw_scans`	Lecture seule	Exporte les journaux de scan ligne par ligne au format CSV ou Excel, pour des pipelines BI personnalisés.

Gestion des dossiers

Tool	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. La description propre de l’outil demande à l’assistant de d’abord confirmer avec vous si les QR codes contenus doivent être déplacés vers Uncategorized ou supprimés 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

Tool	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.
`update_form`	Écriture	Met à jour le nom ou le statut actif d’un formulaire.
`delete_form`	Destructif	Supprime définitivement un formulaire.

Listes de leads

Tool	Type	Description
`list_lead_lists`	Lecture seule	Liste toutes les listes de leads, éventuellement filtrées par statut actif.
`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`	Écriture	Met à jour le nom ou le statut actif d’une liste de leads.
`delete_lead_list`	Destructif	Supprime définitivement une liste de leads.

Gestion des utilisateurs

Tool	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.
`remove_user`	Destructif	Retire un utilisateur du compte.
`list_user_roles`	Lecture seule	Liste tous les rôles utilisateur pouvant être attribués.
`update_user_role`	Écriture	Modifie le rôle d’un utilisateur existant.

Les outils destructifs sautent volontairement une boîte de dialogue de confirmation — le protocole MCP n’a pas d’étape « êtes-vous sûr ? » intégrée ; toute confirmation qui a lieu dépend des propres conventions d’interface de votre client IA. Vérifiez ce qu’un appel à delete_* ou remove_user s’apprête à faire avant de l’approuver, de la même façon que pour toute autre action d’écriture que vous déléguez à un assistant.

À voir aussi

MCP overview — ce qu’est le serveur, ce qu’il peut faire en un coup d’œil, et ses exigences d’accès.
MCP setup — connectez un client IA au serveur qui expose ces outils.
Management API overview — l’API sous-jacente que ces outils appellent en votre nom.

​Passerelle vers la documentation Scanova

​Conception des QR codes

​Gestion des QR codes

​Analytique

​Gestion des dossiers

​Formulaires

​Listes de leads

​Gestion des utilisateurs

​À voir aussi

Passerelle vers la documentation Scanova

Conception des QR codes

Gestion des QR codes

Analytique

Gestion des dossiers

Formulaires

Listes de leads

Gestion des utilisateurs

À voir aussi