Skip to content
MCP server

WSG Check

Score a website against the W3C Web Sustainability Guidelines and look up each guideline

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.8.1
Listing updated
today

Similar MCP servers

About WSG Check

WSG Check is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Checks are heuristics run on fetched HTML and HTTP metadata, not a full browser render. The README is explicit about limits: JavaScript is not executed, Core Web Vitals are not measured and referenced assets are not downloaded. Carbon estimates use HTML transfer size with the SWD v4 model, and a failed green-hosting lookup falls back to false.

The result is a weighted score with recommendations across the web development, UX and hosting categories; the business category has no automated checks yet. Security headers, form validation and image alt text appear as related checks outside the score. Source on the main branch tracks the 24 September 2026 draft of the guidelines, so scores from different spec versions should not be compared.

The MCP server runs locally over stdio with no account or hosted service, and can check a deployed site or a local dev server. Environment variables can block loopback URLs or allow private network addresses. The same package ships a command line tool with JSON, Markdown and HTML reports and a fail threshold for CI pipelines.

Install

Run in a terminal

claude mcp add wsg-check -- npx -y @sustainablewebsites/wsg-check

Add to claude_desktop_config.json

{
  "mcpServers": {
    "wsg-check": {
      "command": "npx",
      "args": [
        "-y",
        "@sustainablewebsites/wsg-check"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wsg-check": {
      "command": "npx",
      "args": [
        "-y",
        "@sustainablewebsites/wsg-check"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "wsg-check": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sustainablewebsites/wsg-check"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wsg-check": {
      "command": "npx",
      "args": [
        "-y",
        "@sustainablewebsites/wsg-check"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "wsg-check": {
      "command": "npx",
      "args": [
        "-y",
        "@sustainablewebsites/wsg-check"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • WSG_CHECK_NO_LOCALSet to 1 to block localhost and other loopback URLs, which are allowed by default
  • WSG_CHECK_ALLOW_PRIVATESet to 1 to allow private network URLs (10/8, 172.16/12, 192.168/16)

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

check_url
Checks a URL against the Web Sustainability Guidelines
list_guidelines
Lists the guidelines
get_guideline
Returns one guideline

What it does

Weighted score
Rates a page against the guidelines and lists recommendations.
Guideline lookup
Lets an assistant list guidelines and fetch the detail of one.
Several report formats
Terminal, JSON, Markdown and HTML output through the CLI.
CI threshold
Exits with code 1 when the score falls below a chosen value.
Local site checks
Can check localhost, with options to block loopback or allow private networks.
Carbon estimate
Estimates CO2 from HTML transfer size using the SWD v4 model.

Good for

  • Audit a site's sustainability before launch
  • Have an assistant fix issues found on a local dev server
  • Fail a CI build when the sustainability score drops
  • Look up what a specific WSG guideline requires

Pricing

Open source

WSG Check FAQ

Does it render JavaScript?

No. It analyses fetched HTML and HTTP metadata only.

Can it check localhost?

Yes, loopback URLs are allowed by default and can be blocked with WSG_CHECK_NO_LOCAL=1.

What runtime is needed?

Node.js 22 or later.

Does it need an account?

No. The MCP server runs on your machine over stdio with no account, port or hosted service.

Is WSG Check free?

Yes. WSG Check is open source, so you can use and self-host it for free.

How do I add WSG Check to Claude Code?

Run this command in your terminal: claude mcp add wsg-check -- npx -y @sustainablewebsites/wsg-check

What are the best alternatives to WSG Check?

The closest alternatives to WSG Check are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers