VTAI: la API gratuita de VirusTotal para agentes de IA, explicada

VirusTotal ha lanzado VTAI, una API y un servidor MCP gratuitos y diseñados a propósito que permiten a los agentes de IA consultar la reputación de archivos, URL, dominios e IP sin clave de API. Formaliza algo que VirusTotal adelantó por primera vez mediante plugins de la comunidad en abril de 2026, y desde septiembre tiene una entrada oficial en el registro de MCP, documentación completa y guías de configuración para ocho herramientas populares de programación con IA. Esto es lo que hace de verdad, cuáles son sus límites reales y qué saber antes de que un ingeniero de tu equipo la conecte a un agente.

Qué es de verdad VTAI

VTAI expone la base de datos de reputación de VirusTotal mediante dos interfaces creadas específicamente para agentes de IA, y no para personas que hacen clic en un panel: un servidor MCP (Model Context Protocol), el estándar emergente de cómo los agentes de IA llaman a herramientas y datos externos, y una API REST equivalente. Para obtener acceso basta una única solicitud de registro que nombra a tu cliente (un agent_family y un agent_version) a ai.virustotal.com/api/v3/agents/register, que devuelve de inmediato un token que empieza por vtai_, sin correo, OAuth ni creación de cuenta en la vía basada en token. Todas las llamadas posteriores se autentican con ese único token como credencial Bearer.

Las 7 herramientas

El conjunto de herramientas de VTAI es deliberadamente acotado y se lee exactamente como lo que necesita un agente en mitad de una tarea, no como un cliente de VirusTotal de uso general:

• get_file_report, get_url_report, get_domain_report, get_ip_report: cuatro herramientas de consulta que recuperan resultados de análisis existentes. Ninguna inicia un análisis nuevo; leen lo que VirusTotal ya tiene registrado.
• submit_file: envía un archivo para un análisis nuevo (contenido en línea de hasta 24.000.000 bytes a través de la interfaz REST/MCP).
• get_analysis: lee un análisis por su ID una vez procesado un envío.
• submit_local_file: disponible solo en la versión local del servidor basada en stdio, permite a un agente enviar un archivo por su ruta local en lugar de como contenido en línea, con un límite mayor de 32.000.000 bytes.

Un endpoint aparte de recibos de envío permite a un agente volver a recuperar un envío anterior por su hash SHA-256; la guía documentada es explícita en que, si se corta la conexión de un envío, lo correcto es consultar el recibo por hash y no volver a enviar el archivo.

Límites reales y qué cuenta para ellos

La propia documentación de VirusTotal describe el acceso gratuito de VTAI como generoso en comparación con la API pública convencional: unas 60 solicitudes por minuto y 1.000 al día (con referencia UTC), compartidas entre las interfaces REST y MCP, frente al nivel con clave de la API pública estándar, de unas 4 por minuto y 500 al día. (No pudimos obtener de forma independiente las cifras actuales exactas de la documentación de límites de VirusTotal al escribir este artículo: tómalas como las cifras declaradas por VirusTotal y compruébalas directamente en ai.virustotal.com antes de diseñar nada en función de ellas.) Una consulta que no devuelve resultados, o una incidencia por parte de VirusTotal, también cuenta para la cuota. El registro y el uso pueden ser visibles en una clasificación pública, algo que conviene saber si prefieres que el patrón de uso de tu organización no se pueda atribuir públicamente.

Las respuestas están pensadas para una ventana de contexto, no para una persona

Este es el detalle que diferencia VTAI de llamar tú mismo a la API estándar: los resultados vuelven como un JSON conciso y adaptado a los LLM, con etiquetas de veredicto («clean», «malicious», «phishing») en lugar de una lista en bruto de cuarenta nombres de motores antivirus, junto con la fecha del análisis, el número de motores que lo evaluaron y un enlace al informe completo. La documentación de VirusTotal también es explícita sobre un modo de fallo que conviene interiorizar: un 404 (sin resultado de análisis registrado), un resultado de cero detecciones o una respuesta de error no son motivo para concluir que algo es seguro: la ausencia de un mal veredicto no es un buen veredicto. La documentación afirma con claridad que el texto de los resultados de análisis debe tratarse como material de juicio que una persona o una lógica posterior deben sopesar, no como una instrucción sobre la que el agente deba actuar por su cuenta. Es la misma disciplina sobre la que este blog ya ha escrito para cualquier salida de herramienta que consuma un agente: consulta nuestro artículo sobre la inyección de prompts y tratar la salida de las herramientas como datos, no como instrucciones. Un actor malicioso que sabe que un agente confía automáticamente en un veredicto «clean» tiene un motivo para intentar fabricar uno.

Ocho clientes compatibles, tres verificados de principio a fin

