What can you do with this server?

This server lets you capture webpage screenshots and check your ScreenshotRun API usage. * Take screenshots of any URL and get the image back as base64-encoded data * Choose output format — PNG, JPEG, WebP, or PDF, with quality control for JPEG/WebP * Control the viewport — custom width/height, desktop/mobile/tablet presets, and retina (2x) capture * Render appearance options — dark mode and full-page capture * Target specific content — capture a single element via CSS selector * Interact before capture — click an element, scroll to an element, or hide elements via selectors * Block unwanted content — ads and cookie consent dialogs * Inject customization — custom CSS or JavaScript * Time the capture — configurable delay after page load (0–10s) * Check usage — see screenshots used, remaining, and limits for the current billing period

screenshotrun-mcp

Official

by screenshotrun

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

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
Render raw HTML or Markdown to image
Device emulation — desktop, mobile, and tablet viewports
Dark mode rendering with prefers-color-scheme: dark
Full-page capture with automatic scrolling
Block ads, cookie consent banners, and live chat widgets
Inject custom CSS/JavaScript before capture
Target specific elements with CSS selectors
Wait for elements, click, hover, and scroll before capture
Retina (2x) and custom device pixel ratio support
Geolocation and timezone emulation
Stealth mode to avoid bot detection
Transparent background, clipping, and output resizing
Extract page metadata (title, description, OG tags, Twitter Card)
Analyze page structure — headings, interactive elements, forms, images, navigation with bounding rectangles
Certified screenshots with SHA-256 hash
PDF output with custom page format and margins
Scroll video recording
Monitor your API usage and remaining quota

Related MCP server: ShotAPI

Quick Start

1. Get your API key

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 / VS Code

Add to your 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, raw HTML, or Markdown. Returns the image as base64-encoded data that AI agents can analyze and describe.

Source (one required)

