CoreDash MCP Server
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.
What CoreDash is
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.
Tools exposed via MCP
| 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.
Authentication
The server supports two methods:
- OAuth (recommended). Point your MCP client at the server URL and complete the browser sign-in when prompted — no API key required. The server follows the
WWW-Authenticatediscovery flow and publishes/.well-known/oauth-authorization-serverand/.well-known/oauth-protected-resource. - API key. Best for CI or headless use. Generate one at coredash.app/settings/api and pass it as
Authorization: Bearer cdk_YOUR_API_KEY.
Anonymous calls succeed for initialize (so clients can introspect server capabilities) and fail for any tool call.
Connecting
Claude Code
Add the server, then authenticate in the browser:
claude mcp add --transport http coredash https://app.coredash.app/api/mcp
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:
claude mcp add --transport http coredash https://app.coredash.app/api/mcp \
--header "Authorization: Bearer cdk_YOUR_API_KEY"
Cursor
Add to ~/.cursor/mcp.json, then click Login on the server in Cursor's MCP settings to complete OAuth:
{
"mcpServers": {
"coredash": {
"url": "https://app.coredash.app/api/mcp"
}
}
}
To use an API key instead, add a "headers" block with "Authorization": "Bearer cdk_YOUR_API_KEY".
VS Code
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:
{
"servers": {
"coredash": {
"type": "http",
"url": "https://app.coredash.app/api/mcp"
}
}
}
To use an API key instead, add a "headers" block with "Authorization": "Bearer cdk_YOUR_API_KEY".
Windsurf
Same JSON shape as Cursor, in the Windsurf MCP settings.
Any other MCP client
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.
Example queries
Why is LCP slow on mobile in Germany this week?
Has INP regressed on the product detail template in the last 24 hours?
Show me the LCP distribution on /checkout/* in the US.
Registry listing
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.
Related projects
cwv-superpowers. Skills package for Claude Code, Cursor, and Gemini that drives this MCP server to diagnose and fix Core Web Vitals issues.- Core Web Vitals Visualizer. Chrome extension. Lets you see CWV metrics overlayed on any page.
License
MIT. See LICENSE.