SEO

list_site_health_issues

The pages failing each site health check, with the detail and whether Vidrys can fix it, and whether each issue is new, persistent or newly checked.

readReads only. Annotated read-only, so a client can call it without asking.

Plan: Track and above
Rate cost: 1 unit
REST: GET /projects/{project_id}/seo/site-health/issues

Try asking

“Which pages are missing a meta description?”

list_site_health_issues

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_site_health_issues",
    "arguments": {
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "fix_eligible": true
    }
  }
}

structuredContent

{
  "content": [
    {
      "type": "text",
      "text": "…the same JSON, as text…"
    }
  ],
  "structuredContent": {
    "issues": [
      {
        "id": "c3d4e5f6-7a8b-4c9d-8e0f-1a2b3c4d5e6f",
        "url": "https://acmeinvoicing.com/pricing",
        "check_id": "meta_description",
        "severity": "medium",
        "detail_json": "{\"reason\": \"missing\"}",
        "summary": "No meta description",
        "fix_eligible": true,
        "fix_note": null,
        "fix_id": null,
        "fix_status": null,
        "change": "persistent"
      }
    ],
    "page": {
      "page": 1,
      "page_size": 50,
      "total": 41
    }
  },
  "isError": false
}

Arguments

Passed as the tool call's arguments.

project_idstringrequired

The project to read, from list_projects.

fix_eligiblebooleandefault false

Only issues Vidrys can propose a fix for.

pageintegerdefault 1

Page number, from 1.

page_sizeintegerdefault 50

Rows per page, up to 100.

Result

The same object as List site health issues, returned as structured output.

issuesobject[]

One row per failing check on one page.

+Show child attributes

idstring

Issue id.

urlstring

The page.

check_idstring

The check that failed.

severitystring

How much it matters.

Values:criticalhighmediumlow

detail_jsonstring

What was found, as a JSON document — a reason and the values behind it.

summarystring

What was found, in a line: 68 characters, over 60: “…”.

fix_eligibleboolean

Whether Vidrys can propose a fix for it: only a title, meta description or canonical tag the page has none of.

fix_notestringnullable

On a field Vidrys does write, why this issue is still yours. Null otherwise.

fix_idstringnullable

The fix Vidrys proposed for this page's field, as List SEO fixes lists it. Null when there is none.

fix_statusstringnullable

Where that fix stands. Null when there is none.

Values:proposedapproveddeployingdeployedverifiedunverifiedfailedrolling_backrolled_backdismissed

changestringnullable

Against the previous audit. Null when there is none.

Values:newpersistentnewly_checked

pageobject

Where these rows sit in the full list.

+Show child attributes

pageinteger

This page's number, from 1.

page_sizeinteger

Rows per page.

totalinteger

Rows across every page.

Errors

404 not_found	The project or item doesn't exist in this workspace. A project from another workspace also returns 404, never 403.
422 invalid_request	A parameter or body field is missing or has the wrong type or value. The message names the field. Also returned when a write would pass the plan's prompt limit.
401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on every plan from Track up — Solo is the one without it.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.

Failures arrive as a tool error — isError: true with code: message as text. See Using the tools.