# PageSpeed Insights MCP

> PageSpeed Insights MCP is an open-source MCP server for developer tools. Measure PageSpeed Insights as the median of five distinct runs, with the spread. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://considus.com/pagespeed-insights-mcp/
- **Repository:** https://github.com/considus/pagespeed-insights-mcp
- **MCP Registry name:** com.considus/pagespeed-insights-mcp
- **Categories:** developer tools, marketing and SEO
- **Listing updated:** 2026-11-14

## About

The idea here is that a single Lighthouse run is noise, so this server keeps asking Google until it has five genuinely different analyses and reports the median with the min-max spread beside each figure. The README explains that PageSpeed caches results per URL, so repeated calls can return the same stale analysis; the server drops cached replays and says how many it dropped.

It also shows Chrome UX Report data, with up to six months of weekly history, separately from the lab score and never blended. When a small site has no real-user data, it says so. The README illustrates the gap with a lab LCP of 21.36 s against 1.20 s for real users on one large news site. A terminal mode exits with a code that separates a broken site from quota exhaustion.

It uses only the Python standard library, is Apache 2.0, and runs on macOS, Linux or Windows.

## Features

- **Median of five:** Reports the median of distinct analyses with spread.
- **Cache-replay filter:** Drops repeated cached results and counts them.
- **Lab and field data:** Shows Lighthouse and Chrome UX Report separately.
- **Terminal use:** Exit codes separate failures for build pipelines.
- **No dependencies:** Standard library only; no pip or venv.

## Good for

- Check whether a speed score really changed after a deploy
- Report real-user Core Web Vitals when available
- Gate a CI build on page speed with meaningful exit codes

## Install

### Claude Code (Terminal)

```sh
claude mcp add pagespeed-insights-mcp -- npx -y https://github.com/Considus/pagespeed-insights-mcp/releases/download/v2.0.1/pagespeed-insights-mcp-2.0.1.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pagespeed-insights-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Considus/pagespeed-insights-mcp/releases/download/v2.0.1/pagespeed-insights-mcp-2.0.1.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pagespeed-insights-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Considus/pagespeed-insights-mcp/releases/download/v2.0.1/pagespeed-insights-mcp-2.0.1.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pagespeed-insights-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Considus/pagespeed-insights-mcp/releases/download/v2.0.1/pagespeed-insights-mcp-2.0.1.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pagespeed-insights-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Considus/pagespeed-insights-mcp/releases/download/v2.0.1/pagespeed-insights-mcp-2.0.1.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pagespeed-insights-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Considus/pagespeed-insights-mcp/releases/download/v2.0.1/pagespeed-insights-mcp-2.0.1.mcpb"
      ]
    }
  }
}
```

## FAQ

### Why five runs?

One run is noisy, so the median and spread show whether a change is real.

### Does it need a virtual environment?

No. It uses only the standard library.

### What licence is it under?

Apache 2.0.

### Is PageSpeed Insights MCP free?

Yes. PageSpeed Insights MCP is open source, so you can use and self-host it for free.

### How do I add PageSpeed Insights MCP to Claude Code?

Run this command in your terminal: claude mcp add pagespeed-insights-mcp -- npx -y https://github.com/Considus/pagespeed-insights-mcp/releases/download/v2.0.1/pagespeed-insights-mcp-2.0.1.mcpb

### What are the best alternatives to PageSpeed Insights MCP?

The closest alternatives to PageSpeed Insights MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/pagespeed-insights-mcp
