Screenshot Scout — Claude Code MCP server: features and setup
Captures webpage screenshots and full-page PDF documents through Screenshot Scout. Useful for visual regression tests, layout inspection, and automated reporting.
claude mcp add --transport http mcp https://mcp.screenshotscout.com/mcp/api-keyWhat Screenshot Scout does
The server exposes the capture_screenshot tool. It takes any target webpage URL and renders an image or a PDF. Supported formats include PNG, WebP, and PDF. You can snap an entire page or focus on an element using a CSS selector. It handles mobile viewport simulation and country selection via two-letter codes. Before capturing, the tool can strip cookie notices and ads.
Local execution via npx or Docker requires Node.js 22 or newer. You can connect through stdio or point the client to https://mcp.screenshotscout.com/mcp/api-key. Each request consumes quota from your Screenshot Scout balance. If your API key requires signed requests, the hosted endpoint will fail. In that scenario, you must run the server locally with SCREENSHOTSCOUT_SECRET_KEY.
What it helps with
- Export a webpage into a PDF document with custom margins and paper size
- Capture a specific user interface element via CSS selector
- Test page layout across mobile screen dimensions
- Grab localized webpage views from specific countries while suppressing ads and cookie prompts
Example prompts for the agent
- Take a full-page screenshot of the target link and hide all cookie banners.
- Convert this webpage into an
a4PDF document using landscape orientation. - Capture the element matching
#hero-bannerusing mobile viewport dimensions.
How to install Screenshot Scout
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.screenshotscout.com/mcp/api-key2Platform CLI
claude mcp add --env SCREENSHOTSCOUT_ACCESS_KEY=<SCREENSHOTSCOUT_ACCESS_KEY> --env SCREENSHOTSCOUT_SECRET_KEY=<SCREENSHOTSCOUT_SECRET_KEY> --transport stdio screenshot-scout -- npx -y @screenshotscout/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add screenshot-scout --url https://mcp.screenshotscout.com/mcp/api-key2Platform CLI
codex mcp add screenshot-scout --env SCREENSHOTSCOUT_ACCESS_KEY=<SCREENSHOTSCOUT_ACCESS_KEY> --env SCREENSHOTSCOUT_SECRET_KEY=<SCREENSHOTSCOUT_SECRET_KEY> -- npx -y @screenshotscout/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"screenshot-scout": {
"url": "https://mcp.screenshotscout.com/mcp/api-key"
}
}
}{
"mcpServers": {
"screenshot-scout": {
"command": "npx",
"args": [
"-y",
"@screenshotscout/mcp"
],
"env": {
"SCREENSHOTSCOUT_ACCESS_KEY": "<SCREENSHOTSCOUT_ACCESS_KEY>",
"SCREENSHOTSCOUT_SECRET_KEY": "<SCREENSHOTSCOUT_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"screenshot-scout": {
"type": "http",
"url": "https://mcp.screenshotscout.com/mcp/api-key"
}
}
}{
"servers": {
"screenshot-scout": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@screenshotscout/mcp"
],
"env": {
"SCREENSHOTSCOUT_ACCESS_KEY": "<SCREENSHOTSCOUT_ACCESS_KEY>",
"SCREENSHOTSCOUT_SECRET_KEY": "<SCREENSHOTSCOUT_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http screenshot-scout https://mcp.screenshotscout.com/mcp/api-key2Platform CLI
gemini mcp add -e SCREENSHOTSCOUT_ACCESS_KEY=<SCREENSHOTSCOUT_ACCESS_KEY> -e SCREENSHOTSCOUT_SECRET_KEY=<SCREENSHOTSCOUT_SECRET_KEY> screenshot-scout npx -y @screenshotscout/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Screenshot Scout
How do I install Screenshot Scout in Claude Code?
Run `claude mcp add --env SCREENSHOTSCOUT_ACCESS_KEY=<SCREENSHOTSCOUT_ACCESS_KEY> --env SCREENSHOTSCOUT_SECRET_KEY=<SCREENSHOTSCOUT_SECRET_KEY> --transport stdio screenshot-scout -- npx -y @screenshotscout/mcp. Replace <SCREENSHOTSCOUT_ACCESS_KEY> and <SCREENSHOTSCOUT_SECRET_KEY>` with your credentials from Screenshot Scout.
What does the capture_screenshot tool do?
It sends a capture request to Screenshot Scout to generate a webpage screenshot or PDF. The tool supports custom viewports, mobile device emulation, country routing, and filtering out ads or cookie banners.
When is SCREENSHOTSCOUT_SECRET_KEY required?
The secret key is needed only if your chosen Screenshot Scout API key enforces signed requests. For unsigned API keys, you only need to supply the access key.
