State of Web Vitals MCP

MCP serverMonitoring & ops

This integration gives your AI access to Core Web Vitals metrics, broken down by CMS, CDN, and framework. Once added, your AI can pull up the numbers and compare how different website tools perform. It is free to use and requires no account or sign-in.

Use State of Web Vitals MCP in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add State of Web Vitals MCP and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use State of Web Vitals MCP to get metrics

Details

Available today. Use it from your connected AI after setup.

After adding it, ask your AI for Core Web Vitals numbers for any CMS, CDN, or framework you use or are considering. It can then compare the options for you.

State of Web Vitals MCPStart free

What your AI can do with it

  • Look up Core Web Vitals metrics for a specific CMS, CDN, or framework
  • Compare performance across different CMSs
  • Compare performance across CDNs and frameworks
  • Answer web performance questions using current metrics data
  • Check metrics without needing an account or sign-in

Install State of Web Vitals MCP

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user state-of-web-vitals-mcp 'https://www.corewebvitals.io/api/state-of-cwv/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://www.corewebvitals.io/api/state-of-cwv/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=state-of-web-vitals-mcp&config=eyJ1cmwiOiJodHRwczovL3d3dy5jb3Jld2Vidml0YWxzLmlvL2FwaS9zdGF0ZS1vZi1jd3YvbWNwIn0=

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://www.corewebvitals.io/api/state-of-cwv/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add state-of-web-vitals-mcp --url 'https://www.corewebvitals.io/api/state-of-cwv/mcp'

    Run it once, then sign in with codex mcp login state-of-web-vitals-mcp if the server asks for an account.

From the project's README

As published by corewebvitals/state-of-cwv-mcp in README.md.

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}}}'

Tools

ToolPurpose
get_metricsAggregates and optional group_by rankings (CMS, CDN, frameworks, …)
get_histogramDistribution buckets for one metric under an optional filter
list_optionsDiscover 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

PlaceLink
Official MCP Registryio.github.corewebvitals/state-of-cwv
Glamahttps://glama.ai/mcp/servers/corewebvitals/state-of-cwv-mcp
Glama connectorhttps://glama.ai/mcp/connectors/io.github.corewebvitals/state-of-cwv
Smitheryhttps://smithery.ai/servers/corewebvitals/state-of-cwv
Explorerhttps://www.corewebvitals.io/state-of-cwv/explorer
Methodologyhttps://www.corewebvitals.io/state-of-cwv/methodology
Discovery JSONhttps://www.corewebvitals.io/.well-known/mcp.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 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.

Tools it offers (3)

What this server listed when Ahel dialed its public endpoint in Sep 2026, with no key and no account of yours. The names are the server’s own.

  • get_metrics
  • get_histogram
  • list_options

Signals

Last commit
Jul 2026
Advanced
Delivery
state-of-cwv MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-corewebvitals-state-of-cwv
Source
github.com/corewebvitals/state-of-cwv-mcp
Hosted endpoint
https://www.corewebvitals.io/api/state-of-cwv/mcp