Open Source MCP Server · v1.0.6

Web Performance Analysis
Powered by AI

The most comprehensive MCP server for Google PageSpeed Insights. Get Lighthouse audits, Core Web Vitals, smart recommendations, and deep diagnostics — all through natural language in Claude, Codex, or any MCP client.

16
Analysis Tools
5
Audit Categories
50+
Metrics Tracked
MIT
License

Works with your favorite AI tools

Claude Desktop
OpenAI Codex
Windsurf
Any MCP Client
Docker

See It In Action

Watch how PageSpeed MCP analyzes any website in seconds, right from your AI assistant.

C
Claude + PageSpeed MCP
pagespeed-insights-mcp connected
pagespeed-insights-mcp — stdio transport

16 Powerful Analysis Tools

Everything you need to diagnose, optimize, and monitor web performance — accessible through natural language.

🚀

analyze_page_speed

Full Lighthouse analysis with performance scores, Core Web Vitals, and detailed metrics for any URL.

Core

get_performance_summary

Quick performance overview with key metrics and top optimization opportunities at a glance.

Quick
🎯

get_recommendations

AI-powered smart recommendations with priority scoring and actionable code fixes.

Smart
📷

get_visual_analysis

Screenshots, filmstrip timeline, and full-page captures showing load progression visually.

Visual
🌐

get_network_analysis

Detailed request waterfall with timing, sizes, priorities, RTT, and server latency data.

Deep Dive

get_javascript_analysis

JS bootup time, main thread breakdown, unused code detection, and duplicate modules.

Performance
🖼️

get_image_optimization_details

Find oversized images, lazy-load candidates, and modern format (WebP/AVIF) savings.

Optimization
🚫

get_render_blocking_details

Identify render-blocking CSS/JS, critical request chains, and total blocking time.

Critical Path
🔌

get_third_party_impact

Third-party script analysis grouped by provider with transfer sizes and blocking times.

Third-Party
🎯

get_element_analysis

DOM-level debugging: LCP element details, CLS-causing elements, lazy-loaded LCP warnings.

Debugging
📊

get_full_audit

Comprehensive audit across all categories: Performance, SEO, Accessibility, Best Practices.

Complete
📈

crux_summary

Real-world Chrome UX Report field data with Core Web Vitals from actual users.

Field Data
🔄

compare_pages

Side-by-side comparison of two URLs with metric-by-metric performance diff.

Compare
📑

full_report

Unified report combining Lighthouse lab data with CrUX real-world field data.

Unified
📦

batch_analyze

Analyze up to 10 URLs simultaneously with progress tracking and aggregate results.

Batch
🗃️

clear_cache

Clear internal cache to force fresh API requests for all subsequent analyses.

Utility

Beautiful, Actionable Reports

Get Lighthouse scores and Core Web Vitals presented clearly, with color-coded results and priorities.

67
Performance
92
Accessibility
96
Best Practices
100
SEO
1.2s
First Contentful Paint
2.4s
Largest Contentful Paint
0.00
Cumulative Layout Shift
4.8s
Speed Index
60ms
Total Blocking Time
120ms
Server Response Time

Up and Running in 60 Seconds

Three simple steps to unlock AI-powered web performance analysis.

1

Get Your API Key

Enable PageSpeed Insights API in Google Cloud Console and create an API key.

export GOOGLE_API_KEY=your-key
2

Configure Your Client

Add the MCP server to your Claude Desktop, Codex, or any MCP-compatible client.

{ "mcpServers": { "pagespeed-insights": { "command": "npx", "args": ["pagespeed-insights-mcp"] } } }
3

Start Analyzing

Just ask in natural language! "Analyze the performance of my website" — that's it.

"Analyze https://example.com for mobile devices"

Get Insights

Receive comprehensive reports with scores, metrics, and prioritized recommendations.

Performance: 92/100 ✅ LCP: 1.8s ✅ CLS: 0.02 ✅

Beyond Manual Testing

Stop switching between browser tabs. Get everything through your AI assistant.

Feature Manual PageSpeed PageSpeed MCP
Natural Language Interface
Batch URL Analysis (10+)
Smart Recommendations
Side-by-Side Comparison
CrUX Real-World Data Basic ✓ Detailed
Element-Level Debugging
Network Waterfall
JS Profiling
Third-Party Impact
Intelligent Caching
Docker Support N/A
Localization (i18n) Limited ✓ Full

Ready to Supercharge
Your Performance Workflow?

Install in one command. Start analyzing in seconds.

$ npx pagespeed-insights-mcp


View on GitHub View on npm Documentation