Skip to main content
Glama

List audits

list_audits
Read-only

List the organization's audit runs: currently active (pending/running) plus recent runs of any status. Pass website_id (from list_websites) to get one website's full audit history, oldest runs included, and page through it with limit/offset using the returned total/has_more. This is the way to reach the preserved reports of a soft-deleted website: its runs still list under its old website_id. total/has_more describe the recent array only, and recent already includes any pending/running run, so active is a live view of those same runs and not extra items to add to the count. Use the run ids with get_audit_status or get_report, and website ids with list_issues. Numbers on a recent run come from its published report (#1700): health_score is that report's overall score (the same value as get_report's summary.healthScore; null when the site was blocked or down, which earns no grade) and issues_found is the report's failing + warning checks (its summary.failed + summary.warnings). health_score is the metric to compare run over run: it is the only one rescored consistently across the whole site. Do NOT compare issues_found with the open count from list_issues: the issue tracker folds a rule failing on many pages into one open issue and carries issues forward until they are re-checked, so its count is legitimately much smaller and moves independently.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMax recent runs to return (default 20, max 100).
offsetNoPagination offset into the recent runs (default 0). Use with total/has_more.
website_idNoOnly return runs of this website (id from list_websites, run_audit, or add_website). Works for soft-deleted websites too.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / additionalProperties
      Added value: +{}
  2. Changed3 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • removedInput schema / additionalProperties
      Removed value: -false
    • addedInput schema / properties / offset / maximum
      Added value: +9007199254740991
  3. Changed4 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"Max recent runs to return (default 20)."New value: +"Max recent runs to return (default 20, max 100)."
    • changedInput schema / properties / limit / maximum
      Previous value: -50New value: +100
    • addedInput schema / properties / offset
      Added value: +{
      +  "description": "Pagination offset into the recent runs (default 0). Use with total/has_more.",
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / website_id
      Added value: +{
      +  "description": "Only return runs of this website (id from list_websites, run_audit, or add_website). Works for soft-deleted websites too.",
      +  "type": "string"
      +}
  4. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.