Domain Monitor MCP Server

Servidor MCP de Monitoreo de Dominios

Servidor MCP (Protocolo de Contexto de Modelo) para monitoreo de dominios. Verifica la expiración del registro WHOIS mediante RDAP y la expiración de certificados SSL/TLS mediante los registros de Transparencia de Certificados de crt.sh — cero claves API, cero registro requerido.

Por qué

Los certificados SSL expiran silenciosamente y derriban servicios de producción. La expiración del registro WHOIS puede hacerte perder tu dominio. Este servidor MCP permite que los asistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf) verifiquen proactivamente la salud del dominio antes de que se convierta en un incidente — sin necesidad de un panel de monitoreo externo, solo pregúntale a tu IA.

Herramientas

domain_check — Verificar un Solo Dominio

Verifica la expiración del registro WHOIS y la expiración del certificado SSL/TLS para un dominio. Obtiene datos WHOIS mediante RDAP (gratuito, sin autenticación) y datos SSL de los registros de Transparencia de Certificados de crt.sh (gratuito, sin autenticación). Las URLs con protocolos se normalizan automáticamente (p. ej., https://www.example.com/path → example.com).

Entrada (domain_check):

Parámetro	Tipo	Requerido	Descripción
domain	string	Sí	Dominio o URL a verificar. Ejemplos: "example.com", "https://www.github.com"

Devuelve: Objeto JSON con:

• domain (cadena): Nombre de dominio normalizado
• whoisExpiry (cadena | nulo): Fecha de expiración del registro WHOIS (ISO 8601)
• whoisDaysLeft (número | nulo): Días hasta la expiración (negativo = expirado)
• sslExpiry (cadena | nulo): Fecha de expiración del certificado SSL/TLS (ISO 8601)
• sslDaysLeft (número | nulo): Días hasta la expiración SSL (negativo = expirado)
• sslIssuer (cadena | nulo): Nombre de la organización emisora del certificado

Sugerencias para prompts de LLM: Úsala cuando el usuario haga una pregunta específica sobre un dominio — "¿está expirado example.com?", "verifica el SSL de github.com", "¿cuándo expira mi dominio?". Prefiere domain_check sobre domain_check_batch al verificar ≤3 dominios para mayor legibilidad.

domain_check_batch — Verificar Múltiples Dominios

Verifica múltiples dominios en paralelo (hasta 50) con umbrales de advertencia configurables. Cada dominio devuelve una clasificación de severidad. Devuelve un resumen con conteos por estado más los detalles por dominio.

Entrada (domain_check_batch):

Parámetro	Tipo	Requerido	Predeterminado	Descripción
domains	string[]	Sí	—	Lista de nombres de dominio o URLs (1–50). Las URLs se normalizan automáticamente.
whoisWarnDays	number	No	30	Umbral en días para advertencia WHOIS (1–365)
sslWarnDays	number	No	14	Umbral en días para advertencia SSL (1–365)

Clasificación de severidad (por dominio):

Estado	Significado
ok	Tanto WHOIS como SSL tienen > días de umbral restantes
warning	Al menos una expiración está dentro del umbral de advertencia
critical	Al menos una expiración está dentro de la mitad del umbral de advertencia
expired	Al menos una fecha de expiración está en el pasado
error	La verificación falló para este dominio (ver campo error)

Devuelve: Objeto JSON con conteos de total, ok, warning, critical, expired, error más un arreglo results (cada uno con domain, status, whoisExpiry, whoisDaysLeft, sslExpiry, sslDaysLeft, sslIssuer, error).

Sugerencias para prompts de LLM: Úsala para verificaciones de salud de cartera — "verifica todos nuestros dominios", "encuentra dominios que expiren pronto", "audita los certificados SSL de toda la empresa". Ajusta whoisWarnDays y sslWarnDays según el flujo de renovación del usuario (p. ej., usa sslWarnDays=30 para empresas con procesos lentos de renovación de certificados).

## Usage

### Claude Code

```bash
claude mcp add domain-monitor -- npx domain-monitor-mcp-server

Claude Desktop

{
  "mcpServers": {
    "domain-monitor": {
      "command": "npx",
      "args": ["domain-monitor-mcp-server"]
    }
  }
}

Manual

npx domain-monitor-mcp-server

Fuentes de Datos

Fuente	Protocolo	Límite de Tasa	Clave API
rdap.org	RDAP (sucesor de WHOIS)	Ninguno documentado	Ninguna
crt.sh	Transparencia de Certificados	~10 solicitudes/s	Ninguna

Instalación

npm install -g domain-monitor-mcp-server

Relacionados

• Acción de GitHub para Expiración de Dominios — Monitoreo automatizado de expiración de dominios como flujo de trabajo de CI. Se ejecuta según un cronograma, verifica dominios y abre Issues de GitHub ante advertencias. Cero configuración, cero claves API.
• Cliente de Monitoreo de Dominios — Panel web para monitoreo de dominios. Vista general visual del estado de salud de todos tus dominios. Exportación a CSV.

Desarrollo

npm install
npm run dev     # Watch mode
npm run build   # Production build