# WSG Check

> WSG Check is an open-source MCP server for developer tools. Score a website against the W3C Web Sustainability Guidelines and look up each guideline. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Repository:** https://github.com/ivanoats/wsg-check
- **MCP Registry name:** io.github.ivanoats/wsg-check
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/wsg-check
