# Screenshot Scout

Captures webpage screenshots and full-page PDF documents through Screenshot Scout. Useful for visual regression tests, layout inspection, and automated reporting.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: screenshotscout
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/screenshotscout/screenshotscout-mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/screenshot-scout

## What it 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`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.screenshotscout.com/mcp/api-key`
- Environment variables: `SCREENSHOTSCOUT_ACCESS_KEY`, `SCREENSHOTSCOUT_SECRET_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.screenshotscout.com/mcp/api-key
```

2. **Platform CLI**
```bash
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 <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add screenshot-scout --url https://mcp.screenshotscout.com/mcp/api-key
```

2. **Platform CLI**
```bash
codex mcp add screenshot-scout --env SCREENSHOTSCOUT_ACCESS_KEY=<SCREENSHOTSCOUT_ACCESS_KEY> --env SCREENSHOTSCOUT_SECRET_KEY=<SCREENSHOTSCOUT_SECRET_KEY> -- npx -y @screenshotscout/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "screenshot-scout": {
            "url": "https://mcp.screenshotscout.com/mcp/api-key"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "screenshot-scout": {
            "type": "http",
            "url": "https://mcp.screenshotscout.com/mcp/api-key"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http screenshot-scout https://mcp.screenshotscout.com/mcp/api-key
```

2. **Platform CLI**
```bash
gemini mcp add -e SCREENSHOTSCOUT_ACCESS_KEY=<SCREENSHOTSCOUT_ACCESS_KEY> -e SCREENSHOTSCOUT_SECRET_KEY=<SCREENSHOTSCOUT_SECRET_KEY> screenshot-scout npx -y @screenshotscout/mcp
```
Replace <…> with your own values

## When to use it
- 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
- Take a full-page screenshot of the target link and hide all cookie banners.
- Convert this webpage into an `a4` PDF document using landscape orientation.
- Capture the element matching `#hero-banner` using mobile viewport dimensions.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 13345

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md