MCP Tool Reference — SiteVitals Docs

Tools on this page

list_sites No params list_properties No params get_site_health 1 param get_site_uptime 2 params get_latest_checks 2 params get_ssl_domain_status 1 param get_property_audit 1 param

list_sites

All monitored sites with current health scores.

No params

Returns every website on your account with current health scores. Provides the site_id values required by other tools. Use list_properties instead when working with client groups.

Returns per site

›Site ID, name, URL and detected platform
›Current scores for uptime, SEO, security, speed, integrity and content (0–100)
›Score trends (improving / stable / declining) per area
›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
›Number of sites needing attention

Example: "Give me an overview of all my sites" — the AI calls this tool and summarises the portfolio.

list_properties

All client groups with worst-case scores.

No params

Returns all properties on your account. A property is a named group of monitored URLs — typically one per client. Use this to get property_id values before calling get_property_audit.

Returns per property

›Property ID, name, and slug
›List of sites within the property (ID, name, URL)
›Worst-case scores across all sites for each health area
›Whether any site in the property needs attention
›Deduplicated list of problem areas across all sites

Example: "Which of my clients has the worst SEO score?" — the AI calls this tool and compares worst-case SEO scores across all properties.

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

Detailed SEO, security, speed and asset findings for one page.

2 params

Returns the most recent scan results for a single site across SEO, security, PageSpeed, and asset integrity — including pass/fail/warning breakdowns, specific issues found, and pre-computed advisory actions.

Parameters

Parameter	Type	Description
`site_id` *	integer	Site ID from `list_sites`
`area`	string	`seo` `security` `speed` `assets` `all` — defaults to `all`

Returns per area

SEO

›SEO score and AI readiness score (0–100)
›Failed, warning and passed check counts
›Issues array — warnings and failures only, with plain-English messages and sub-check detail
›Pre-computed advisory actions sorted by priority, each flagged for AI discoverability impact
›List of check areas with AI discoverability impact

Security

›Security score and failed/warning counts
›Per-section breakdown: HTTP headers, cookies, JavaScript, forms, page integrity, mixed content, software
›Flat issues list sorted by severity — all fails and warnings across all sections

Speed

›Performance, Accessibility, Best Practices scores — each with pass/warn/fail status
›All Core Web Vitals (LCP, FCP, CLS, TBT, INP, TTFB, Speed Index) with pre-computed statuses
›LCP breakdown: dominant phase, element, TTFB, render delay
›Page weight breakdown by resource type
›Render-blocking URLs, unsized image URLs, slowest third-party scripts
›Performance trends across recent checks
›Prioritised action items from the Lighthouse report

Assets

›Asset check score (0–100) with pass/warn/fail status
›Total asset count and broken asset count
›Asset type breakdown (images, scripts, stylesheets, other)
›HTTP status code distribution
›List of broken assets with URL, type, status code and error message

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 ≤ 30 days warning 31–60 days ok otherwise

Domain urgency thresholds

critical ≤ 30 days warning 31–90 days ok otherwise

Example: "Are any of my SSL certificates expiring soon?" — the AI checks every site and surfaces anything flagged critical or warning.

get_property_audit

Full multi-page audit bundle for a client group.

1 param

Returns a complete audit bundle for all sites in a property. The primary page (typically the homepage) receives full check detail. Secondary pages receive scores and issues only. Aggregate data identifies issues that appear across multiple pages. Use list_properties first to get the property ID.

Parameters

Parameter	Type	Description
`property_id` *	integer	Property ID from `list_properties`

Returns

Primary page — full detail

›Full SEO check data including issues, advisory actions, and AI readiness score
›Full security check data including per-section breakdown and sorted issues list
›Full speed check data including Core Web Vitals, LCP breakdown, page weight, and Lighthouse action items
›Asset check data including broken asset list
›Uptime summary and incident history (if uptime monitoring is enabled)
›SSL certificate and domain expiry data

Secondary pages — summary

›Health scores per area
›SEO and security issues lists (flat, no sub-check expansion)
›Core Web Vitals and Lighthouse scores
›Asset check score and broken asset count
›Uptime summary (if enabled)
›SSL and domain data (only if on a different domain from the primary page)

Aggregate

›Worst-case scores across all pages per health area
›Deduplicated problem areas across the property
›Site-wide issues — actions that appear on two or more pages
›Merged advisory action list with page count and scope per action

Example: "Generate a full audit report for Jericho Writers" — the AI calls list_properties to find the property ID, then calls this tool to gather all the data needed for the report.