Domain Monitor MCP Server

Servidor MCP de Monitoramento de Domínios

Servidor MCP (Model Context Protocol) para monitoramento de domínios. Verifique o vencimento do registro WHOIS via RDAP e o vencimento de certificados SSL/TLS via logs de Transparência de Certificados do crt.sh — zero chaves de API, zero necessidade de cadastro.

Por quê

Certificados SSL expiram silenciosamente e derrubam serviços de produção. O vencimento do registro WHOIS pode fazer você perder seu domínio. Este servidor MCP permite que assistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf) verifiquem proativamente a saúde dos domínios antes que isso se torne um incidente — sem necessidade de painel de monitoramento externo, basta perguntar à sua IA.

Ferramentas

domain_check — Verificar Domínio Único

Verifica o vencimento do registro WHOIS e o vencimento do certificado SSL/TLS para um único domínio. Busca dados WHOIS via RDAP (gratuito, sem autenticação) e dados SSL do crt.sh via logs de Transparência de Certificados (gratuito, sem autenticação). URLs com protocolos são normalizadas automaticamente (ex.: https://www.example.com/path → example.com).

Entrada (domain_check):

Parâmetro	Tipo	Obrigatório	Descrição
domain	string	Sim	Domínio ou URL para verificar. Exemplos: "example.com", "https://www.github.com"

Retorna: Objeto JSON com:

• domain (string): Nome de domínio normalizado
• whoisExpiry (string | null): Data de vencimento do registro WHOIS (ISO 8601)
• whoisDaysLeft (number | null): Dias até o vencimento (negativo = expirado)
• sslExpiry (string | null): Data de vencimento do certificado SSL/TLS (ISO 8601)
• sslDaysLeft (number | null): Dias até o vencimento do SSL (negativo = expirado)
• sslIssuer (string | null): Nome da organização emissora do certificado

Dicas para prompting de LLM: Use quando o usuário fizer uma pergunta direcionada sobre um domínio — "example.com expirou?", "verifique o SSL de github.com", "quando meu domínio expira?". Prefira domain_check em vez de domain_check_batch ao verificar ≤3 domínios para melhor legibilidade.

domain_check_batch — Verificar Múltiplos Domínios

Verifica múltiplos domínios em paralelo (até 50) com limites de aviso configuráveis. Cada domínio retorna uma classificação de severidade. Retorna um resumo com contagens por status, além de detalhes por domínio.

Entrada (domain_check_batch):

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
domains	string[]	Sim	—	Lista de nomes de domínio ou URLs (1–50). URLs são normalizadas automaticamente.
whoisWarnDays	number	Não	30	Limite em dias para aviso de WHOIS (1–365)
sslWarnDays	number	Não	14	Limite em dias para aviso de SSL (1–365)

Classificação de severidade (por domínio):

Status	Significado
ok	Tanto WHOIS quanto SSL têm > dias restantes que o limite
warning	Pelo menos um vencimento está dentro do limite de aviso
critical	Pelo menos um vencimento está dentro da metade do limite de aviso
expired	Pelo menos uma data de vencimento está no passado
error	A verificação falhou para este domínio (veja o campo error)

Retorna: Objeto JSON com contagens de total, ok, warning, critical, expired, error além do array results (cada um com domain, status, whoisExpiry, whoisDaysLeft, sslExpiry, sslDaysLeft, sslIssuer, error).

Dicas para prompting de LLM: Use para verificações de saúde do portfólio — "verifique todos os nossos domínios", "encontre domínios expirando em breve", "audite certificados SSL em toda a empresa". Ajuste whoisWarnDays e sslWarnDays com base no fluxo de renovação do usuário (ex.: use sslWarnDays=30 para empresas com processos lentos de renovação 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

Fontes de Dados

Fonte	Protocolo	Limite de Taxa	Chave de API
rdap.org	RDAP (sucessor do WHOIS)	Nenhum documentado	Nenhuma
crt.sh	Transparência de Certificados	~10 req/s	Nenhuma

Instalação

npm install -g domain-monitor-mcp-server

Relacionados

• Domain Expiry GitHub Action — Monitoramento automatizado de vencimento de domínios como fluxo de trabalho de CI. Executa em agendamento, verifica domínios, abre Issues no GitHub em caso de avisos. Zero configuração, zero chaves de API.
• Domain Monitor Client — Painel web para monitoramento de domínios. Visão geral visual do status de saúde de todos os seus domínios. Exportação para CSV.

Desenvolvimento

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