Skip to main content
Glama

opscheck

Read-only infrastructure health checks for AI agents, exposed as an MCP server.

Ask Claude (or any MCP client) things like:

"Which of these endpoints have certificates expiring in the next 30 days?" "Is the mail DNS for example.co.uk set up properly?" "Does mail.example.com offer STARTTLS on 25, and what TLS version does it negotiate?"

…and it answers using real checks rather than guessing.

Why read-only?

Giving an AI agent access to production is risky. Every tool in opscheck is observe-only by design: it performs a TLS handshake or DNS lookup and nothing else. Each tool is also marked with MCP's readOnlyHint / destructiveHint=false annotations so clients can see that it is safe to call. Inputs are validated (hostname format, port range, bulk limits) before anything touches the network.

The aim is to have the agent do the tedious checking while a human still makes and carries out any changes.

Related MCP server: mailtype-api

Tools

Tool

What it does

check_cert_expiry(host, port=443, warn_days=30)

Expiry, days remaining, issuer, SANs, TLS version, chain verification. Ports 25/587 automatically use SMTP STARTTLS.

check_cert_expiry_bulk(targets, warn_days=30)

Up to 25 host[:port] targets, sorted most-urgent first, with a status summary.

check_mail_dns(domain, dkim_selectors=None)

MX, SPF, DKIM and DMARC audit with plain-English findings (multiple SPF records, +all, >10 SPF lookups, p=none, missing rua, etc.).

Statuses: ok · warning · critical · expired · error.

Quick start (Windows)

cd E:\Claude\opscheck
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
pytest

Requires Python 3.11+.

Try it with the MCP Inspector

npx @modelcontextprotocol/inspector .\.venv\Scripts\python.exe -m opscheck.server

Connect it to Claude Desktop

Add this to %APPDATA%\Claude\claude_desktop_config.json (see claude_desktop_config.example.json), then restart Claude Desktop:

{
  "mcpServers": {
    "opscheck": {
      "command": "E:\\Claude\\opscheck\\.venv\\Scripts\\python.exe",
      "args": ["-m", "opscheck.server"]
    }
  }
}

Project layout

src/opscheck/
  server.py          MCP server: tool definitions + input validation
  checks/certs.py    TLS / STARTTLS certificate checks
  checks/maildns.py  MX / SPF / DKIM / DMARC lookups + pure analysers
tests/               Unit tests for analysers and validation (no network needed)

The analysis logic is kept separate from the network calls, so it can be tested offline.

Roadmap

  • TLS certificate expiry (HTTPS + SMTP STARTTLS)

  • Mail DNS audit (MX, SPF, DKIM, DMARC)

  • check_smtp: banner, EHLO extensions, STARTTLS, TLS version

  • Windows checks via PowerShell: pending updates, last patch date, service status

  • Postfix queue stats from a RHEL host

  • Container image + GitHub Actions CI

  • Run against a self-hosted open model as part of a private AI stack

Licence

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server for inspecting email domains and addresses, providing objective domain-level email infrastructure answers such as MX, SPF, DMARC, MTA-STS, and disposable-domain evidence.
      -
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables comprehensive TLS security audits for any domain, including certificate validity, expiry warnings, cipher suite weaknesses, deprecated protocols, and HSTS checks. Supports single and bulk domain inspection via MCP tools or a CLI for CI/CD integration.
      337 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to run read-only email deliverability checks and record generators, including SPF, DKIM, DMARC, MX, BIMI, MTA-STS, blacklist lookups, header analysis, cold-email and subject-line scoring, and SPF/DMARC/DKIM record creation.
      25 npm
      MIT