CertIndex MCP

oficial

O único servidor MCP de transparência de certificados. Pesquise mais de 2,15 bilhões de certificados TLS, monitore domínios para novas emissões, transmita o fluxo global de CT para seu agente.

GitHub

O que você pode fazer com Cert Index MCP?

Pesquisar certificados por domínio ou impressão digital — Encontre certificados TLS usando search_certificates com um nome de domínio ou impressão digital SHA-256.
Recuperar detalhes completos do certificado — Obtenha dados PEM, metadados de log CT e campos analisados para um certificado específico com get_certificate.
Listar todos os certificados de um domínio — Obtenha todos os certificados já emitidos para um domínio usando get_domain_certificates.
Descobrir subdomínios a partir de logs CT — Enumere subdomínios observados em certificados para um determinado domínio via get_subdomains.
Verificar o certificado mais recente — Recupere o certificado emitido mais recente para um domínio com get_latest_cert.
Encontrar certificados próximos da expiração — Identifique certificados que expiram dentro de um número especificado de dias usando get_expiring_certs.

Documentação

certindex-mcp

Um servidor MCP (Model Context Protocol) que expõe as ferramentas de busca de Transparência de Certificados do CertIndex para qualquer cliente compatível com MCP (Claude Desktop, MCP Inspector, Continue, etc.).

O CertIndex indexa todo o corpus público de CT (~5 milhões de certificados, crescendo ~100 mil/dia). Este servidor encapsula a API REST pública do CertIndex para que um LLM possa fazer perguntas como:

"Liste todos os certificados TLS já emitidos para example.com."
"Quais subdomínios o Let's Encrypt já viu para mycompany.io?"
"Mostre os certificados que expiram nos próximos 30 dias para api.mycompany.io."
"Obtenha o PEM completo e os metadados de log CT para SHA-256 <fingerprint>."

Por que este repositório existe

O monorepo do CertIndex inclui um servidor MCP (montado em https://api.ctindex.io/mcp) que se comunica diretamente com o índice Postgres de produção. Este pacote independente é um shim fino do lado do cliente: ele fala MCP com seu editor/agente e encaminha cada chamada de ferramenta para a API REST hospedada do CertIndex via HTTPS. Duas consequências:

Você não precisa de uma cópia do índice — cadastre-se para obter uma chave de API gratuita em https://ctindex.io e pronto.
O pacote tem uma pegada de dependências minúscula (mcp, httpx, pydantic) — fácil de auditar, fácil de incorporar, sem drivers de BD.

Instalação

pip install certindex-mcp

Ou com uvx para uso único:

uvx certindex-mcp

Para instalar a versão de desenvolvimento mais recente a partir do código-fonte:

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

Início rápido — Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Reinicie o Claude Desktop. As seis ferramentas do CertIndex (search_certificates, get_certificate, get_domain_certificates, get_subdomains, get_latest_cert, get_expiring_certs) aparecerão na bandeja de ferramentas.

Início rápido — MCP Inspector

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

Configuração

Variável de ambiente	Padrão	Descrição
`CERTINDEX_API_KEY`	(obrigatório)	Sua chave de API do CertIndex. Crie uma em https://ctindex.io/app/keys
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Substituição para implantações auto-hospedadas / staging
`CERTINDEX_TIMEOUT`	`30`	Tempo limite HTTP por requisição (segundos)

Segurança

A validação de entrada, o tratamento de limite de taxa e nossa postura na cadeia de suprimentos estão documentados em SECURITY.md. Por favor, relate vulnerabilidades para security@ctindex.io em vez de abrir issues públicas.

Desenvolvimento

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

A CI é executada no Python 3.11 / 3.12 / 3.13.