sitehealth-mcp
v0.1.1
Published
Full website health audit in one MCP tool call — SSL, DNS, DMARC/SPF/DKIM, performance, uptime, broken links
Maintainers
Readme
SiteHealth MCP
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
| Tool | Description |
|------|-------------|
| audit_site | Full audit — all 6 checks, scored report |
| check_ssl | SSL cert validity and expiry |
| check_dns | DNS records and resolution |
| check_email_auth | DMARC/SPF/DKIM validation |
| check_performance | TTFB, load time, page weight |
| check_uptime | HTTP ping + response time |
| check_links | Broken link detection |
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:[email protected]",
"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) + recommendationsScoring Weights
| Check | Weight | |-------|--------| | SSL | 20% | | Performance | 20% | | Uptime | 20% | | Email Auth | 15% | | Links | 15% | | DNS | 10% |
Install
MCPize (Recommended)
One-click install with managed hosting: Install on MCPize
npm
npx sitehealth-mcpLicense
MIT — Built by Freedom Engineers
Related
- SelfHeal MCP — Self-healing proxy for MCP servers
- LeadEnrich MCP — Waterfall lead enrichment
