Agent Whois – La herramienta definitiva para consultas WHOIS en entornos modernos
Descripción del programa Agent Whois
Agent Whois no es un programa tradicional en el sentido de software de escritorio independiente, sino una implementación del Model Context Protocol (MCP) que permite a los asistentes de inteligencia artificial, como Claude Desktop, Cursor, Windsurf y Roo Code, realizar consultas WHOIS directamente desde el entorno de desarrollo o conversación. Desarrollado por Bharathvaj Ganesan y publicado en marzo de 2025, este servidor MCP representa la evolución natural de las herramientas WHOIS hacia la integración nativa con agentes de IA.
Su propósito principal es eliminar la necesidad de cambiar entre el navegador y el entorno de trabajo para obtener información de registro de dominios, direcciones IP o sistemas autónomos (ASN). Agent Whois actúa como un puente que traduce las consultas en lenguaje natural del usuario en llamadas estructuradas a las bases de datos WHOIS, devolviendo los resultados de forma clara y organizada.
En este contexto, comprender cómo funcionan las extensiones de archivo y los protocolos de red puede ayudar a los desarrolladores a aprovechar al máximo esta herramienta.
¿Necesitas consultar información de dominios e IP directamente desde tu asistente de IA sin salir del entorno de desarrollo?
Características clave de Agent Whois
1. Integración nativa con asistentes de IA
Agent Whois está diseñado específicamente para funcionar con los principales entornos que soportan el Model Context Protocol. Esto incluye:
- Claude Desktop: permite consultar WHOIS directamente en las conversaciones con Claude.
- Cursor IDE: integra las consultas WHOIS en el flujo de trabajo de desarrollo.
- Windsurf y Roo Code: soporte completo para las herramientas de desarrollo basadas en IA.
- Antigravity: compatible con el entorno de desarrollo de Google.
Una vez configurado, el agente detecta automáticamente cuándo una consulta requiere información WHOIS y ejecuta las herramientas correspondientes sin intervención manual.
2. Cuatro herramientas de consulta especializadas
El servidor proporciona cuatro herramientas específicas para diferentes tipos de búsqueda:
| Herramienta | Descripción |
|---|---|
whois_domain | Consulta información completa de un dominio (registrar, fechas, propietario) |
whois_tld | Obtiene información sobre el registro del dominio de nivel superior (TLD) |
whois_ip | Realiza búsqueda WHOIS de una dirección IP |
whois_as | Consulta información del Sistema Autónomo (ASN) |
Estas herramientas cubren prácticamente todas las necesidades de consulta de información de registro en redes.
3. Información detallada recuperable
Cuando se consulta un dominio, Agent Whois puede recuperar un conjunto completo de datos:
- Nombre del dominio: el dominio consultado.
- Registrar: la empresa que gestiona el registro (ej. GoDaddy, Namecheap, MarkMonitor).
- Fechas de registro y expiración: cuándo se registró y cuándo expira.
- Servidores de nombres (Name Servers): los DNS que utiliza el dominio.
- Estado del dominio: activo, expirado, bloqueado o pendiente de eliminación.
- Información del registrante: nombre, organización y país (si no está protegida por privacidad).
- Contactos administrativo y técnico: en caso de estar disponibles.
- DNSSEC: si la firma DNSSEC está activa.
- Códigos de estado EPP: indicadores de restricciones como clientTransferProhibited.
4. Modelo de distribución ligero sin coste
Agent Whois se distribuye a través de npm (Node Package Manager) como el paquete @bharathvaj/whois-mcp. El tamaño total del paquete es de aproximadamente 8.5 KB, y su instalación se realiza con un solo comando npx. Es completamente gratuito y de código abierto, publicado bajo licencia MIT.
Explicación detallada de las funcionalidades
La arquitectura de Agent Whois se basa en el Model Context Protocol (MCP), un estándar emergente que permite a los asistentes de IA interactuar con herramientas externas de forma estructurada. MCP define un protocolo de comunicación entre el cliente (Claude Desktop, Cursor) y el servidor (Agent Whois) utilizando JSON-RPC sobre stdio o HTTP.
Cuando un usuario hace una pregunta como «¿Quién es el propietario de example.com?» en Claude Desktop, el asistente analiza la intención y determina que necesita la herramienta whois_domain. Claude genera una llamada estructurada que envía al servidor MCP configurado. El servidor ejecuta la consulta WHOIS real contra los servidores de registro (como whois.verisign-grs.com para.com) y devuelve los datos formateados al asistente, que finalmente presenta la respuesta al usuario en lenguaje natural.
Una ventaja significativa de este enfoque es que el usuario nunca ve los detalles técnicos de la consulta. No es necesario recordar la URL correcta de la página WHOIS, ni entender los distintos formatos de respuesta de cada registro. Agent Whois normaliza los resultados y los presenta de manera consistente.
En entornos de desarrollo como Cursor, el funcionamiento es similar. El agente de IA integrado en el IDE puede sugerir automáticamente consultas WHOIS cuando detecta que el código o la conversación involucra un nombre de dominio desconocido. Esto acelera significativamente tareas como la validación de dominios para adquisiciones, análisis de competencia o investigación de seguridad.
Descarga e instalación de Agent Whois
- Página oficial: GitHub – bharathvaj-ganesan/whois-mcp
- Paquete npm: @bharathvaj/whois-mcp en npmjs.com
- Versión actual: 1.0.1 (publicada en marzo de 2026)
- Últimas versiones: 1.0.1 (2026), 1.0.0 (2025)
- Tamaño: 8.46 KB (descomprimido), 4 archivos
- Sistemas operativos compatibles: Windows, macOS, Linux (cualquier sistema con Node.js 18+)
- Requisitos mínimos: Node.js 18 o superior, npm instalado
- Licencia: MIT (código abierto y gratuito)
- Idiomas: Inglés (la interfaz es técnica, los resultados se devuelven en inglés)
- Soporte técnico: GitHub Issues, documentación en el repositorio
Cómo usar Agent Whois
Configuración en Cursor IDE
- Asegúrate de tener Node.js 18+ y npm instalados en tu sistema.
- Abre Cursor IDE y ve a
Cursor Settings>MCP. - Haz clic en
+ Add New MCP Server. - Completa el formulario:
- Name:
Whois Lookup(o el nombre que prefieras) - Type:
command - Command:
npx -y @bharathvaj/whois-mcp@latest
- Guarda la configuración. Las herramientas WHOIS aparecerán listadas en
Available Tools.
Configuración en Claude Desktop
- Localiza el archivo de configuración de Claude Desktop (en macOS:
~/Library/Application Support/Claude/claude_desktop_config.json; en Windows:%APPDATA%\Claude\claude_desktop_config.json). - Añade la siguiente entrada en
"mcpServers":
{
"mcpServers": {
"whois": {
"command": "npx",
"args": ["-y", "@bharathvaj/whois-mcp@latest"]
}
}
}- Guarda el archivo y reinicia Claude Desktop.
Configuración en Roo Code (VS Code)
- Abre VS Code y accede a la paleta de comandos (
Cmd+Shift+PoCtrl+Shift+P). - Busca
Roo Code: Open MCP Config. - Añade la misma configuración JSON anterior y guarda.
- Reinicia la ventana de VS Code para que los cambios surtan efecto.
Uso una vez configurado
En Cursor, puedes preguntar directamente al agente de IA:
- «What is the WHOIS information for google.com?»
- «Check if example.org is available»
- «When does microsoft.com expire?»
- «Who owns amazon.com?»
El agente detectará automáticamente que necesita usar la herramienta whois_domain y ejecutará la consulta, devolviéndote los resultados formateados.
Observaciones sobre Agent Whois
Frente a las herramientas WHOIS tradicionales (como páginas web o clientes de línea de comandos como whois), Agent Whois representa un cambio de paradigma en la forma de interactuar con esta información. En lugar de recordar comandos específicos o navegar a páginas web, el usuario simplemente pregunta en lenguaje natural y recibe la respuesta directamente en su entorno de trabajo. Esto se alinea con la tendencia actual hacia interfaces conversacionales y asistentes integrados.
Para el usuario final, el beneficio práctico es significativo: ahorro de tiempo y reducción de fricción. Un desarrollador que está trabajando en Cursor no necesita cambiar de contexto para consultar WHOIS; la información aparece en la misma conversación con el agente de IA. Un investigador de seguridad puede hacer preguntas sobre IPs y ASNs sin tener que aprender las sintaxis específicas de cada registro regional (RIPE, ARIN, APNIC, etc.).
El desarrollador, Bharathvaj Ganesan, es un contribuidor activo en el ecosistema MCP con varios servidores publicados en npm. El proyecto whois-mcp ha recibido 53 estrellas en GitHub desde su lanzamiento en marzo de 2025, y cuenta con contribuciones de otros desarrolladores como Frank Fiegel (punkpeye).
Las actualizaciones del servidor han sido continuas durante los primeros meses de 2025, con la última versión estable (1.0.1) publicada en marzo de 2026. El proyecto incluye un historial de 9 commits y mejoras en la compatibilidad con versiones legacy de Claude Desktop.
Agent Whois no requiere una versión portable en el sentido tradicional, ya que se ejecuta bajo demanda mediante npx, que descarga y ejecuta el paquete temporalmente sin necesidad de instalación permanente. Esto lo hace ideal para entornos efímeros o para probar sin compromiso.
Entre las funcionalidades técnicas adicionales, el servidor incluye soporte para depuración con MCP Inspector, una herramienta que permite probar y verificar el funcionamiento de las herramientas durante el desarrollo. También está preparado para ejecutarse en modo servidor HTTP, lo que permite integraciones con herramientas que no soportan stdio.
Limitaciones importantes
- ❌ Requiere Node.js: No funciona en entornos sin Node.js instalado.
- ❌ No tiene interfaz gráfica propia: Depende completamente del cliente MCP (Cursor, Claude Desktop, etc.).
- ❌ Resultados en inglés: La información WHOIS se devuelve en inglés, sin opción de traducción automática.
- ❌ Limitado por WHOIS público: Los dominios con privacidad de WHOIS (privacy protection) no revelan información del registrante.
- ❌ Requiere configuración manual: Aunque la instalación es simple, el usuario debe editar archivos de configuración para integrarlo.
Alternativa recomendada
Si prefieres una solución con interfaz gráfica o no quieres configurar manualmente archivos JSON, whois.domaintools.com es una alternativa web completa y gratuita para consultas de dominios. Para consultas programáticas en línea de comandos, el comando whois disponible en sistemas Unix y Windows (instalable) sigue siendo una opción robusta y sin dependencias externas.
Si buscas una solución con mayor volumen de consultas y funcionalidades de enriquecimiento de datos, Supernet WHOIS Lookup en Apify ofrece consultas masivas con precios desde $0.50 por cada 1,000 consultas, y también está disponible como herramienta MCP a través del servidor Apify. Para integraciones con servicios comerciales de WHOIS enriquecido, Ip2whois ofrece una API completa con planes gratuitos y de pago.
Agent Whois es la solución ideal para desarrolladores y profesionales de TI que ya utilizan entornos con soporte MCP (Cursor, Claude Desktop) y desean integrar consultas WHOIS directamente en su flujo de trabajo sin salir del contexto. Puedes instalarlo en segundos con
npxy comenzar a hacer preguntas sobre dominios, IPs y ASN directamente a tu asistente de IA.
Sección FAQ
¿Agent Whois es gratis o de pago?
Agent Whois es completamente gratuito y de código abierto, publicado bajo licencia MIT. No tiene versiones de pago, funcionalidades bloqueadas ni límites en el número de consultas (más allá de los impuestos por los servidores WHOIS públicos).
¿Funciona en Linux, macOS, Windows 10 y Windows 11?
Sí. Al estar basado en Node.js, Agent Whois funciona en cualquier sistema operativo con Node.js 18 o superior instalado (Windows, macOS, Linux). Los clientes MCP que lo utilizan (Cursor, Claude Desktop, etc.) también son multiplataforma.
¿Qué diferencia a Agent Whois de usar el comando whois en la terminal?
La principal diferencia es la integración con asistentes de IA. Mientras que el comando whois requiere que el usuario conozca la sintaxis, ejecute manualmente y luego interprete la salida (que varía según el registro), Agent Whois traduce preguntas en lenguaje natural en consultas estructuradas y presenta los resultados de forma limpia y coherente, todo dentro de la conversación con el agente de IA.
¿Qué información puedo obtener con una consulta WHOIS?
Puedes obtener el nombre del dominio, el registrar, las fechas de registro y expiración, los servidores de nombres, el estado del dominio, y, si no está protegido por privacidad, el nombre y organización del propietario, así como sus datos de contacto. Para IPs y ASN, obtienes información sobre la red y el proveedor asignado.
¿Puedo usar Agent Whois con cualquier asistente de IA?
Agent Whois está diseñado específicamente para asistentes que soporten el Model Context Protocol (MCP). Esto incluye Claude Desktop, Cursor IDE, Windsurf, Roo Code y Antigravity. No funciona directamente con asistentes web como ChatGPT sin integración adicional.
