The same image audit that powers the web scanner is available wherever you work — in your AI coding agent, your terminal, your CI pipeline, and your browser. Each one checks a page for oversized images (files downloaded much larger than they render) and reports natural vs. rendered dimensions and format breakdown. All free and open source.
Let Claude, Cursor, Windsurf, or any MCP client audit a page's images during development. Exposes a scan_image_dimensions(url) tool. The scan runs server-side, so no local browser is required.
{
"mcpServers": {
"imagedimensions": {
"command": "npx",
"args": ["-y", "imagedimensions-mcp"]
}
}
}npm·GitHub·Listed in the official MCP registry as io.github.Bishop81/imagedimensions-mcp
Audit any URL from the terminal or a script. Add --json for machine output, or --max-oversized to return a non-zero exit code.
npx imagedimensions-cli https://example.com
Fail a pull request the moment a preview deploy ships an oversized image. Set max-oversized to your budget. The full setup, including how to pick that budget, is in catching oversized images in CI.
- uses: Bishop81/imagedimensions-cli@v0.1.0
with:
url: https://staging.example.com
max-oversized: '0'Our scanner loads your page in a headless browser, so it cannot see anything behind a login, behind bot protection, or running on localhost. The extension measures the page you are already looking at. Click a result and it scrolls to that image and highlights it.
Because it runs in your real browser it knows your device pixel ratio, so a correctly served retina image reads as 1× rather than 4× — more accurate, per page, than anything measuring in CSS pixels alone.
Chrome Web Store · Source · No network requests, no storage, two permissions.
The interactive scanner gives you the full visual report — thumbnails, sortable table, and per-image overshoot — without installing anything. For the concepts behind all of this, see right-sizing web images and our research on how common oversized images are.