screenshotrun-mcp

Give your AI agent the ability to see any webpage. MCP server for ScreenshotRun Screenshot API.

Features

• Capture screenshots of any public webpage as PNG, JPEG, WebP, or PDF
• Device emulation — desktop, mobile, and tablet viewports
• Dark mode rendering with prefers-color-scheme: dark
• Full-page capture with automatic scrolling
• Block ads and cookie consent banners
• Inject custom CSS/JavaScript before capture
• Target specific elements with CSS selectors
• Retina (2x) resolution support
• Monitor your API usage and remaining quota

Quick Start

1. Get your API key

Sign up for a free API key at screenshotrun.com.

2. Configure your AI client

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "screenshotrun": {
      "command": "npx",
      "args": ["-y", "screenshotrun-mcp"],
      "env": {
        "SCREENSHOTRUN_API_KEY": "sr_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add screenshotrun \
  npx -y screenshotrun-mcp \
  -e SCREENSHOTRUN_API_KEY=sr_live_your_key_here

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "screenshotrun": {
      "command": "npx",
      "args": ["-y", "screenshotrun-mcp"],
      "env": {
        "SCREENSHOTRUN_API_KEY": "sr_live_your_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration with the same npx -y screenshotrun-mcp command and set the SCREENSHOTRUN_API_KEY environment variable.

Available Tools

take_screenshot

Capture a screenshot of any webpage. Returns the image as base64-encoded data that AI agents can analyze and describe.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | url | string | required | URL to screenshot (must include http:// or https://) | | format | png | jpeg | webp | pdf | png | Output image format | | width | number | 1280 | Viewport width in pixels (320–3840) | | height | number | 800 | Viewport height in pixels (200–2160) | | full_page | boolean | false | Capture the entire scrollable page | | quality | number | 80 | Image quality for JPEG/WebP (1–100) | | device | desktop | mobile | tablet | — | Device preset (overrides width/height with device defaults) | | dark_mode | boolean | false | Enable dark mode rendering | | block_ads | boolean | false | Block advertisements during capture | | block_cookies | boolean | true | Block cookie consent dialogs | | delay | number | 0 | Delay in seconds after page load before capturing (0–10) | | retina | boolean | false | Capture at 2x resolution | | css | string | — | Custom CSS to inject into the page (max 10KB) | | js | string | — | Custom JavaScript to execute before capture (max 10KB) | | selector | string | — | CSS selector to capture a specific element | | hide_selectors | string[] | — | CSS selectors of elements to hide before capture | | click_selector | string | — | CSS selector of element to click before capture | | scroll_to | string | — | CSS selector of element to scroll into view |

check_usage

Check your ScreenshotRun API usage for the current billing period. Returns screenshots used, remaining quota, usage percentage, and days remaining.

No parameters required.

Example Prompts

• "Take a screenshot of screenshotrun.com"
• "Screenshot snapshotarchive.com in dark mode on mobile"
• "Capture full-page screenshot of my website and describe what you see"
• "Take a retina screenshot of screenshotrun.com in JPEG format"
• "Screenshot snapshotarchive.com on tablet with ad blocking"
• "Take a screenshot of my site with the cookie banner hidden using hide_selectors"
• "Check my ScreenshotRun API usage"

How It Works

1. Your AI agent receives a user request involving a webpage screenshot
2. The agent calls the take_screenshot tool with the URL and options
3. The MCP server sends the request to the ScreenshotRun API
4. The API renders the page in a real browser and returns the screenshot
5. The image is returned to the AI agent as base64, which it can analyze and describe

Requirements

• Node.js 18+
• A ScreenshotRun API key (get one free)

Other Projects by ScreenshotRun

• SnapshotArchive — Automated website monitoring with visual diff detection
• WatchCron — Cron job & heartbeat monitoring for developers

License

MIT