snaprender-mcp
v1.6.0
Published
MCP server for the SnapRender screenshot API: lets AI agents capture websites as PNG, JPEG, WebP or PDF, extract content and run batches
Maintainers
Readme
snaprender-mcp
MCP (Model Context Protocol) server for SnapRender Screenshot API. Lets AI agents like Claude capture website screenshots, check cache status, and monitor usage.
Quick Start
With Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"snaprender": {
"command": "npx",
"args": ["-y", "snaprender-mcp"],
"env": {
"SNAPRENDER_API_KEY": "sk_live_your_key_here"
}
}
}
}With Claude Code
Add to your project's .mcp.json:
{
"mcpServers": {
"snaprender": {
"command": "npx",
"args": ["-y", "snaprender-mcp"],
"env": {
"SNAPRENDER_API_KEY": "sk_live_your_key_here"
}
}
}
}Tools
take_screenshot
Capture a screenshot of any website.
Parameters:
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| url | string | Yes | URL to capture |
| format | string | No | png, jpeg, webp, or pdf (default: png) |
| width | integer | No | Viewport width 320-3840 (default: 1280) |
| height | integer | No | Viewport height 200-10000 (default: 800) |
| full_page | boolean | No | Capture entire scrollable page |
| lazy_load | boolean | No | With full_page: scroll through the page first so lazy-loaded images appear (slower, usually 1-5 s more) |
| device | string | No | iphone_14, iphone_15_pro, pixel_7, ipad_pro, macbook_pro |
| dark_mode | boolean | No | Enable dark mode |
| block_ads | boolean | No | Block ads (default: true) |
| block_cookie_banners | boolean | No | Remove cookie banners (default: true) |
| quality | integer | No | JPEG/WebP quality 1-100 (default: 90) |
| delay | integer | No | Wait ms after page load (default: 0) |
| hide_selectors | string | No | Comma-separated CSS selectors to hide before capture |
| click_selector | string | No | CSS selector to click before capture |
| user_agent | string | No | Custom user agent string |
| cache | boolean | No | Use cached result. Set to true to enable caching (default: false) |
| cache_ttl | integer | No | Cache TTL in seconds, 0-2592000. Clamped to plan max (default: 86400) |
check_screenshot_cache
Check if a screenshot is cached without capturing. Does not count against your quota. Pass the same parameters you would use for take_screenshot so the cache key matches.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| url | string | Yes | URL to check |
| format | string | No | Output format |
| width | integer | No | Viewport width |
| height | integer | No | Viewport height |
| full_page | boolean | No | Full page capture |
| lazy_load | boolean | No | Lazy image loading (pass the same value as the capture) |
| dark_mode | boolean | No | Dark mode |
| block_ads | boolean | No | Block ads |
| device | string | No | Device preset |
| quality | integer | No | Image quality |
| hide_selectors | string | No | CSS selectors to hide |
| click_selector | string | No | CSS selector to click |
get_usage
Get current month's usage statistics. No parameters required.
Get an API Key
Sign up for free at snap-render.com — 200 screenshots/month, no credit card required.
Try it without a key
The API key is optional. If SNAPRENDER_API_KEY is not set, the server starts anyway. On the first tool call it gets a free trial key (100 captures, 30 a day, watermarked, slowest lane) and saves it to ~/.snaprender/trial.json (file mode 0600). Every result then ends with a short note that shows how many trial captures are left and a claim link. Open the claim link to turn the key into a free account (200 captures a month, no watermark), then set SNAPRENDER_API_KEY if you want to use a different key.
The trial key cannot create webhooks or signed URLs, and batches are limited to 5 URLs. When the trial key expires or runs out, the tool result tells the agent to ask you to claim the key or sign up. A new trial key is never created automatically after that. If you set SNAPRENDER_API_KEY, none of this applies and nothing is written to disk.
Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| SNAPRENDER_API_KEY | No | Your API key (starts with sk_live_). Without it the server uses a free trial key |
| SNAPRENDER_URL | No | API base URL (default: https://app.snap-render.com) |
