English Français العربية

io.github.webmox/screenshotrun-mcp

Official registry Media and design

Capture website screenshots in AI agents. Full-page, dark mode, mobile, OG images, base64.

Source code Documentation

What can you do with io.github.webmox/screenshotrun-mcp?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package screenshotrun-mcp
Claude Code 
claude mcp add screenshotrun-mcp -e 'SCREENSHOTRUN_API_KEY=<SCREENSHOTRUN_API_KEY>' -- npx -y screenshotrun-mcp@1.0.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "screenshotrun-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "screenshotrun-mcp@1.0.3"
            ],
            "env": {
                "SCREENSHOTRUN_API_KEY": "<SCREENSHOTRUN_API_KEY>"
            }
        }
    }
}

Environment variables

  • SCREENSHOTRUN_API_KEY required Your ScreenshotRun API key. Get one free at screenshotrun.com (200 screenshots/month).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. screenshotrun-mcp
  2. Features
  3. Quick Start
  4. Available Tools
  5. Example Prompts
  6. How It Works
  7. Requirements
  8. Other Projects by ScreenshotRun
  9. License

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.

ParameterTypeDefaultDescription
urlstringrequiredURL to screenshot (must include http:// or https://)
formatpng \jpeg \webp \pdfpngOutput image format
widthnumber1280Viewport width in pixels (320–3840)
heightnumber800Viewport height in pixels (200–2160)
full_pagebooleanfalseCapture the entire scrollable page
qualitynumber80Image quality for JPEG/WebP (1–100)
devicedesktop \mobile \tablet—Device preset (overrides width/height with device defaults)
dark_modebooleanfalseEnable dark mode rendering
block_adsbooleanfalseBlock advertisements during capture
block_cookiesbooleantrueBlock cookie consent dialogs
delaynumber0Delay in seconds after page load before capturing (0–10)
retinabooleanfalseCapture at 2x resolution
cssstring—Custom CSS to inject into the page (max 10KB)
jsstring—Custom JavaScript to execute before capture (max 10KB)
selectorstring—CSS selector to capture a specific element
hide_selectorsstring[]—CSS selectors of elements to hide before capture
click_selectorstring—CSS selector of element to click before capture
scroll_tostring—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

Other Projects by ScreenshotRun

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

License

MIT

Frequently asked questions

What is io.github.webmox/screenshotrun-mcp?

Capture website screenshots in AI agents. Full-page, dark mode, mobile, OG images, base64.

How do I install io.github.webmox/screenshotrun-mcp?

It runs on your machine. In Claude Code: claude mcp add screenshotrun-mcp -e 'SCREENSHOTRUN_API_KEY=<SCREENSHOTRUN_API_KEY>' -- npx -y screenshotrun-mcp@1.0.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.webmox/screenshotrun-mcp need an API key?

Yes. It expects SCREENSHOTRUN_API_KEY, which you set in its configuration.

Is io.github.webmox/screenshotrun-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.webmox/screenshotrun-mcp?

It is published by webmox. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.