SiteHealth MCP

Full website health audit — SSL, DNS, DMARC/SPF/DKIM, performance, uptime, links

OtherTypeScriptv0.1.1

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

{
  "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

{
  "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.

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

npx sitehealth-mcp

License

MIT — Built by Freedom Engineers

Related

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y sitehealth-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-carsonroell-debug-sitehealth-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sitehealth-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

sitehealth-mcpnpm

Compatible MCP Clients

SiteHealth MCP works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More