SEO

list_seo_fixes

Vidrys's proposed fixes to page titles, meta descriptions and canonical tags: what each page has, what it would get, and where each fix stands (proposed, approved, published, verified, rolled back).

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/fixes

Try asking

“Which SEO fixes are waiting for our approval?”

list_seo_fixes

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

structuredContent

{
  "content": [
    {
      "type": "text",
      "text": "…the same JSON, as text…"
    }
  ],
  "structuredContent": {
    "mode": "on",
    "deploys_remaining": 54,
    "fixes": [
      {
        "id": "d4e5f6a7-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
        "url": "https://acmeinvoicing.com/pricing",
        "fix_type": "meta_description",
        "label": "Meta description",
        "status": "verified",
        "current_value": null,
        "proposed_value": "Plans from ₹999 a month for freelancers and small teams, GST invoices included.",
        "rationale": "Taken from the opening of this page's own text, fitted to 50-160 characters.",
        "provider": "ghost",
        "dry_run": false,
        "written": true,
        "deployed_at": "2026-09-27T09:12:40+00:00",
        "verified_at": "2026-09-27T09:13:51+00:00",
        "error": null,
        "created_at": "2026-09-27T03:41:02+00:00",
        "updated_at": "2026-09-27T09:13:51+00:00"
      }
    ],
    "page": {
      "page": 1,
      "page_size": 50,
      "total": 1
    }
  },
  "isError": false
}

Arguments

Passed as the tool call's arguments.

project_idstringrequired

The project to read, from list_projects.

pageintegerdefault 1

Page number, from 1.

page_sizeintegerdefault 50

Rows per page, up to 100.

Result

The same object as List SEO fixes, returned as structured output.

modestring

Whether this deployment writes fixes: off, dry runs only, or on.

Values:offshadowon

deploys_remaininginteger

Fixes the plan still allows this month.

fixesobject[]

Every fix of the project, newest first.

+Show child attributes

idstring

Fix id.

urlstring

The page.

fix_typestring

The field it changes.

Values:titlemeta_descriptioncanonical

labelstring

The field's name on the screen.

statusstring

Where the fix stands. verified means the live page carries the value; unverified means it was written but the page does not show it.

Values:proposedapproveddeployingdeployedverifiedunverifiedfailedrolling_backrolled_backdismissed

current_valuestringnullable

What the page had when the fix was proposed. Null: nothing.

proposed_valuestringnullable

What the fix sets.

rationalestringnullable

Where the value came from.

providerstringnullable

The CMS it is written through, once known.

dry_runboolean

Approving now would run, or ran, as a dry run.

writtenbooleannullable

Whether Vidrys itself wrote the value. False when it was found already in place.

deployed_atstringnullable

When it was written, ISO 8601.

verified_atstringnullable

When the live page was found carrying it.

errorstringnullable

Why it failed, when it did.

created_atstring

ISO 8601.

updated_atstring

ISO 8601.

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.