Home Features Pricing
Log in Get started

MCP Tool Reference

The SiteVitals MCP exposes five tools. AI assistants discover and call these automatically — this reference is for developers and users who want to understand exactly what data is available.

Tools on this page
list_sites No params get_site_health 1 param get_site_uptime 2 params get_latest_checks 2 params get_ssl_domain_status 1 param
list_sites

Start here — always the first call.

No params

Returns all websites on your account with their current health scores. Always called first — it provides the site_id values required by every other tool.

Returns per site
  • ›Site ID, name, URL and detected platform
  • ›Current scores for uptime, SEO, security, speed, integrity and content (0–100)
  • ›SSL validity and current uptime status
  • ›Timestamp of last check in each monitoring category
Also returns a portfolio summary
  • ›Total site count
  • ›Number of sites currently down
  • ›Number of sites with SSL issues
Example: "Give me an overview of all my sites" — the AI calls this tool and summarises the portfolio.
get_site_health

Full health breakdown for one site.

1 param

Returns scores, trend direction and a plain-English status for each monitoring area of a specific site.

Parameters
Parameter Type Description
site_id * integer Site ID from list_sites
Returns per monitoring area

Covers: uptime, SEO, security, speed, integrity, content

  • › Score (0–100)
  • › Trend: improving stable declining
  • › Status: good needs attention critical
  • › Whether monitoring is enabled for each area
Example: "How is mysite.com doing?" — the AI resolves the site ID from list_sites then calls this tool.
get_site_uptime

Uptime history and incident log.

2 params

Returns recent uptime checks and any downtime incidents for a site, including availability percentage, average response time and a full incident list with durations.

Parameters
Parameter Type Description
site_id * integer Site ID from list_sites
days integer History window, 1–90. Defaults to 7.
Returns
  • ›Availability percentage and average response time for the period
  • ›Total check count, incident count and cumulative downtime in seconds
  • ›Per-incident detail: start time, resolution time, duration (human-readable)
  • ›Up to 50 most recent individual checks with status codes and response times
Example: "Did any of my sites go down last month?" — the AI calls this with days=30 for each site.
get_latest_checks

Specific SEO, security and speed findings.

2 params

Returns the most recent scan results for SEO, security and/or PageSpeed — including pass/fail/warning breakdowns and the specific issues found.

Parameters
Parameter Type Description
site_id * integer Site ID from list_sites
area string seo security speed all — defaults to all
Returns per area
SEO
  • ›Failed, warning and passed check counts
  • ›List of specific issues with plain-English messages
Security
  • ›Security score
  • ›Failed and warning check counts
  • ›Up to 20 specific failed test details with messages
Speed
  • ›Performance, Accessibility, SEO and Best Practices scores
  • ›All Core Web Vitals: LCP, FCP, CLS, TBT, INP, TTFB
  • ›Render-blocking time, JS execution time, total transfer size
Example: "What SEO issues does mysite.com have?" — the AI calls this with area=seo and explains each finding.
get_ssl_domain_status

SSL certificate and domain expiry.

1 param

Returns SSL certificate and domain registration expiry details with urgency flags — so the AI can proactively warn you about renewals before they become a problem.

Parameters
Parameter Type Description
site_id * integer Site ID from list_sites
Returns
  • › SSL: validity status, expiry date, days remaining, urgency flag
  • › Domain: name, expiry date, days remaining, urgency flag
SSL urgency thresholds
critical ≤ 7 days warning ≤ 30 days ok otherwise
Domain urgency thresholds
critical ≤ 14 days warning ≤ 60 days ok otherwise
Example: "Are any of my SSL certificates expiring soon?" — the AI checks every site and surfaces anything flagged critical or warning.
Next Overview Integrations