Integrations & Developer Tools

The same image audit that powers the web scanner is available wherever you work — in your AI coding agent, your terminal, and your CI pipeline. Each one checks any URL for oversized images (files downloaded much larger than they render) and reports natural vs. rendered dimensions and format breakdown. All free and open source.

MCP Server

for AI agents

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

Command-Line Tool

for your terminal

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

npm·GitHub

GitHub Action

for CI

Fail a pull request the moment a preview deploy ships an oversized image. Set max-oversized to your budget.

- uses: Bishop81/[email protected]
  with:
    url: https://staging.example.com
    max-oversized: '0'

Repository & docs

Prefer the browser?

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.