CertIndex MCP

oficial

El único servidor MCP de transparencia de certificados. Busca más de 2.15B certificados TLS, monitorea dominios para nuevas emisiones, transmite el flujo global de CT a tu agente.

GitHub

¿Qué puedes hacer con Cert Index MCP?

Buscar certificados por dominio o huella digital — Encuentre certificados TLS usando search_certificates con un nombre de dominio o huella digital SHA-256.
Obtener detalles completos del certificado — Recupere datos PEM, metadatos de registros CT y campos analizados para un certificado específico con get_certificate.
Listar todos los certificados de un dominio — Obtenga todos los certificados emitidos para un dominio usando get_domain_certificates.
Descubrir subdominios a partir de registros CT — Enumere los subdominios observados en los certificados de un dominio dado mediante get_subdomains.
Consultar el certificado más reciente — Recupere el último certificado emitido para un dominio con get_latest_cert.
Encontrar certificados próximos a vencer — Identifique los certificados que vencen dentro de un número específico de días usando get_expiring_certs.

Documentación

certindex-mcp

Un servidor MCP (Model Context Protocol) que expone las herramientas de búsqueda de Transparencia de Certificados de CertIndex a cualquier cliente compatible con MCP (Claude Desktop, el Inspector MCP, Continue, etc.).

CertIndex indexa el corpus CT público completo (~5 M de certificados, creciendo ~100 k/día). Este servidor envuelve la API REST pública de CertIndex para que un LLM pueda hacer preguntas como:

"Lista cada certificado TLS emitido para example.com."
"¿Qué subdominios ha visto Let's Encrypt para mycompany.io?"
"Muéstrame los certificados que expiran en los próximos 30 días para api.mycompany.io."
"Extrae el PEM completo y los metadatos del registro CT para SHA-256 <fingerprint>."

Por qué existe este repositorio

El monorepo de CertIndex incluye un servidor MCP (montado en https://api.ctindex.io/mcp) que habla directamente con el índice Postgres de producción. Este paquete independiente es una capa delgada del lado del cliente: habla MCP con tu editor/agente y reenvía cada llamada de herramienta a la API REST alojada de CertIndex a través de HTTPS. Dos consecuencias:

No necesitas una copia del índice — regístrate para obtener una clave API gratuita en https://ctindex.io y listo.
El paquete tiene una huella de dependencias mínima (mcp, httpx, pydantic) — fácil de auditar, fácil de incorporar, sin controladores de BD.

Instalación

pip install certindex-mcp

O con uvx para uso único:

uvx certindex-mcp

Para instalar la última versión de desarrollo desde el código fuente:

pip install git+https://github.com/certindex/certindex-mcp

Inicio rápido — Claude Desktop

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "certindex": {
      "command": "uvx",
      "args": ["certindex-mcp"],
      "env": {
        "CERTINDEX_API_KEY": "ctx_live_..."
      }
    }
  }
}

Reinicia Claude Desktop. Las seis herramientas de CertIndex (search_certificates, get_certificate, get_domain_certificates, get_subdomains, get_latest_cert, get_expiring_certs) aparecen en la bandeja de herramientas.

Inicio rápido — Inspector MCP

export CERTINDEX_API_KEY=ctx_live_...
npx @modelcontextprotocol/inspector uvx certindex-mcp

Configuración

Variable de entorno	Predeterminado	Descripción
`CERTINDEX_API_KEY`	(requerido)	Tu clave API de CertIndex. Crea una en https://ctindex.io/app/keys
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Anulación para despliegues autoalojados / staging
`CERTINDEX_TIMEOUT`	`30`	Tiempo de espera HTTP por solicitud (segundos)

Seguridad

La validación de entrada, el manejo de límites de tasa y nuestra postura en la cadena de suministro están documentados en SECURITY.md. Por favor, reporta vulnerabilidades a security@ctindex.io en lugar de abrir incidencias públicas.

Desarrollo

git clone https://github.com/certindex/certindex-mcp
cd certindex-mcp
pip install -e ".[dev]"
pytest

CI se ejecuta en Python 3.11 / 3.12 / 3.13.