WSG Check
Score a website against the W3C Web Sustainability Guidelines and look up each guideline
- 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-checkAdd to claude_desktop_config.json
{
"mcpServers": {
"wsg-check": {
"command": "npx",
"args": [
"-y",
"@sustainablewebsites/wsg-check"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"wsg-check": {
"command": "npx",
"args": [
"-y",
"@sustainablewebsites/wsg-check"
]
}
}
}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 defaultWSG_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.


