The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Coredash listing page.
Real User Monitoring for Core Web Vitals. Query LCP, INP, and CLS field data from real visitors through the Model Context Protocol.
The MCP server is hosted at https://app.coredash.app/api/mcp. This repo holds the public connector docs and registry manifest. You do not need to install or run a server. You connect your MCP client directly to the hosted endpoint.
CoreDash is a Real User Monitoring platform built around Core Web Vitals. It collects LCP, INP, and CLS from real visitors and lets you segment by page template, country, device, browser, OS, and 20 plus other dimensions. Data is stored in the EU. The product runs without consent banners. Paid plans start at $19 per month. More at coredash.app.
| Tool | Purpose |
|---|---|
get_metrics | Current performance scores at p75. Filter and group by any dimension. Use for "what is" questions. |
get_timeseries | Metric over time with an improving, stable, or regressing summary. Use for regressions and trends. |
get_histogram | Distribution shape of a single metric across roughly 40 buckets. Use to see whether traffic is bimodal, long tailed, or evenly slow. |
All three tools return rated buckets (good, improve, poor) matching the Core Web Vitals thresholds. Filter dimensions include device (d), country (cc), page path (ff), URL (u), browser, OS, and the LCP / INP / CLS attribution element selectors.
The server supports two methods:
WWW-Authenticate discovery flow and publishes /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource.Authorization: Bearer cdk_YOUR_API_KEY.Anonymous calls succeed for initialize (so clients can introspect server capabilities) and fail for any tool call.
Add the server, then authenticate in the browser:
Run /mcp inside Claude Code, select coredash, and complete the OAuth sign-in.
To use an API key instead (e.g. in CI), pass it as a header:
Add to ~/.cursor/mcp.json, then click Login on the server in Cursor's MCP settings to complete OAuth:
To use an API key instead, add a "headers" block with "Authorization": "Bearer cdk_YOUR_API_KEY".
Add to .vscode/mcp.json in your workspace (or the user config via the MCP: Open User Configuration command). VS Code prompts you to sign in on first use:
To use an API key instead, add a "headers" block with "Authorization": "Bearer cdk_YOUR_API_KEY".
Same JSON shape as Cursor, in the Windsurf MCP settings.
Point it at https://app.coredash.app/api/mcp with the streamable-http transport. Clients that support OAuth discover the flow via the WWW-Authenticate header; otherwise pass an Authorization: Bearer cdk_YOUR_API_KEY header.
This server is published on the Official MCP Registry as io.github.corewebvitals/coredash. From there it propagates to PulseMCP, Smithery, Glama, and Windsurf.
The registry manifest is in server.json. To publish a new version, edit the file and run mcp-publisher publish.
cwv-superpowers. Skills package for Claude Code, Cursor, and Gemini that drives this MCP server to diagnose and fix Core Web Vitals issues.MIT. See LICENSE.