SiteHealth MCP README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the SiteHealth MCP listing page.

SiteHealth MCP

npm License: MIT MCPize

Full website health audit in one MCP tool call. Zero API keys required.

One call. Six checks. Scored report.

One-click install: Install on MCPize | npx sitehealth-mcp

Features

  • SSL Certificate — validity, expiry, issuer, protocol, SANs
  • DNS Health — A/AAAA/MX/NS/CNAME/TXT/SOA, IPv6, resolution time
  • Email Auth — DMARC, SPF, DKIM validation with fix recommendations
  • Page Performance — TTFB, load time, page weight, compression, caching
  • Uptime — HTTP ping with response time
  • Broken Links — extract and check page links for 4xx/5xx responses
  • Health Score — weighted 0-100 score with letter grade (A-F)

Quick Start

config.json
{
  "mcpServers": {
    "sitehealth": {
      "command": "npx",
      "args": ["-y", "sitehealth-mcp"]
    }
  }
}

Then ask your AI agent:

"Audit the health of example.com"

Tools

ToolDescription
audit_siteFull audit — all 6 checks, scored report
check_sslSSL cert validity and expiry
check_dnsDNS records and resolution
check_email_authDMARC/SPF/DKIM validation
check_performanceTTFB, load time, page weight
check_uptimeHTTP ping + response time
check_linksBroken link detection

Free vs Pro

ToolFreePro ($19/mo)
check_sslYesYes
check_dnsYesYes
audit_site-Yes
check_email_auth-Yes
check_performance-Yes
check_uptime-Yes
check_links-Yes

Free tier gives you SSL and DNS checks. Pro unlocks the full 6-check audit with A-F scoring, email authentication, performance, uptime, and broken link detection.

Upgrade to Pro on MCPize — $19/mo or $190/yr.

Example Output

config.json
{
  "url": "https://example.com",
  "overallScore": 82,
  "overallGrade": "B",
  "criticalIssues": [
    "No DMARC record — required by Gmail/Yahoo/Microsoft for deliverability"
  ],
  "warnings": [
    "SSL certificate expires in 28 days — renew soon",
    "2 broken links found out of 47 checked"
  ],
  "recommendations": [
    "Add a DMARC record: v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com",
    "Enable gzip/brotli compression to reduce transfer size"
  ]
}

How It Works

All checks use Node.js builtins (tls, dns/promises, fetch) — no external API keys, no costs, no rate limits.

Code
audit_site("example.com")
  ├── SSL check     (tls socket)      → cert validity, expiry
  ├── DNS check     (dns/promises)    → record resolution
  ├── Email auth    (DNS TXT lookups) → DMARC, SPF, DKIM
  ├── Performance   (timed fetch)     → TTFB, page weight
  ├── Uptime        (HEAD request)    → reachability
  └── Broken links  (page crawl)     → link validation
        ↓
  Weighted score (0-100) + grade (A-F) + recommendations

Scoring Weights

CheckWeight
SSL20%
Performance20%
Uptime20%
Email Auth15%
Links15%
DNS10%

Install

MCPize (Recommended)

One-click install with managed hosting: Install on MCPize

npm

Terminal
npx sitehealth-mcp

License

MIT — Built by Freedom Engineers

Related