CertIndex MCP

공식

유일한 인증서 투명성 MCP 서버입니다. 21억 5천만 개 이상의 TLS 인증서를 검색하고, 새로운 발급을 위해 도메인을 모니터링하며, 글로벌 CT 파이어호스를 에이전트로 스트리밍합니다.

GitHub

Cert Index MCP(으)로 무엇을 할 수 있나요?

도메인 또는 지문으로 인증서 검색 — search_certificates를 사용하여 도메인 이름 또는 SHA-256 지문으로 TLS 인증서를 찾습니다.
전체 인증서 세부 정보 가져오기 — get_certificate로 특정 인증서의 PEM 데이터, CT 로그 메타데이터 및 파싱된 필드를 가져옵니다.
도메인의 모든 인증서 나열 — get_domain_certificates를 사용하여 도메인에 대해 발급된 모든 인증서를 가져옵니다.
CT 로그에서 서브도메인 검색 — get_subdomains를 통해 주어진 도메인의 인증서에서 관찰된 서브도메인을 열거합니다.
가장 최근 인증서 확인 — get_latest_cert로 도메인에 대해 가장 최근에 발급된 인증서를 검색합니다.
만료 임박 인증서 찾기 — get_expiring_certs를 사용하여 지정된 일수 내에 만료되는 인증서를 식별합니다.

문서

certindex-mcp

An MCP (Model Context Protocol) server that exposes CertIndex's Certificate Transparency search tools to any MCP-compatible client (Claude Desktop, the MCP Inspector, Continue, etc.).

CertIndex indexes the full public CT corpus (~5 M certificates, growing ~100 k/day). This server wraps the public CertIndex REST API so an LLM can ask questions like:

"List every TLS certificate ever issued for example.com."
"What subdomains has Let's Encrypt seen for mycompany.io?"
"Show me certs expiring in the next 30 days for api.mycompany.io."
"Pull the full PEM and CT log metadata for SHA-256 <fingerprint>."

Why this repo exists

The CertIndex monorepo bundles an MCP server (mounted at https://api.ctindex.io/mcp) that talks directly to the production Postgres index. This standalone package is a thin client-side shim: it speaks MCP to your editor / agent and forwards every tool call to the hosted CertIndex REST API over HTTPS. Two consequences:

You don't need a copy of the index — sign up for a free API key at https://ctindex.io and you're done.
The package has a tiny dependency footprint (mcp, httpx, pydantic) — easy to audit, easy to vendor, no DB drivers.

Install

pip install certindex-mcp

Or with uvx for one-shot use:

uvx certindex-mcp

To install the latest development version from source instead:

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

Quickstart — Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Restart Claude Desktop. The six CertIndex tools (search_certificates, get_certificate, get_domain_certificates, get_subdomains, get_latest_cert, get_expiring_certs) appear in the tool tray.

Quickstart — MCP Inspector

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

Configuration

Env var	Default	Description
`CERTINDEX_API_KEY`	(required)	Your CertIndex API key. Mint one at https://ctindex.io/app/keys
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Override for self-hosted deployments / staging
`CERTINDEX_TIMEOUT`	`30`	Per-request HTTP timeout (seconds)

Security

Input validation, rate-limit handling, and our supply-chain posture are documented in SECURITY.md. Please report vulnerabilities to security@ctindex.io rather than filing public issues.

Development

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

CI runs on Python 3.11 / 3.12 / 3.13.