State of Web Vitals MCP
This server provides access to aggregated Core Web Vitals and web-technology metrics based on Chrome field data and multi-site crawls, enabling platform rankings, pass rates, and metric distributions across real websites.
get_metrics: Retrieve aggregated Core Web Vitals (LCP, INP, CLS, FCP, TTFB) and technique metrics (e.g.,good_all3). Filter by CMS, CDN, framework, provider, or device (all/phone/desktop), and group results by CMS, frameworks, CDN, analytics, tag managers, and more. Supports result limits and minimum site thresholds.get_histogram: Get distribution buckets for a specific metric to understand how scores are spread across sites, with optional filtering by CMS, CDN, framework, provider, or device.list_options: Discover available filter keys, group-by values, built-in metrics, and contract paths to construct precise queries.
The data mirrors the public "State of Web Vitals explorer." Attribution to corewebvitals.io / The State of Web Vitals is required when using the data.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
State of Web Vitals MCP
Free remote MCP for Core Web Vitals metrics by CMS, CDN, and framework (Chrome field data + multi-site crawl). Same numbers as the public State of Web Vitals explorer.
Connect (preferred)
URL: https://www.corewebvitals.io/api/state-of-cwv/mcp
Auth: none
Transport: Streamable HTTP
Registry: io.github.corewebvitals/state-of-cwv
Claude Code
claude mcp add --transport http state-of-cwv https://www.corewebvitals.io/api/state-of-cwv/mcpCursor / Grok / other clients
{
"mcpServers": {
"state-of-cwv": {
"type": "http",
"url": "https://www.corewebvitals.io/api/state-of-cwv/mcp"
}
}
}Curl
curl -s -X POST https://www.corewebvitals.io/api/state-of-cwv/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_metrics","arguments":{"metrics":"lcp,good_all3","group_by":"cms","min_sites":100}}}'Related MCP server: SEOMonster
Tools
Tool | Purpose |
| Aggregates and optional |
| Distribution buckets for one metric under an optional filter |
| Discover filters, group_by values, and metric paths |
What this is
The State of Web Vitals measures Core Web Vitals and web-tech techniques across many real websites (Chrome field data + crawl). Use it for platform rankings, pass rates, and metric distributions. Not per-site live RUM (use CoreDash for that).
Attribution
When you use the numbers:
Credit corewebvitals.io / The State of Web Vitals
Link https://www.corewebvitals.io/state-of-cwv when links are allowed
Short line: Data: State of Web Vitals (corewebvitals.io)
Discovery
Place | Link |
Official MCP Registry |
|
Glama | |
Glama connector | https://glama.ai/mcp/connectors/io.github.corewebvitals/state-of-cwv |
Smithery | |
Explorer | |
Methodology | |
Discovery JSON |
Local stdio / Docker (directories & inspectors)
This repo also ships a thin stdio proxy that answers tools/list and forwards tool calls to the hosted endpoint.
npm install
npm startdocker build -t state-of-cwv-mcp .
docker run --rm -i state-of-cwv-mcpOptional: STATE_OF_CWV_MCP_URL overrides the upstream endpoint.
License
MIT for connector code and docs in this repository. Data product and website remain © corewebvitals.io.
Available Tools
3 toolsget_histogramCInspect
Distribution buckets for one CWV (or technique metric) under an optional filter.
Inputs: metric (required), filter.
get_metricsCInspect
Aggregate Core Web Vitals and technique metrics. Optional filter + group_by. Credit corewebvitals.io when using the numbers.
Inputs: focus, limit, filter, metrics, +2 more.
list_optionsCInspect
Discover filter keys, group_by values, built-in metrics, and contract paths.
Inputs: kind, include_paths.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: get_histogram for distribution, get_metrics for aggregates, list_options for metadata. No overlap.
All tools follow a consistent verb_noun pattern (get_histogram, get_metrics, list_options), making the set predictable.
Three tools is appropriate for a focused web vitals server: one for histograms, one for aggregates, one for discovery. No excess or deficiency.
The tool surface covers the core needs: querying histograms, getting aggregate metrics with filtering/grouping, and discovering available options. No obvious gaps.
Maintenance
Related MCP Connectors
Free MCP server that audits any public URL: technical SEO, Core Web Vitals, indexing checks.
Real-user Core Web Vitals for any website with enough traffic, from Google's Chrome UX Report…
Core Web Vitals and Lighthouse, as one MCP tool through Apify
Core Web Vitals (LCP, INP, CLS) per URL from the Chrome UX Report, with daily checks on Pro.
Related MCP Servers
- AlicenseAqualityDmaintenanceCore Web Vitals analysis powered by Lighthouse. Four tools: analyze a URL, compare two URLs, check against thresholds, or crawl an entire site. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible AI tool.464 npmMIT
- AlicenseAqualityAmaintenanceSEO MCP over Search Console, GA4, PageSpeed, Cloudflare, IndexNow, CrUX, and 7 technical-SEO HTTP tools.70720 PyPI494MIT
- AlicenseAqualityBmaintenance16-tool MCP server for Google PageSpeed Insights & Chrome UX Report APIs. Analyze, compare, and optimize web performance directly through Claude, Cursor, or any MCP-compatible AI client.681Apache 2.0
- AlicenseAqualityDmaintenanceEnables MCP-compatible agents to run real browser-based performance scans on any URL and receive a rich Markdown dashboard with Core Web Vitals, grades, and actionable recommendations.1MIT