How do I install Imagedimensions?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Imagedimensions need an API key?

The publisher lists these environment variables: IMAGEDIMENSIONS_API_BASE.

What transport does Imagedimensions use?

Imagedimensions runs locally over stdio.

Imagedimensions

Q: When was Imagedimensions last checked?

Last checked 2026-10-16. Audit a web page's images: natural vs rendered sizes, oversized detection, and formats.

by io.github.Bishop81

Audit a web page's images: natural vs rendered sizes, oversized detection, and formats.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command

npx -y [email protected]

Credentials from the publisher

IMAGEDIMENSIONS_API_BASE — Override the scan API base. Defaults to https://imagedimensions.com.

Provider

Claude Code

IMAGEDIMENSIONS_API_BASE=<value> claude mcp add io.github.bishop81-imagedimensions-mcp -- npx -y [email protected]

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.bishop81-imagedimensions-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "IMAGEDIMENSIONS_API_BASE": "<value>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

imagedimensions-mcp

An MCP server that audits the images on any public web page — natural vs. rendered dimensions, oversized-image detection, and format breakdown — so AI agents (Claude, Cursor, Windsurf, etc.) can check image performance during development.

Install / run

// Claude Desktop / any MCP client config
{
  "mcpServers": {
    "imagedimensions": {
      "command": "npx",
      "args": ["-y", "imagedimensions-mcp"]
    }
  }
}

Tool

`scan_image_dimensions`

Param	Type	Description
`url`	string (required)	Public URL of the page to audit.
`oversizedThreshold`	number (optional)	Area-overshoot ratio to flag as oversized. Default `4` (≈2× per dimension).

Returns a text report plus structured content:

total / visible image counts and CSS-background count
modern-format share (WebP + AVIF)
format breakdown
the list of oversized images (natural → rendered, overshoot ratio, format, src)
a link to the full visual report on imagedimensions.com

Example agent uses: "Audit the images on https://example.com," "Which images on this page are oversized and hurting LCP?", "What % of this site's images use modern formats?"

Why "oversized" matters

An image downloaded much larger than the box it renders into wastes bandwidth and slows Largest Contentful Paint — the most common image-performance mistake on the web. See the writeup.

Config

IMAGEDIMENSIONS_API_BASE — override the API base (default https://imagedimensions.com).

License

MIT