screenshotrun-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@screenshotrun-mcp take a screenshot of screenshotrun.com in dark mode on mobile"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: darkFull-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
Related MCP server: MCP Browser Screenshot Server
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_hereCursor
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 |
| string | required | URL to screenshot (must include http:// or https://) |
|
|
| Output image format |
| number | 1280 | Viewport width in pixels (320–3840) |
| number | 800 | Viewport height in pixels (200–2160) |
| boolean | false | Capture the entire scrollable page |
| number | 80 | Image quality for JPEG/WebP (1–100) |
|
| — | Device preset (overrides width/height with device defaults) |
| boolean | false | Enable dark mode rendering |
| boolean | false | Block advertisements during capture |
| boolean | true | Block cookie consent dialogs |
| number | 0 | Delay in seconds after page load before capturing (0–10) |
| boolean | false | Capture at 2x resolution |
| string | — | Custom CSS to inject into the page (max 10KB) |
| string | — | Custom JavaScript to execute before capture (max 10KB) |
| string | — | CSS selector to capture a specific element |
| string[] | — | CSS selectors of elements to hide before capture |
| string | — | CSS selector of element to click before capture |
| 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
Your AI agent receives a user request involving a webpage screenshot
The agent calls the
take_screenshottool with the URL and optionsThe MCP server sends the request to the ScreenshotRun API
The API renders the page in a real browser and returns the screenshot
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
Available Tools
2 toolscheck_usageA
Check your ScreenshotRun API usage for the current billing period. Shows screenshots used, remaining, and limits.
Inputs: no named parameters.
take_screenshotA
Capture a screenshot of any webpage. Returns the image as base64-encoded data. Supports custom viewport sizes, device emulation, dark mode, full-page capture, ad blocking, and more.
Inputs: url (required), js, css, delay, +14 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
take_screenshot performs image capture while check_usage reports billing/usage metrics; the two purposes are entirely non-overlapping and cannot be confused. An agent will never mis-select between them.
Both names follow a clean verb_noun snake_case pattern (take_screenshot, check_usage). The convention is uniform and predictable.
With only two tools the surface is thin for a screenshot service, though each tool clearly earns its place. It sits at the borderline of the 1-2 tool 'feels thin' band rather than being a mismatch.
Core capability (capturing a screenshot with rich options) and usage/quota introspection are both covered. Minor gaps exist around batch capture, screenshot history/retrieval, or listing past captures, but agents can work around these.
Maintenance
Related MCP Connectors
Let your AI agent see any public web page: one screenshot tool, returns the page as an image.
Screenshot API for AI agents. Any public page as image or PDF, banners hidden, 227 countries.
Screenshot, PDF and Open Graph image API for AI agents: capture pages, render PDFs, make OG images.
Screenshot any public web page from an AI agent. Free without signup, or with an API key.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to ScreenshotOne.com API for capturing website screenshots with customizable options including viewport size, full-page captures, and multiple output formats.80 npm3MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to capture screenshots of web pages using automated browser sessions. Supports full-page and element-specific screenshots, device simulation, and JavaScript execution for comprehensive web testing and monitoring.6MIT
- AlicenseCqualityDmaintenanceEnables taking screenshots of web pages with support for multiple devices (desktop, mobile, tablet), custom dimensions, full-page capture, and various image formats. Built with Playwright for reliable web page rendering and screenshot generation.124 PyPIMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to capture screenshots of any public URL, returning images inline with page metadata. Supports full-page captures, custom wait times, and timeouts.131 npmMIT