Skip to main content
Glama
State of Web Vitals MCP

State of Web Vitals MCP

State of Web Vitals MCP

corewebvitals/state-of-cwv-mcp MCP server

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/mcp

Cursor / 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

get_metrics

Aggregates and optional group_by rankings (CMS, CDN, frameworks, …)

get_histogram

Distribution buckets for one metric under an optional filter

list_options

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:

  1. Credit corewebvitals.io / The State of Web Vitals

  2. Link https://www.corewebvitals.io/state-of-cwv when links are allowed

Short line: Data: State of Web Vitals (corewebvitals.io)

Discovery

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 start
docker build -t state-of-cwv-mcp .
docker run --rm -i state-of-cwv-mcp

Optional: 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 tools
get_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

    B3.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: get_histogram for distribution, get_metrics for aggregates, list_options for metadata. No overlap.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (get_histogram, get_metrics, list_options), making the set predictable.

    Tool Count5/5

    Three tools is appropriate for a focused web vitals server: one for histograms, one for aggregates, one for discovery. No excess or deficiency.

    Completeness5/5

    The tool surface covers the core needs: querying histograms, getting aggregate metrics with filtering/grouping, and discovering available options. No obvious gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers