Google CrUX MCP Server

by a1-x-techio.github.A1-x-Tech/mcp-google-cruxv1.1.0

Real-user Core Web Vitals from the Chrome UX Report (CrUX) API for any origin or URL.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active6d ago

Install Google CrUX MCP server

claude mcp add google-crux -e CRUX_API_KEY='<crux-api-key>' -- npx -y mcp-google-crux

{
  "mcpServers": {
    "google-crux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-crux"
      ],
      "env": {
        "CRUX_API_KEY": "<crux-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "google-crux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-crux"
      ],
      "env": {
        "CRUX_API_KEY": "<crux-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "google-crux": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-crux"
      ],
      "env": {
        "CRUX_API_KEY": "<crux-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "google-crux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-crux"
      ],
      "env": {
        "CRUX_API_KEY": "<crux-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CRUX_API_KEY	yes	yes	Google Cloud API key with the Chrome UX Report API enabled (sent as the key= query parameter). Treat it as a secret.
CRUX_API_BASE	—	—	API root host override.
CRUX_TIMEOUT_MS	—	—	Per-request timeout in milliseconds.
CRUX_MAX_RETRIES	—	—	Retries on transient errors (429, 5xx, network).

Freshness

Active — last maintenance signal 6d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-04 · 6d ago · GitHub
Latest release
2026-08-18 · 52d ago · GitHub · v1.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-18 · 52d ago · official registry · v1.1.0

FAQ

›How do I install the Google CrUX MCP server in Claude Code?

Run: claude mcp add google-crux -e CRUX_API_KEY='<crux-api-key>' -- npx -y mcp-google-crux. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Google CrUX require an API key?

Yes. It expects CRUX_API_KEY, of which 1 is a secret.

›Can I use Google CrUX as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Google CrUX in the official MCP registry?

Yes, as io.github.A1-x-Tech/mcp-google-crux.