dryRun, expectedVersion and confirmation tokens. Examples use synthetic data.
update_action_status
Move an Action Center recommendation to another status.Parameters
Example
add_site_pages
Add up to 50 URLs of the workspace domain to Site Diagnostics. Adding a page does not audit it.Parameters
URLs that are already monitored are reported as such rather than duplicated.
Example
start_site_audit
Audit up to 50 selected pages, or all monitored pages withall (at most 10,000). The MCP call is free. As in the dashboard, each audited page uses 5 credits: the balance is checked when the audit is accepted, each page reserves its credits when its audit starts, and spends them when results are saved. creditsReserved is a budget, not an immediate hold or the final amount spent. Every execution needs a confirmation token, bound to the exact pages it previewed.
Parameters
Pages that are already being audited are skipped. An audit of more than 100 pages to audit is returned at once with its pages
QUEUED; a background job running every five minutes queues them. Queueing is retried within 24 hours of acceptance, with at most 12 attempts, and pages the queue has not taken by then fail. Follow that same audit with get_site_audit. To be notified by your own systems, subscribe to site_audit.completed with the REST API.
An insufficient balance detected before acceptance prevents the audit from starting. If the balance is spent after acceptance, a credit refusal is returned only when no page started and the call queued the audit itself (100 pages to audit or fewer); it includes details.auditId, so read that retained audit. In every other case the audit is returned: the pages that could not start fail and the pages already started keep running. An accepted audit remains available if queueing is interrupted and resumes automatically with the same ID. COMPLETED means all pages have a final result, including failures and skipped pages; inspect the counts. A later audit cannot change these results.
Example
Related
- Audit pages until site_audit.completed for the REST workflow.
- Strategic tools for the Action Center and Site Diagnostics read tools.

