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 CertIndex MCP?

Buscar datos de transparencia de certificados — Solicite certificados TLS indexados para un dominio, CN, emisor, SAN o estado de comodín mediante search_certificates.
Obtener detalles del certificado — Recupere el PEM completo de un solo certificado y los metadatos del registro CT mediante la huella digital SHA-256 usando get_certificate.
Enumerar subdominios — Liste los subdominios únicos vistos en CT para un dominio, con paginación basada en cursor mediante get_subdomains.
Monitorear la expiración de certificados — Encuentre certificados que expiren dentro de un número específico de días para un dominio usando get_expiring_certs.
Ejecutar barridos globales — Envíe barridos asincrónicos de subcadenas en todo el índice para patrones de CN/SAN mediante submit_global_sweep, luego consulte los resultados con get_sweep_results.
Verificar el uso de la API — Revise su nivel, uso actual, cuota restante y derechos con get_usage.

Documentación

certindex-mcp

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

CertIndex ingiere certificados directamente de los registros públicos de Certificate Transparency y los sirve desde su propio índice. La carga histórica retroactiva aún está en progreso, por lo que los resultados, especialmente para certificados antiguos, pueden estar incompletos. Este servidor envuelve la API REST pública de CertIndex para que un LLM pueda hacer preguntas como:

"Lista los certificados TLS que CertIndex ha indexado para example.com."
"¿Qué subdominios ha visto Let's Encrypt para mycompany.io?"
"Muéstrame certificados que expiran en los próximos 30 días para api.mycompany.io."
"Obtén 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 un adaptador del lado del cliente delgado: 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 integrar, sin controladores de base de datos.

Instalación

La versión 0.3.0 usa el SDK de Python MCP 2.x (mcp>=2,<3) y Python 3.11+. El comando de consola, las variables de entorno y los diez nombres de herramientas no han cambiado. Para aplicaciones que deban conservar el SDK 1.x, usa certindex-mcp==0.2.1.

pip install certindex-mcp

O con uvx para uso puntual:

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ñade 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 diez herramientas de CertIndex aparecerán en la bandeja de herramientas.

Herramientas

Diez herramientas, que coinciden 1:1 con el servidor MCP alojado de CertIndex:

Herramienta	Qué hace	Parámetros notables
`search_certificates`	Busca en el índice CT por dominio, CN, emisor, SAN, validez o estado de comodín.	`domain`, `cn`, `issuer`, `san`, `expired`, `is_wildcard`, `page`/`limit`
`get_certificate`	Obtiene un único certificado por huella SHA-256.	`sha256`, `include_enrichment`
`get_domain_certificates`	Certificados indexados para un dominio exacto.	`valid_only`, `include_enrichment`, `include_signals` (planes de pago), `page`/`limit`
`get_subdomains`	Enumera subdominios únicos vistos en CT.	Offset (`page`/`limit`) o modo de cursor por conjunto de claves — pasa `cursor=""` para comenzar, luego retroalimenta el `next_cursor` de cada respuesta
`get_latest_cert`	Certificado válido más reciente para un dominio.	`include_enrichment`, `include_signals`, `include_precerts` (permite que los precertificados compitan por el "más reciente")
`get_expiring_certs`	Certificados de un dominio que expiran dentro de `days` días.	`days`
`submit_global_sweep`	Envía un barrido asíncrono de subcadenas CN/SAN sin dominio en todo el índice (`POST /v1/sweeps`).	`cn`/`san_contains` (3+ caracteres, al menos uno requerido), `issuer`, `is_wildcard`, `is_precert`, `expired`, `first_seen_`/`not_after_` límites de fecha, `strict_attribution`, `resume_token` (continuación más allá del límite de resultados)
`get_sweep_results`	Consulta un trabajo de barrido y pagina sus resultados cuando termina (`GET /v1/sweeps/{id}`).	`sweep_id`, `page`/`limit` (hasta 1,000)
`get_usage`	Nivel del llamador, uso actual, cuota restante y derechos.	—
`get_historical_backfill_status`	Verifica / inicia el retroceso de historial profundo de pago para un dominio.	`domain`

Inicio rápido — MCP Inspector

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. Créala en https://ctindex.io/app/keys
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Anulación para implementaciones autoalojadas / 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 de seguridad de la cadena de suministro están documentados en SECURITY.md. Por favor, reporta vulnerabilidades a security@ctindex.io en lugar de abrir problemas públicos.

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 con tanto el SDK 2.0.0 como la última versión 2.x permitida. También instala el wheel compilado en un entorno nuevo y ejercita la inicialización, la enumeración de herramientas y las llamadas a través de stdio real. Los fixtures HTTP se ejecutan en loopback; las pruebas no requieren credenciales de producción.