MCP Screenshot Website Fast

What just-every/mcp-screenshot-website-fast does

just-every/mcp-screenshot-website-fast is designed for the Browser Automation category and gives MCP clients a way to inspect HTTP and HTTPS webpages visually. It uses a headless Chrome or Chromium browser controlled through Puppeteer, opens the requested URL, waits for the selected page condition, and captures the result.

Full-page captures are enabled by default. When a page exceeds the target image size, the result is divided into 1072×1072 PNG tiles. The default viewport dimensions are also 1072×1072 pixels, with smaller values available for responsive checks. Screenshots can be returned as base64 images or written to a specified directory, where the server returns file paths.

How it works

The take_screenshot tool accepts a URL and optional viewport, full-page, wait-event, delay, and output-directory settings. Supported wait events are load, domcontentloaded, networkidle0, and networkidle2. An additional delay can be used when page content appears after the selected browser event.

capture_selector narrows the image to a DOM element identified by a CSS selector. It includes separate timing controls for waiting for the selector and for adding a post-load delay, which is useful when a full-page image would contain unnecessary content.

take_screencast captures repeated images for a chosen duration and interval. It records the top 1072×1072 tile of the viewport rather than a complete long page. JavaScript can run at the beginning of a capture. Results may be returned as individual PNG frames, or saved as an animated WebP with PNG frames when an output directory is provided.

Setup and configuration

Using just-every/mcp-screenshot-website-fast requires Node.js 20 or newer and npm or npx. Puppeteer downloads Chrome or Chromium automatically. The package can be added to Claude Code, VS Code, Cursor, or JetBrains AI Assistant using their MCP configuration flows. A raw stdio JSON configuration is also provided for MCP clients that accept a command and argument list:

{
  "mcpServers": {
    "screenshot-website-fast": {
      "command": "npx",
      "args": ["-y", "@just-every/mcp-screenshot-website-fast"]
    }
  }
}

No environment variables are documented as required. For local development, the repository supports npm installation, a build step, tests, type checking, and a development CLI for direct captures.

Tools and capabilities

• Capture full pages or viewport-only screenshots.
• Split long pages into 1072×1072 tiles.
• Capture a selected DOM element by CSS selector.
• Produce timed PNG-frame screencasts or animated WebP output.
• Execute JavaScript before a screencast begins.
• Collect browser console messages for a URL, with an optional JavaScript command and wait duration.
• Choose viewport dimensions and page wait strategies.
• Close pages after captures and clean up the browser after inactivity.
• Restart automatically after crashes, with bounded retry backoff.

Limitations and notes

just-every/mcp-screenshot-website-fast limits viewport dimensions to a maximum of 1072 pixels. Screencasts capture only the viewport’s top tile, so they are not a recording of every tile in a long page. Directory output changes the response from image data to file paths for screenshots; tiled captures produce one file per tile.