La documentación de VirusTotal recoge procedimientos de configuración para ocho herramientas de programación con IA: la CLI de Antigravity («Agy»), Claude Code, Codex, Cursor, VS Code, GitHub Copilot CLI, Devin y Cascade/Windsurf. Conviene saberlo antes de dar por hecho que la compatibilidad es igual de sólida en todas: solo Agy, Claude Code y Codex figuran como verificados mediante una invocación completa de las herramientas de principio a fin por parte del modelo subyacente. Los otros cinco tienen pasos de conexión documentados, pero se indican como comprobados solo en parte, con el uso completo de las herramientas por el modelo sin verificar en el momento de escribir esto. Si vas a desplegarlo en un equipo que usa uno de los otros cinco clientes, reserva tiempo para comprobar de verdad que el agente llama bien a las herramientas en lugar de suponer que basta con la guía de configuración.

Qué es oficial y qué no

Conviene distinguir claramente dos proyectos cercanos. El servidor MCP en sí (king-tero/vt-mcp, con licencia MIT) y la documentación de ai.virustotal.com y docs.virustotal.com son el producto oficial. Un conjunto aparte de plugins de la comunidad para las plataformas de agentes OpenClaw y Hermes, publicados en la cuenta personal de GitHub del mismo autor, fue la forma en que la capacidad de VTAI apareció públicamente por primera vez en abril, y el propio blog de VirusTotal deja claro que esas integraciones son proyectos de la comunidad, no lanzamientos oficiales. También hay una extensión de IDE, VT-Sentinel, publicada en el marketplace Open-VSX para VS Code y Antigravity, que ejecuta un proxy local que comprueba con VirusTotal los archivos descargados por herramientas como npm, pip y curl antes de dejarlos pasar, y bloquea la descarga por completo si no puede llegar a VirusTotal en una ventana predeterminada de 15 segundos. Ese comportamiento de fallo cerrado es una decisión de seguridad deliberada, y también una decisión operativa real: una ruta de red inestable hacia VirusTotal puede convertirse en una instalación de paquetes bloqueada.

La conclusión

VTAI es una pieza de infraestructura auténtica y bien pensada: reduce la fricción para dar a un agente de IA una capacidad real de consulta de reputación desde «consigue una clave de API, lee la documentación, gestiona la autenticación» hasta una sola llamada de registro, y mantiene el formato de respuesta lo bastante pequeño como para que quepa de forma útil en el contexto de un agente. También es, por definición, un nuevo lugar al que fluyen hacia un tercero los nombres de archivo, las URL, los dominios y las IP de interés de tu organización, en cada consulta que hace un agente. Ese intercambio es totalmente razonable para un equipo de seguridad que lo quiera, pero es un intercambio, y merece el mismo despliegue deliberado que cualquier otra herramienta que le des a un agente. Lo tratamos precisamente en un artículo complementario sobre cómo desplegar VTAI de forma segura en un equipo de ingeniería.

Preguntas frecuentes

¿Qué es VTAI? VTAI es la API y el servidor MCP (Model Context Protocol) oficiales de VirusTotal creados para agentes de IA, disponibles en ai.virustotal.com. Permiten a un agente de programación o a cualquier herramienta conectada por MCP consultar los resultados existentes de análisis de malware y reputación de archivos, URL, dominios e IP, y enviar archivos nuevos para analizarlos, todo ello sin una clave de API tradicional, mediante un registro único del agente que devuelve un token con el prefijo vtai_.

¿Necesito una cuenta o una clave de API de VirusTotal para usar VTAI? No hace falta ninguna cuenta ni clave de API para empezar. Una sola solicitud POST al endpoint de registro (con un agent_family y un agent_version que identifican a tu cliente) devuelve de inmediato un token de agente. Volver a registrarse repetidamente para obtener una cuota nueva, o para saltarse los límites, va expresamente contra los términos de VirusTotal: el token está pensado para pedirse una vez y reutilizarse.

¿Cuáles son las 7 herramientas de VTAI? Cuatro recuperan resultados existentes (informes de archivos, URL, dominios e IP) sin iniciar un análisis nuevo. Una envía un archivo para un análisis nuevo, otra lee un análisis por su ID y otra vuelve a recuperar el recibo de un envío anterior por su SHA-256 (para comprobar una subida interrumpida en lugar de reenviarla). La versión local stdio del servidor MCP añade una octava herramienta de envío por ruta de archivo local.

¿Una consulta de VTAI inicia un análisis nuevo? No: las consultas de archivos, URL, dominios e IP solo recuperan los resultados de análisis que VirusTotal ya tiene registrados. Solo las herramientas de envío explícitas desencadenan un análisis nuevo. Esto importa para la privacidad: una consulta por hash nunca envía el propio archivo, pero una consulta de URL envía la URL completa, incluido todo lo que va después de un ? o un #, así que una URL que lleve una clave de API o un token de sesión en su cadena de consulta se envía a VirusTotal como parte de la consulta.

¿VTAI es lo mismo que la API pública estándar de VirusTotal? No. La API pública convencional requiere una clave de API personal y está limitada a unas 4 solicitudes por minuto y 500 al día en el nivel gratuito. VTAI es un servicio aparte, diseñado para agentes de IA, con un registro más sencillo sin clave y límites documentados de unas 60 por minuto y 1.000 al día (según la propia documentación de VirusTotal), compartidos entre sus interfaces REST y MCP.