@just-every/mcp-screenshot-website-fast

Fast, efficient screenshot capture of web pages - optimized for CLI coding tools. Automatically tiles full pages into 1072x1072 chunks for optimal processing.

Overview

Built specifically for AI vision workflows, this tool captures high-quality screenshots with automatic resolution limiting and tiling for optimal processing by Claude Vision API and other AI models. It ensures screenshots are perfectly sized at 1072x1072 pixels (1.15 megapixels) for maximum compatibility.

Features

• 📸 Fast screenshot capture using Puppeteer headless browser
• 🎯 Claude Vision optimized with automatic resolution limiting (1072x1072 for optimal 1.15 megapixels)
• 🔲 Automatic tiling - Full pages are automatically split into 1072x1072 tiles
• 🎬 Screencast capture - Record series of screenshots over time with configurable intervals
• 🔄 Always fresh content - No caching ensures up-to-date screenshots
• 📱 Configurable viewports for responsive testing
• ⏱️ Wait strategies for dynamic content (networkidle, custom delays)
• 📄 Full page capture by default for complete page screenshots
• 🎥 Animated WebP export - Save screencasts as high-quality animated WebP files
• 💉 JavaScript injection - Execute custom JS before screencast capture
• 📦 Minimal dependencies for fast npm installs
• 🔌 MCP integration for seamless AI workflows
• 🪟 Windows-compatible launcher for npm-installed MCP usage
• 🔋 Resource efficient - Automatic browser cleanup after 60 seconds of inactivity
• 🧹 Memory management - Pages are closed after each screenshot to prevent leaks

Installation

Claude Code

claude mcp add screenshot-website-fast -s user -- npx -y @just-every/mcp-screenshot-website-fast

VS Code

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

Cursor

cursor://anysphere.cursor-deeplink/mcp/install?name=screenshot-website-fast&config=eyJzY3JlZW5zaG90LXdlYnNpdGUtZmFzdCI6eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqdXN0LWV2ZXJ5L21jcC1zY3JlZW5zaG90LXdlYnNpdGUtZmFzdCJdfX0=

JetBrains IDEs

Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add

Choose "As JSON" and paste:

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

Raw JSON (works in any MCP client)

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

Drop this into your client's mcp.json (e.g. .vscode/mcp.json, ~/.cursor/mcp.json, or .mcp.json for Claude).

Prerequisites

• Node.js 20.x or higher
• npm or npx
• Chrome/Chromium (automatically downloaded by Puppeteer)

Quick Start

MCP Server Usage

Once installed in your IDE, the following tools are available:

Available Tools

• take_screenshot - Captures a high-quality screenshot of a webpage
  • Parameters:
    • url (required): The HTTP/HTTPS URL to capture
    • width (optional): Viewport width in pixels (max 1072, default: 1072)
    • height (optional): Viewport height in pixels (max 1072, default: 1072)
    • fullPage (optional): Capture full page screenshot with tiling (default: true)
    • waitUntil (optional): Wait until event: load, domcontentloaded, netw

... View full README on GitHub