lighthouse_budget
Evaluate a URL against a performance budget using Lighthouse scores and metrics. Get per-metric verdicts and overall pass/fail to gate deployments.
Instructions
Run PageSpeed Insights on a URL and verdict the results against a performance budget. Valid budget keys: higher-is-better Lighthouse scores on a 0-100 scale ('performance', 'accessibility', 'best-practices', 'seo'); lower-is-better latency in milliseconds ('LCP_ms', 'FCP_ms', 'TBT_ms', 'TTI_ms', 'speed_index_ms'); lower-is-better unitless shift score ('CLS'). Unknown keys are surfaced as a non-fatal finding with a 'did you mean' hint; the metric is NOT silently ignored. Returns per-metric verdict and an overall pass/fail. Useful as a CI / pre-deploy gate.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>",
"budget": "<budget>"
},
"name": "lighthouse_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Page URL to analyze. Required. | |
| budget | Yes | Budget dict. Lighthouse scores on the 0-100 scale (performance=80 means a score of 80, not 0.8); latency metrics in milliseconds (LCP_ms=2500 means 2.5 s); CLS is unitless (CLS=0.1 means a 0.1 layout-shift score). Example: {performance: 80, LCP_ms: 2500, CLS: 0.1}. | |
| strategy | No | Defaults to mobile. |