tools/list y después llama a cada herramienta con tools/call. El servidor habla tanto la revisión actual de MCP (2026-07-28, en la que el cliente empieza con server/discover) como las anteriores (en las que empieza con initialize), y se identifica como scanova-mcp. Las 82 herramientas actúan sobre tu propia cuenta de Scanova, con la credencial con la que se haya autenticado tu cliente: mira Setup.
El tipo de cada herramienta refleja su anotación MCP: las de solo lectura únicamente leen, las de escritura añaden algo o lo cambian sin quitar nada, y las destructivas pueden eliminar, sobrescribir o desactivar algo que está en uso, lo que incluye cambiar lo que muestra un código QR ya impreso. La agrupación de abajo es nuestra, para que la lista se lea mejor: el servidor devuelve una única lista plana.
Puente a la documentación de Scanova
Permite al asistente consultar este sitio de documentación en vivo, en plena conversación.| Herramienta | Tipo | Descripción |
|---|---|---|
probe_docs_mcp | Solo lectura | Comprueba la conectividad con el servidor MCP de documentación de Scanova y lista sus herramientas disponibles |
query_docs | Solo lectura | Busca en esta documentación (mode="search") o ejecuta un comando de solo lectura al estilo del sistema de archivos — cat, head, rg, tree, jq — para leer directamente una página de referencia concreta (mode="filesystem") |
Categorías y validación
Datos de referencia que el asistente puede consultar antes de crear nada.| Herramienta | Tipo | Descripción |
|---|---|---|
get_qr_categories | Solo lectura | Lista las categorías de código QR disponibles (URL, vCard, WiFi, Document, Social Media, etc.) |
get_qr_category_fields | Solo lectura | Devuelve la referencia de campos info obligatorios y opcionales de una categoría, o de todas a la vez. Son datos de referencia estáticos, así que no cuesta ninguna llamada a la API |
validate_qr_info | Solo lectura | Comprueba una categoría y su carga info antes de ejecutar create_qr_code o update_qr_code, y detecta JSON mal formado, campos obligatorios ausentes y valores no válidos |
Diseño de códigos QR
Las vistas previas de diseño nunca se guardan: el asistente te muestra primero las opciones y después aplica la que elijas conset_qr_design.
| Herramienta | Tipo | Descripción |
|---|---|---|
get_qr_design_options | Solo lectura | Devuelve el catálogo completo de opciones de diseño — patrones de datos, estilos de degradado, formas de ojo, marcos, niveles de corrección de errores y fuentes — para que el asistente pueda ofrecer opciones reales antes de llamar a set_qr_design |
preview_qr_design | Solo lectura | Muestra una vista previa de un diseño sin guardarlo: el diseño fusionado, las comprobaciones de escaneabilidad (contraste de color de los puntos y los ojos, corrección de errores con logotipo, fondos invertidos o transparentes), una prueba de escaneo real sobre una imagen renderizada y la propia imagen. Funciona con un código QR existente o con contenido nuevo |
set_qr_design | Destructiva | Aplica un diseño visual a un código QR existente a partir de parámetros con nombres claros. Solo cambian los campos que indiques; el resto se fusiona con el diseño actual del código QR. Rechaza los diseños que no superan las comprobaciones de escaneabilidad, salvo que aceptes el riesgo (accept_risk) |
Gestión de códigos QR
| Herramienta | Tipo | Descripción |
|---|---|---|
create_qr_code | Escritura | Crea un código QR nuevo, una vez que se conocen el nombre, la categoría, el tipo y la carga info |
open_qr_code_creation_form | Solo lectura | Abre en su lugar un formulario interactivo, para cuando has pedido un código QR sin aportar todo lo que necesita |
list_qr_codes | Solo lectura | Lista los códigos QR y las Páginas de la cuenta, con paginación y búsqueda, o se limita solo a uno de los dos |
retrieve_qr_code | Solo lectura | Obtiene los detalles de un código QR específico |
update_qr_code | Destructiva | Actualiza un código QR existente |
activate_qr_code | Escritura | Activa un código QR |
deactivate_qr_code | Destructiva | Desactiva un código QR |
delete_qr_code | Destructiva | Elimina un código QR de forma permanente |
download_qr_code | Solo lectura | Descarga la imagen de un código QR en PNG, JPG o PDF |
list_tags | Solo lectura | Lista las etiquetas presentes en los códigos QR de la cuenta. Es de solo lectura por diseño: las etiquetas nacen al asociar una a un código QR, no con una llamada de creación |
update_qr_tags | Destructiva | Sustituye las etiquetas de un código QR por las que indiques (una lista vacía las quita todas). Las etiquetas que aún no existen se crean |
Papelera y estado de salud
| Herramienta | Tipo | Descripción |
|---|---|---|
list_trashed_qr_codes | Solo lectura | Lista los códigos QR de la papelera — eliminados, pero aún recuperables — con la fecha en que se eliminó cada uno y su número de escaneos |
restore_qr_codes | Escritura | Restaura códigos QR de la papelera para que vuelvan a funcionar, por qrid. Cuenta para los límites de códigos QR de tu plan y nunca restaura toda la papelera en una sola llamada |
get_qr_health | Solo lectura | Ejecuta la comprobación de salud de los códigos QR de la cuenta: problemas que impiden que los códigos funcionen como deberían, como códigos inactivos o caducados, destinos rotos y formularios o dominios personalizados que requieren atención |
Retiradas GS1
| Herramienta | Tipo | Descripción |
|---|---|---|
list_gs1_recalls | Solo lectura | Lista los avisos de retirada por lote de GS1 de la cuenta: qué GTIN y qué lote, el mensaje que ven quienes escanean un producto afectado y si cada aviso está activo |
create_gs1_recall | Escritura | Retira un lote de producto: todo el que escanee un código QR GS1 de ese GTIN y lote verá tu mensaje en su lugar |
update_gs1_recall | Destructiva | Cambia el mensaje de un aviso de retirada, o lo desactiva cuando la retirada ha terminado. Su historial se conserva |
Carpetas
| Herramienta | Tipo | Descripción |
|---|---|---|
create_folder | Escritura | Crea una nueva carpeta para organizar códigos QR o páginas |
list_folders | Solo lectura | Lista todas las carpetas de un tipo dado (qr o page) |
update_folder | Escritura | Renombra una carpeta existente |
delete_folder | Destructiva | Elimina una carpeta. La herramienta pregunta antes qué hacer con los códigos QR que contiene: moverlos a Uncategorized o eliminarlos con la carpeta |
move_qr_codes_to_folder | Escritura | Mueve varios códigos QR a una carpeta |
unassign_qr_codes_from_folder | Escritura | Quita varios códigos QR de una carpeta (pasan a Uncategorized) |
Formularios
| Herramienta | Tipo | Descripción |
|---|---|---|
list_forms | Solo lectura | Lista todos los formularios de captura de leads, opcionalmente filtrados por estado activo |
retrieve_form | Solo lectura | Obtiene información detallada de un formulario específico, incluida su configuración |
create_form | Escritura | Crea un formulario a partir de un título y sus preguntas — cada una con un tipo de respuesta (respuesta corta, correo electrónico, opción múltiple, valoración con estrellas y más) y las opciones de las preguntas de elección — y lo asocia de inmediato a un código QR dinámico si le pasas uno. También admite la estructura de bloques completa de un formulario |
update_form | Destructiva | Actualiza el nombre o el estado activo de un formulario |
delete_form | Destructiva | Elimina un formulario de forma permanente |
attach_form_to_qr | Escritura | Adjunta un formulario de captura de leads a un código QR, mediante el id numérico del formulario o su form_id |
detach_form_from_qr | Destructiva | Elimina el formulario de captura de leads de un código QR |
list_form_templates | Solo lectura | Lista las plantillas de formulario listas para usar desde las que empezar un formulario nuevo |
list_form_responses | Solo lectura | Lista las respuestas que ha recogido un formulario, de la más reciente a la más antigua: las respuestas, cuándo llegó cada una y por qué código QR. Permite filtrar por intervalo de fechas, por código QR o por un término de búsqueda |
get_form_analytics | Solo lectura | Obtiene el rendimiento de un formulario: total de respuestas y de omisiones frente al periodo anterior, ambos por fecha, y respuestas por código QR de origen |
get_form_question_analytics | Solo lectura | Obtiene cómo se respondió cada pregunta de un formulario: cuántas respuestas la contestaron y, en las preguntas de opción, de valoración y de escala, con qué frecuencia se dio cada respuesta |
list_form_notifications | Solo lectura | Lista las alertas por correo electrónico configuradas para las respuestas nuevas de formularios: a quién llegan, con qué frecuencia, de qué formularios y si cada una está activa |
create_form_notification | Escritura | Envía un correo electrónico a alguien cuando los formularios reciben respuestas nuevas, por cada respuesta o como resumen diario, semanal o mensual. La dirección recibe las respuestas de quienes rellenan el formulario |
update_form_notification | Destructiva | Cambia el destinatario, la frecuencia o los formularios de una alerta de formulario, o la desactiva. Sus formularios se mantienen salvo que pases otros nuevos |
Listas de leads
| Herramienta | Tipo | Descripción |
|---|---|---|
list_lead_lists | Solo lectura | Lista todas las listas de leads, con filtro opcional por estado activo. Para trabajo nuevo, lo recomendable son los formularios |
retrieve_lead_list | Solo lectura | Obtiene información detallada de una lista de leads específica, incluida su configuración de webhook |
update_lead_list | Destructiva | Actualiza el nombre o el estado activo de una lista de leads |
delete_lead_list | Destructiva | Elimina una lista de leads de forma permanente |
attach_lead_list_to_qr | Escritura | Adjunta una lista de leads a un código QR para la captura de leads |
detach_lead_list_from_qr | Destructiva | Elimina la lista de leads de un código QR |
Analítica e informes
| Herramienta | Tipo | Descripción |
|---|---|---|
get_account_stats | Solo lectura | Obtiene los contadores de uso a nivel de cuenta — total de códigos QR, escaneos, usuarios, etc |
get_qr_analytics | Solo lectura | Obtiene las métricas de rendimiento de un código QR desglosadas por dispositivo, geografía y fecha |
get_analytics_overview | Solo lectura | Obtiene el resumen de escaneos de la cuenta: totales históricos, el mes en curso, los últimos meses y los escaneos por fecha |
list_analytics_reports | Solo lectura | Lista los informes de analítica de escaneos generados para la cuenta, con el alcance, las fechas y el estado de cada uno, y un enlace de descarga cuando está listo |
create_analytics_report | Escritura | Genera un informe de analítica de escaneos — analítica resumida, datos de escaneo sin procesar o ambos — para los códigos QR, etiquetas o carpetas que elijas en un intervalo de fechas. Se prepara en segundo plano y se envía por correo electrónico a quien lo pidió |
Plan y facturación
Solo lectura: el asistente puede explicarte el plan y el historial de facturación, pero los cambios en una suscripción se hacen en la aplicación.| Herramienta | Tipo | Descripción |
|---|---|---|
get_current_plan | Solo lectura | Recupera el plan activo de la cuenta: caducidad, estado de facturación y la lista completa de cuotas que concede |
list_available_plans | Solo lectura | Lista los planes a los que puede cambiarse la cuenta, con sus funciones y cuotas |
get_downgrade_impact | Solo lectura | Antes de pasar a un plan inferior, muestra qué códigos QR, usuarios, dominios y otros recursos de la cuenta superan lo que ese plan permite |
list_payments | Solo lectura | Lista el historial de pagos de la cuenta: importe, fecha y estado de cada pago |
list_orders | Solo lectura | Lista los pedidos de la cuenta — compras de plan, renovaciones y recargas — y su estado |
list_quota_topups | Solo lectura | Lista la cuota adicional comprada además del plan y cuándo vence cada recarga |
Usuarios y roles
| Herramienta | Tipo | Descripción |
|---|---|---|
list_users | Solo lectura | Lista todos los usuarios de la cuenta |
get_user | Solo lectura | Obtiene los detalles de un usuario específico |
add_user | Escritura | Invita a un nuevo usuario a la cuenta por correo electrónico |
resend_user_invitation | Escritura | Vuelve a enviar el correo de invitación a un miembro del equipo que todavía no la ha aceptado |
remove_user | Destructiva | Elimina a un usuario de la cuenta |
list_user_roles | Solo lectura | Lista todos los roles que se pueden asignar |
create_custom_role | Escritura | Crea un rol propio. Necesita una cuota de plan específica y devuelve 403 cuando el plan no la incluye. Llama antes a list_user_roles para ver los que ya existen |
update_user_role | Destructiva | Cambia el rol de un usuario existente |
Actividad
| Herramienta | Tipo | Descripción |
|---|---|---|
get_activity_feed | Solo lectura | Lista lo que ha pasado en la cuenta — quién creó, cambió o eliminó qué, y cuándo —, con filtros por tipo de evento, miembro del equipo o fecha |
get_activity_summary | Solo lectura | Obtiene los recuentos de actividad de la cuenta en un periodo |
Dominios personalizados
| Herramienta | Tipo | Descripción |
|---|---|---|
list_custom_domains | Solo lectura | Lista los dominios personalizados de enlaces cortos de la cuenta (por ejemplo, qr.example.com), cuál es el predeterminado y si cada uno está verificado |
get_custom_domain | Solo lectura | Obtiene los detalles de un dominio personalizado: su verificación DNS (TXT/CNAME), el estado del SSL y si es el predeterminado |
Operaciones masivas y archivos multimedia
| Herramienta | Tipo | Descripción |
|---|---|---|
list_bulk_operations | Solo lectura | Lista las operaciones masivas de la cuenta — generación y actualización masiva de códigos QR — con el estado y los resultados de cada una |
get_bulk_operation_stats | Solo lectura | Obtiene los totales del conjunto de operaciones masivas de la cuenta |
list_media | Solo lectura | Lista los archivos de la biblioteca multimedia de la cuenta — imágenes, PDF, vídeos y más —, por ejemplo para elegir un logotipo o un documento para un código QR |
Integraciones y seguimiento de conversiones
| Herramienta | Tipo | Descripción |
|---|---|---|
get_integrations_overview | Solo lectura | Muestra qué integraciones tiene conectadas la cuenta — webhooks, Zapier, Slack, HubSpot, Google Analytics — y su estado |
list_webhooks | Solo lectura | Lista los webhooks de la cuenta: adónde envía eventos cada uno, para qué formularios o códigos QR y si está activo |
list_tracking_sites | Solo lectura | Lista los sitios web configurados para el seguimiento de conversiones, con sus dominios |
list_tracking_funnels | Solo lectura | Lista los embudos de conversión de un sitio de seguimiento: los pasos que van del escaneo a la conversión |
Páginas de destino
| Herramienta | Tipo | Descripción |
|---|---|---|
list_page_templates | Solo lectura | Lista las plantillas de página de destino para los códigos QR que abren una página: las de Scanova o solo las que ha guardado la cuenta |
Las herramientas destructivas se saltan el diálogo de confirmación a propósito: el protocolo MCP no tiene un paso integrado de “¿seguro?”; la confirmación que haya depende de las convenciones de tu propio cliente de IA. Revisa qué va a hacer una llamada a
delete_*, update_* o remove_user antes de aprobarla, igual que harías con cualquier otra acción de escritura que delegues en un asistente.Relacionado
- Información general de MCP — qué es el servidor, qué puede hacer a grandes rasgos y sus requisitos de acceso
- Configuración de MCP — conecta un cliente de IA al servidor que expone estas herramientas
- Información general de la API de gestión — la API subyacente que estas herramientas llaman en tu nombre