Parameter	Type	Description
`url`	string	URL to screenshot (http:// or https://)
`html`	string	Raw HTML to render (max 500KB)
`markdown`	string	Markdown to render (max 500KB)

Output

Parameter	Type	Default	Description
`format`	`png` \| `jpeg` \| `webp` \| `pdf`	`png`	Output format
`quality`	number	80	Image quality for JPEG/WebP (1-100)

Viewport & Device

Parameter	Type	Default	Description
`width`	number	1280	Viewport width (320-3840)
`height`	number	800	Viewport height (200-2160)
`full_page`	boolean	false	Capture entire scrollable page
`device`	`desktop` \| `mobile` \| `tablet`	--	Device preset
`retina`	boolean	false	2x resolution
`device_scale_factor`	number	--	Custom pixel ratio (0.5-4)

Appearance

Parameter	Type	Default	Description
`dark_mode`	boolean	false	Enable dark mode
`omit_background`	boolean	false	Transparent background (PNG/WebP)
`media_type`	`screen` \| `print`	--	Emulate CSS media type
`reduced_motion`	boolean	false	Emulate prefers-reduced-motion
`disable_animations`	boolean	false	Disable CSS animations

Blocking

Parameter	Type	Default	Description
`block_ads`	boolean	false	Block advertisements
`block_cookies`	boolean	true	Block cookie consent dialogs
`block_chats`	boolean	false	Block live chat widgets
`block_requests`	string[]	--	URL patterns to block
`block_resources`	string[]	--	Resource types to block (image, stylesheet, font, script, media, websocket, manifest, other)

Interaction

Parameter	Type	Description
`selector`	string	CSS selector to capture a specific element
`click_selector`	string	Element to click before capture
`hover_selector`	string	Element to hover before capture
`scroll_to`	string	Element to scroll into view
`hide_selectors`	string[]	Elements to hide before capture
`wait_for_selector`	string	Wait for element to appear

Injection

Parameter	Type	Description
`css`	string	Custom CSS (max 10KB)
`js`	string	Custom JavaScript (max 10KB)
`user_agent`	string	Custom User-Agent
`headers`	object	Custom HTTP headers
`cookies`	array	Cookies to set (`{name, value, domain?}`)

Timing

Parameter	Type	Default	Description
`delay`	number	0	Seconds to wait after load (0-10)
`timeout`	number	30	Max page load time (5-60s)
`navigation_timeout`	number	--	Max navigation time (5-60s)
`wait_until`	string	--	`load`, `domcontentloaded`, `networkidle`, or `commit`

Clipping & Resizing

Parameter	Type	Description
`resize_width`	number	Resize output width (16-3840)
`resize_height`	number	Resize output height (16-2160)
`clip`	object	Clip rectangle `{x, y, width, height}`

Advanced

Parameter	Type	Default	Description
`stealth`	boolean	false	Stealth mode (avoid bot detection)
`bypass_csp`	boolean	false	Bypass Content Security Policy
`cache_ttl`	number	--	Cache duration in seconds (0-86400)
`extract_metadata`	boolean	false	Extract page metadata (title, OG, Twitter Card)
`certified`	boolean	false	Certified screenshot with SHA-256

Geolocation

Parameter	Type	Description
`geolocation`	object	`{latitude, longitude, accuracy?}`
`timezone`	string	e.g. `America/New_York`
`proxy`	string	HTTP/SOCKS proxy URL

PDF Options (format=pdf)

Parameter	Type	Description
`pdf_landscape`	boolean	Landscape orientation
`pdf_page_format`	string	`A3`, `A4`, `A5`, `Letter`, `Legal`, `Tabloid`
`pdf_margin_top`	string	e.g. `1cm`, `0.5in`
`pdf_margin_right`	string	Right margin
`pdf_margin_bottom`	string	Bottom margin
`pdf_margin_left`	string	Left margin

Scroll Video

Parameter	Type	Description
`scroll_video`	boolean	Record scrolling video
`scroll_duration`	number	Duration 2-30 seconds
`scroll_speed`	`slow` \| `medium` \| `fast`	Scroll speed

`analyze_page`

Analyze any webpage and get structured data about its content. Returns headings, interactive elements (buttons, links, inputs), forms, images, and navigation links — each with a bounding rectangle [x, y, width, height] for visual mapping. Pro feature with 20 free trial runs per month.

Core Parameters

Parameter	Type	Default	Description
`url`	string	required	URL to analyze (http:// or https://)
`include`	string[]	all	Categories to return: `headings`, `interactive`, `forms`, `images`, `text`, `navigation`
`visible_only`	boolean	true	Only return visible elements
`scope`	string	--	CSS selector to limit analysis to a section (e.g. `main`, `#content`)
`with_screenshot`	boolean	false	Capture screenshot alongside analysis (costs 1 extra request)

Viewport & Appearance

Parameter	Type	Default	Description
`width`	number	1280	Viewport width (320-3840)
`height`	number	800	Viewport height (200-2160)
`device`	`desktop` \| `mobile` \| `tablet`	--	Device preset
`dark_mode`	boolean	false	Enable dark mode

Blocking & Timing

Parameter	Type	Default	Description
`block_ads`	boolean	false	Block advertisements
`block_cookies`	boolean	true	Block cookie consent dialogs
`block_chats`	boolean	false	Block live chat widgets
`delay`	number	0	Seconds to wait after load (0-10)
`timeout`	number	30	Max page load time (5-60s)
`stealth`	boolean	false	Stealth mode

Injection & Advanced

Parameter	Type	Description
`css`	string	Custom CSS (max 10KB)
`js`	string	Custom JavaScript (max 10KB)
`hide_selectors`	string[]	Elements to hide before analysis
`wait_for_selector`	string	Wait for element to appear
`user_agent`	string	Custom User-Agent
`proxy`	string	HTTP/SOCKS proxy URL
`timezone`	string	e.g. `America/New_York`
`geolocation`	object	`{latitude, longitude, accuracy?}`
`headers`	object	Custom HTTP headers
`cookies`	array	Cookies to set (`{name, value, domain?}`)

`extract_content`

Extract page metadata from any URL without downloading the full image. Returns title, description, Open Graph tags, Twitter Card tags, favicon URL, and HTTP status. Useful for SEO audits, content analysis, and link previews.

Parameter	Type	Description
`url`	string	URL to extract metadata from

`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 stripe.com on mobile in dark mode"
"Capture full-page screenshot of my website in WebP"
"Take a retina screenshot of example.com in JPEG format"
"Screenshot a page with the cookie banner and chat widget hidden"
"Render this HTML as an image: <h1>Hello World</h1>"
"Capture example.com as seen from Tokyo" (with geolocation + timezone)
"Take a screenshot with transparent background for my design comp"
"Wait for the .loading-spinner to disappear, then screenshot"
"Click the 'Show More' button, then capture the page"
"Analyze the page structure of competitor.com — show me all headings and interactive elements"
"What forms and images are on this landing page?"
"Analyze example.com on mobile and show me the navigation links"
"Extract the OG tags and meta description from competitor.com"
"Check how many screenshots I have left this month"

How It Works

Your AI agent receives a user request involving a webpage
The agent calls the appropriate tool (take_screenshot, analyze_page, or extract_content)
The MCP server sends the request to the ScreenshotRun API
The API renders the page in a real browser and returns the result
Screenshots are returned as base64 images; analysis results are returned as structured text with element positions

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 tools

check_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…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.9/5.0

Scored 2026-10-23 06:05 across 2 tools

Disambiguation5/5

The two tools serve completely different purposes: one queries billing/quota usage, the other performs screenshot capture. There is no plausible way an agent would confuse them.

Naming Consistency5/5

Both tools follow the same snake_case verb_noun convention (check_usage, take_screenshot), making the pattern predictable and readable.

Tool Count4/5

Two tools is thin but defensible for a focused screenshot API wrapper—capture plus quota check are the core operations. It sits just below the typical 3+ range, so not a full 5.

Completeness4/5

The essential workflow (take a screenshot, check remaining quota) is covered, but there is no way to retrieve previously captured screenshots, list history, or manage account settings. These are minor gaps agents can work around for the primary use case.

Maintenance

ActivityMaintained

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

GrabbitA
live.grabbit
Grabbit gives AI agents eyes on the web through a hosted MCP server. Send a public URL and get a pixel-perfect hosted image back, without maintaining Chromium, Playwright, or a browser fleet. Capture a full page, exact viewport, or single CSS selector as PNG, JPEG, or WebP. Grabbit handles cookie and consent banners, waits for JavaScript-heavy pages, blocks private and internal URLs, supports safe retries with idempotency keys, and delivers async results through signed webhooks. Completed captures include a CDN URL. Connect with OAuth 2.1 or an API key. Grabbit works with Claude, Cursor, Codex, and any MCP client. Live captures cost $0.002 each. The $50 annual plan includes 25,000 prepaid credits that never reset or expire. Free test keys return placeholder images, so you can wire up the integration before paying. Home: https://grabbit.live Docs: https://grabbit.live/screenshot-api Built by BrainGrid.
Browser Automation Web Scraping
52
https://mcp.grabbit.live
ShotkilnA
com.shotkiln
Screenshot, PDF and Open Graph image API for AI agents: capture pages, render PDFs, make OG images.
Browser Automation Image & Video Processing
31
https://shotkiln.com/mcp
snaplab
dev.snaplab
Screenshot, PDF and HTML-to-image rendering API so Claude and Cursor can see any web page.
Browser Automation Image & Video Processing
1
https://snaplab.dev/mcp
snaplab
app.hsingh.snaplab
Screenshot, PDF and HTML-to-image rendering API so Claude and Cursor can see any web page.
Image & Video Processing Browser Automation
1
https://snaplab.hsingh.app/mcp

Related MCP Servers

snaprender-mcp
Browser Automation Web Scraping App Automation
User0856
A
license
A
quality
B
maintenance
Lets AI agents like Claude capture website screenshots, check cache status, and monitor usage.
Updated 2 days ago (2026-11-12 11:44 UTC)
11
3
MIT
ShotAPI
Browser Automation Image & Video Processing
smallhandsome
F
license
Not graded
quality
D
maintenance
Screenshot & Render API for AI Agents. MCP Server lets Claude, Cursor capture webpages and render HTML. Direct access, no VPN needed.
Updated 5 months ago (2026-06-08 07:18 UTC)
-
ShotAPI
Browser Automation Image & Video Processing
smallhandsome
A
license
Not graded
quality
D
maintenance
Screenshot and HTML Rendering MCP Server for AI Agents. Capture screenshots, render HTML to images, and generate PDFs via simple API calls. Compatible with Claude, Cursor, and any MCP client.
Updated 5 months ago (2026-06-17 15:32 UTC)
1
MIT
Renderly MCP
Browser Automation Web Scraping RAG Systems
xufei547
A
license
A
quality
D
maintenance
Enables AI agents to capture clean web screenshots and extract main article content from any web page, with automatic removal of cookie banners, ads, and boilerplate.
Updated 5 months ago (2026-06-28 08:35 UTC)
2
MIT

screenshotrun-mcp

Features

Quick Start

1. Get your API key

2. Configure your AI client

Claude Desktop

Claude Code

Cursor

Windsurf / VS Code

Available Tools

take_screenshot

Source (one required)

Output

Viewport & Device

Appearance

Blocking

Interaction

Injection

Timing

Clipping & Resizing

Advanced

Geolocation

PDF Options (format=pdf)

Scroll Video

analyze_page

Core Parameters

Viewport & Appearance

Blocking & Timing

Injection & Advanced

extract_content

check_usage

Example Prompts

How It Works

Requirements

Other Projects by ScreenshotRun

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

snaprender-mcp

ShotAPI

ShotAPI

Renderly MCP

`take_screenshot`

`analyze_page`

`extract_content`

`check_usage`