The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Screenshot Scout listing page.
Use Screenshot Scout from an MCP client to capture HTTP or HTTPS webpages as images or PDFs.
This server exposes one tool, capture_screenshot. It supports full-page and
element captures, device and viewport controls, location selection, page
interaction and blocking options, image sizing and quality, PDF layout, caching,
temporary result URLs and eligible MCP image content.
Every capture uses your Screenshot Scout account and is subject to its plan, quota, and rate limits.
Start with this local stdio configuration:
If the access key requires request signing, add the secret locally:
Keep personal configuration files out of source control. Credentials are process environment values, not tool arguments. See client-specific copy-paste configurations for Claude Desktop, Claude Code, Cursor, VS Code/GitHub Copilot, Devin, and Cline.
Point the client at the absolute path to dist/stdio.js with node, and provide
the same environment variables shown above.
To install the Claude Desktop extension:
screenshotscout-mcp-<version>.mcpb from that version's GitHub
release.Claude Desktop treats both fields as sensitive settings. The v0.1.0 MCPB
supports Windows.
The hosted API-key endpoint is live at:
It is intended only for clients that can attach a static HTTP header:
The endpoint accepts an access key only. Never send a Screenshot Scout secret key to it, and never put either key in the URL or a tool argument. Clients that cannot attach a static Bearer header cannot use this endpoint.
API keys that require request signatures must instead use local stdio or MCPB, or use a dedicated unsigned access key for the hosted endpoint.
Build the production image from a source checkout:
Pass credentials from the local environment and keep stdin attached for MCP stdio traffic:
SCREENSHOTSCOUT_SECRET_KEY remains optional. The image runs as an unprivileged
user and contains only the compiled stdio server and its production dependencies.
It declares no port or container health check: an MCP client owns the stdio
process and verifies readiness by completing MCP initialization. The image and
its Docker MCP Catalog metadata in docker-mcp-catalog.yaml are local
preparation; no public image is implied by these commands.
capture_screenshotcapture_screenshot sends one capture request for the supplied URL and options.
The target webpage is external, and its returned content must be treated as
untrusted.
Only url is required. Captures use a 1280×720 viewport by default. When no
format is specified, the tool returns JPEG at quality 60. resultMode defaults
to "auto".
| Group | Inputs |
|---|---|
| Target and output | url; format (png, jpg, jpeg, webp, gif, tiff, pdf); resultMode (auto, url_only) |
| Location and viewport | country (two-letter country code), device, deviceViewportWidth, deviceViewportHeight, colorScheme (auto, dark, light), fullPage |
| Page preparation | blockCookieBanners, blockAds, blockChatWidgets, selector, hideSelectors, clickSelectors |
| Timing | waitUntil (load, domcontentloaded, networkidle0, networkidle2), delay (0–30 seconds), navigationTimeout (5–90 seconds), timeout (1–240 seconds) |
| Cache | cache, cacheTtl (14,400–2,592,000 seconds) |
| Output resizing | imageWidth, imageHeight (1–8,192; available for images and PDFs) |
| Image only | imageQuality (0–100, JPEG/WebP only) |
| PDF only | pdfPaperFormat (letter, legal, tabloid, a4, a3, content), pdfLandscape, pdfPrintBackground, pdfMargin, per-side margin fields, pdfScale (greater than 0 and at most 3) |
When both output dimensions are provided, their product cannot exceed 64,000,000
pixels. PDF margins accept non-negative values in px, in, mm, or cm.
imageQuality requires JPEG or WebP output, and PDF-only options require
format: "pdf".
resultMode is auto, the MIME type is eligible, dimensions are known and at
most 8,000 pixels per side, raw data is at most 5 MiB, and the complete
serialized result fits the current 128,000-byte server limit.resultMode: "url_only" omits image bytes for every format.MCP clients control whether returned image content or resource links are displayed or made available to a model.
Structured metadata can include screenshotUrl, screenshotUrlExpiresAt,
cacheStatus, format, mimeType, imageWidth, imageHeight,
inlineImageIncluded, and inlineImageOmissionReason.
Treat result URLs as sensitive, temporary links and respect their reported expiry.
https://example.com as a full-page PNG in dark mode. Return only a
URL.”https://example.com/pricing, block cookie
banners and ads, and use quality 80.”https://example.com/report with backgrounds enabled and
10 mm margins.”The server sends the target URL and selected capture options to Screenshot Scout, which loads the target website. Review the Screenshot Scout privacy policy before capturing private or regulated material.
MIT © Oleksii Velykyi