Viomba MCP
Viomba MCP expone el conjunto de herramientas de inteligencia publicitaria impulsadas por IA de Viomba como herramientas MCP.
Documentación
Viomba MCP
Viomba MCP aporta predicción de atención humana de alta precisión, generación creativa optimizada para atención (para display y redes sociales) y análisis de atención en video a tu flujo de trabajo con IA. Dale a tu asistente un creativo, una URL o un video — y recibe datos de rendimiento de atención específicos del contexto del medio, mapas de calor y resultados puntuados sin salir de tu cliente.
Construido sobre datos reales de seguimiento ocular
Las predicciones de atención de Viomba están impulsadas por modelos neuronales fundamentales entrenados con una década de datos de fijación ocular infrarroja Tobii recopilados de manera consistente, obtenidos de usuarios reales en entornos de navegación reales en distintos mercados. Esto significa que las métricas de visto y tiempo de visualización reflejan fijaciones genuinas a nivel de ubicación del anuncio — no proxies laxos de visibilidad. La diferencia importa: el infrarrojo Tobii separa las fijaciones verdaderas de los movimientos sacádicos a nivel de medición, razón por la cual los números de Viomba a menudo difieren de otras herramientas basadas en proxies de atención.
Herramientas
Atención y Analítica
| Herramienta | Descripción |
|---|---|
viomba_creative_prediction | Predice KPIs de atención (porcentaje visto, tiempo de visualización) para un anuncio display |
viomba_heatmap_prediction | Predice el mapa de calor de mirada para un anuncio display |
viomba_ad_slicer | Divide un creativo publicitario en capturas PNG temporizadas |
Creativo
| Herramienta | Descripción |
|---|---|
viomba_generate_creative | Inicia un trabajo de generación de creativos publicitarios |
viomba_refine_creative | Itera sobre un creativo previamente generado |
viomba_check_generation | Consulta el estado y recupera resultados |
viomba_get_creative | Obtén un creativo generado con HTML completo |
viomba_list_generations | Lista tus solicitudes de generación de creativos |
viomba_cancel_generation | Cancela un trabajo creativo pendiente o en ejecución |
viomba_generate_site_map | Genera un mapa del sitio ponderado por atención para un conjunto de dominios |
Video
| Herramienta | Descripción |
|---|---|
viomba_analyze_video | Analiza un video para atención, eventos de audio/video y puntuación de sincronización AVS |
viomba_focus_prediction | Predice mapas de calor de atención visual para un anuncio de video |
viomba_request_upload | Obtén una URL de carga única del navegador para compartir un archivo de video local |
viomba_check_upload | Consulta la finalización de la carga; devuelve un token utilizable como videoUrl |
Meta Marketing API
Conecta una credencial de Meta en el panel de Viomba y luego gestiona tu biblioteca de anuncios real desde MCP.
| Herramienta | Descripción |
|---|---|
viomba_list_meta_credentials | Lista las credenciales de Meta conectadas a tu cuenta de Viomba |
viomba_set_meta_credential | Activa una credencial para esta sesión de MCP |
viomba_list_meta_ad_accounts | Lista las cuentas publicitarias de Meta accesibles para la credencial activa |
viomba_list_meta_ad_creatives | Lista los creativos publicitarios dentro de una cuenta publicitaria de Meta |
viomba_get_meta_creative_prediction | Activa o consulta la predicción de atención para un creativo publicitario de Meta |
Uso y Cuenta
| Herramienta | Descripción |
|---|---|
viomba_my_usage | Estadísticas de uso y saldo de créditos para tu cliente conectado |
viomba_history | Historial paginado de llamadas a herramientas |
viomba_request_detail | Inspecciona una llamada histórica individual a una herramienta (solicitud + resultado) |
viomba_tool_breakdown | Conteos de llamadas por herramienta y latencia |
viomba_fetch_image | Obtén un adjunto de imagen devuelto por una llamada anterior a una herramienta |
Primeros Pasos
Agrega la URL del servidor a tu cliente MCP y conéctate — eso es todo. El flujo de OAuth se ejecuta automáticamente en la primera conexión. Si aún no tienes una cuenta, se te guiará a través del registro durante el inicio de sesión.
Claude Desktop — abre Configuración → Conectores → Agregar conector y pega
https://mcp.viomba.com/mcp. El aviso de inicio de sesión se abre en tu navegador automáticamente.
Cursor / VS Code — agrega la URL en la configuración de tu servidor MCP y conéctate. El aviso de inicio de sesión se abre en tu navegador automáticamente.
n8n — agrega un nodo MCP con la URL https://mcp.viomba.com/mcp y selecciona
OAuth como tipo de credencial.
Una vez que hayas iniciado sesión, la conexión está activa y tus créditos se vinculan automáticamente.
Token manual (avanzado)
Si tu cliente no admite OAuth o necesitas un token de larga duración para automatización, puedes emitir un Token de Acceso Persistente (PAT) desde el panel y pasarlo como encabezado Bearer:
{
"mcpServers": {
"viomba": {
"type": "streamable-http",
"url": "https://mcp.viomba.com/mcp",
"headers": {
"Authorization": "Bearer <your-token>"
}
}
}
}
Clientes Compatibles
- Claude Desktop
- Cursor
- VS Code (Copilot MCP)
- n8n
- Cualquier cliente que admita transporte HTTP Streamable MCP (especificación 2025-11-25)
Precios
El uso se basa en créditos — cada llamada a una herramienta deduce créditos de tu cuenta de Viomba. Consulta viomba.com/pricing para conocer las tarifas.