Analysis Toolswordpress_get_core_web_vitals

wordpress_get_core_web_vitals

Get Core Web Vitals metrics (LCP, FID, CLS) for a WordPress page.

wordpress_get_core_web_vitals

Get Core Web Vitals metrics (LCP, FID, CLS) for a page.

Parameters

3 parameters, none required.

NameTypeRequiredWhat it is
page_idnumbernoPage ID to measure. Resolved to its public permalink.
urlstringnoExplicit public URL to measure instead of a page ID.
strategystringnoDevice profile. Default mobile. One of: mobile, desktop. Default: "mobile".

Example call

No parameter is required, so the smallest valid call is empty:

{
  "name": "wordpress_get_core_web_vitals",
  "arguments": {}
}

Response

{
  "success": true,
  "metrics": {
    "lcp_ms": 2400,
    "fid_ms": 35,
    "cls": 0.06
  },
  "ratings": {
    "lcp": "needs-improvement",
    "fid": "good",
    "cls": "good"
  }
}

What it changes

Nothing. It only reads, so there is nothing to approve and nothing to undo.

When it fails

The failures seen most often on real sites in the last 30 days, most common first:

  • respira_pagespeed_rate_limited: Google PageSpeed refused the request because too many were made. Wait a minute and run it again.

How long it takes

A typical call takes about 1.6 seconds. 19 in 20 finish within 3.0 seconds. Measured on real sites over the last week, so it includes the site's own hosting.

Availability

Works on any WordPress site, whichever page builder it uses. Available since Respira 1.0.0.

Full Example

Prompt: "Get Core Web Vitals for page 42"

Response:

{
  "success": true,
  "metrics": {
    "lcp_ms": 1800,
    "fid_ms": 22,
    "cls": 0.02
  },
  "ratings": {
    "lcp": "good",
    "fid": "good",
    "cls": "good"
  }
}

Notes

  • Read-only tool - doesn’t modify content
  • Use it to establish a baseline before/after performance changes

Example Prompts

  • "Get Core Web Vitals for my homepage"
  • "What are the LCP/FID/CLS scores for page 42?"
  • "Check CLS on the pricing page"