LightScout MCP
Integrates Lighthouse to perform Core Web Vitals analysis, allowing users to analyze URL performance, compare metrics between pages, verify against performance thresholds, and crawl sites for comprehensive auditing.
LightScout MCP
Part of the TestScout MCP Suite — AI-powered QA tools for modern development teams.
Core Web Vitals analysis powered by Lighthouse. Runs as an MCP server for AI coding tools (Claude Code, Cursor, Windsurf, etc.) or as a standalone CLI for CI pipelines and terminals. Four tools: analyze a URL, compare two URLs, check against thresholds, or crawl an entire site.
Requirements
Node.js >= 18
Google Chrome or Chromium
Related MCP server: Lighthouse MCP
MCP Server Setup
Claude Code
claude mcp add lightscout -- npx -y lightscout-mcpCursor, VS Code, Windsurf, Cline, Roo Code, Gemini CLI
All use the same mcpServers JSON format. Add this to the appropriate config file:
{
"mcpServers": {
"lightscout": {
"command": "npx",
"args": ["-y", "lightscout-mcp"]
}
}
}Client | Config file |
Cursor |
|
VS Code (Copilot) |
|
Windsurf |
|
Cline | Settings > MCP > Edit Config |
Roo Code |
|
Gemini CLI |
|
Zed
Zed uses context_servers instead of mcpServers:
{
"context_servers": {
"lightscout": {
"command": "npx",
"args": ["-y", "lightscout-mcp"]
}
}
}CLI
Install
npm install -g lightscout-mcpTry without installing
npx -p lightscout-mcp lightscout analyze https://example.comCommands
lightscout analyze <url> [--device mobile|desktop] [--categories perf,a11y,seo,best-practices]
lightscout compare <urlA> [urlB] [--device mobile|desktop]
lightscout crawl <url> [--max-pages N] [--device mobile|desktop]
lightscout check <url> [--perf 90] [--lcp 2500] [--fcp 3000] [--cls 0.1] [--tbt 300] [--ttfb 1800]Examples
Analyze a single page:
lightscout analyze https://example.com
lightscout analyze https://example.com --device desktop --categories performance,accessibilityCompare two URLs, or the same URL on mobile vs desktop:
lightscout compare https://a.com https://b.com
lightscout compare https://example.com # mobile vs desktopCrawl a site and audit discovered pages:
lightscout crawl https://example.com --max-pages 5CI quality gate (exits 1 on failure):
lightscout check https://example.com --perf 90 --lcp 2500Tools
analyze_performance
Run Lighthouse on a URL. Returns performance scores, Core Web Vitals (LCP, FCP, CLS, TBT, SI, TTFB) with good/needs-improvement/poor ratings, top recommendations sorted by impact, and diagnostics.
Parameter | Type | Required | Description |
| string | yes | URL to analyze |
|
| no | Device emulation (default: mobile) |
| string[] | no | Lighthouse categories (default: |
compare_performance
Compare Core Web Vitals between two URLs, or the same URL on mobile vs desktop. Shows per-metric deltas with winner indicators.
Parameter | Type | Required | Description |
| string | yes | First URL |
| string | no | Second URL. If omitted, compares urlA mobile vs desktop |
|
| no | Device emulation when comparing two URLs (default: mobile) |
check_threshold
Pass/fail check against performance thresholds. Useful for CI quality gates.
Parameter | Type | Required | Description |
| string | yes | URL to check |
|
| no | Device emulation (default: mobile) |
| object | no | Custom thresholds (see defaults below) |
Default thresholds use Google's "poor" boundary -- only fails if metrics are genuinely bad:
Metric | Default (fail if worse) |
performance | < 50 |
LCP | > 4000ms |
FCP | > 3000ms |
CLS | > 0.25 |
TBT | > 600ms |
TTFB | > 1800ms |
crawl_site
Discover pages on a site (via sitemap.xml or link crawling) and run Lighthouse on each. Returns per-page results plus site-wide summary with avg/min/max scores and common issues.
Parameter | Type | Required | Description |
| string | yes | Site URL or homepage to crawl |
|
| no | Device emulation (default: mobile) |
| number | no | Maximum pages to analyze (default: 20, max: 20) |
Pages are discovered via sitemap.xml first, falling back to link crawling. Up to 3 Lighthouse runs execute in parallel.
CWV Rating Thresholds
Metric | Good | Needs Improvement | Poor |
LCP | <= 2500ms | 2500-4000ms | > 4000ms |
FCP | <= 1800ms | 1800-3000ms | > 3000ms |
CLS | <= 0.1 | 0.1-0.25 | > 0.25 |
TBT | <= 200ms | 200-600ms | > 600ms |
SI | <= 3400ms | 3400-5800ms | > 5800ms |
TTFB | <= 800ms | 800-1800ms | > 1800ms |
Notes
TBT (Total Blocking Time) is used instead of INP/FID because Lighthouse runs lab-only tests with no real user interaction.
Up to 3 concurrent Lighthouse runs (semaphore-controlled).
Chrome is launched headless and killed after each audit.
MCP responses are token-optimized with condensed metrics and compact JSON.
TestScout MCP Suite
LightScout is the first tool in the TestScout MCP Suite. More tools are coming:
Tool | Description | Status |
lightscout-mcp | Core Web Vitals & Lighthouse analysis | Available |
testscout-diagnose | Error triage & root cause analysis | Coming soon |
testscout-scrape | Structured data extraction for testing | Coming soon |
testscout-plan | AI test plan & code generation | Coming soon |
testscout-load | Load test generation & analysis | Coming soon |
testscout-maintain | Self-healing test maintenance | Coming soon |
Follow development at testscout.dev.
License
MIT
Available Tools
4 toolsanalyze_performanceA
Run Lighthouse on a URL and get Core Web Vitals scores, metrics, and prioritized recommendations. Returns LCP, FCP, CLS, TBT, SI, TTFB with good/needs-improvement/poor ratings.
Inputs: url (required), device, categories.
check_thresholdA
Pass/fail check against performance thresholds. Use for CI quality gates. Defaults use Google's 'poor' thresholds — only fails if metrics are genuinely bad.
Inputs: url (required), device, thresholds.
compare_performanceA
Compare Core Web Vitals between two URLs, or the same URL on mobile vs desktop. Shows per-metric deltas with winner indicators.
Inputs: urlA (required), urlB, device.
crawl_siteA
Discover all pages on a site (via sitemap.xml or link crawling) and run Lighthouse on each. Returns per-page results plus site-wide summary with avg/min/max scores and common issues. Max 20 pages, 3 parallel runs.
Inputs: url (required), device, maxPages.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: single URL analysis, threshold pass/fail check, two-URL comparison, and multi-page crawl. No overlap or ambiguity.
All tools follow a consistent verb_noun pattern with lowercase underscores: analyze_performance, check_threshold, compare_performance, crawl_site. No deviations.
Four tools is well-scoped for the performance auditing domain. Each tool serves a necessary function without bloat or deficiency.
Core workflows (single analysis, comparison, crawl, CI gate) are covered. Minor gap: no tool for customizing thresholds, but defaults are sensible.
Maintenance
Related MCP Connectors
Lighthouse scores, Core Web Vitals (LCP, CLS, INP/TBT) and top fixes for any URL, mobile or desktop.
Core Web Vitals and Lighthouse, as one MCP tool through Apify
Bulk PageSpeed Insights and Core Web Vitals (LCP, INP, CLS) for many URLs. Runs on Apify.
Run SEO + AI-visibility (GEO) audits from Claude, Cursor & other AI clients.
Related MCP Servers
- AlicenseCqualityBmaintenanceAllows AI assistants such as Cursor/Cline/GitHub Copilot to use Google's lighthouse tool to measure perf metrics for your webpage. You can then run an agentic loop and get the assistants to optimize those metrics!23,405 npm219MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI models to perform Google Lighthouse website performance analysis, including Core Web Vitals, accessibility, SEO audits, and actionable optimization recommendations. Provides comprehensive web performance insights through natural language interactions.3,405 npm4MIT
- AlicenseAqualityBmaintenance16-tool MCP server for Google PageSpeed Insights & Chrome UX Report APIs. Analyze, compare, and optimize web performance directly through Claude, Cursor, or any MCP-compatible AI client.681Apache 2.0
- AlicenseAqualityDmaintenanceEnables running Lighthouse web performance audits via MCP, providing Core Web Vitals, performance scores, and optimization suggestions for single or multiple URLs.21MIT