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.

Get Started
Watch Demo
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
⚡ Live Demo

## 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
🔧 Tool Suite

## 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
📊 Live Metrics Preview

## Beautiful, Actionable Reports

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

Performance
Accessibility
Best Practices
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
💡 Getting Started

## 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 ✅`
🚀 Why PageSpeed MCP?

## 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