
Site-Shot
from site-shot
Official MCP server for the Site-Shot website screenshot API โ capture_screenshot & capture_full_page with real Chromium, full-page capture, country proxies, and ad/cookie-banner removal.
Site-Shot MCP server
Give Claude, Cursor, and other AI agents the ability to see any web page โ take website screenshots with Site-Shot over the Model Context Protocol.
Real Chromium rendering ยท full-page capture ยท country proxies ยท automatic ad & cookie-banner removal (cleaner images, fewer vision tokens).
Tools
capture_screenshot
Screenshot a web page (viewport by default).
| Param | Type | Default | Notes |
|---|---|---|---|
url | string (required) | โ | Page to capture |
full_page | boolean | false | Capture the whole scrollable page |
width / height | number | 1280 / 1024 | Viewport / device size |
format | "png" | "jpeg" | png | Image format |
block_ads | boolean | true | Remove ads |
block_cookie_banners | boolean | true | Remove cookie-consent popups |
country | string | โ | Proxy country, e.g. "Germany" (auto IP/lang/tz/geo) |
language / time_zone / geolocation | string | โ | Manual overrides |
wait_ms | number | โ | Wait before capture (SPAs/animations) |
max_height | number | 20000 (full page) | Cap captured height |
Returns the screenshot as an MCP image.
capture_full_page
Same as capture_screenshot with full-page capture enabled.
Local development
npm install
npm run check # syntax check
npm run smoke # offline tests (stubbed fetch, no API key needed)
SITESHOT_API_KEY=yourkey npm start # run the server on stdionpm install
npm run check # syntax check
npm run smoke # offline tests (stubbed fetch, no API key needed)
SITESHOT_API_KEY=yourkey npm start # run the server on stdioBefore it works, you'll need: SITESHOT_API_KEY
Quick start (Claude Desktop)
- Get a Site-Shot API key at https://www.site-shot.com/pricing/.
- Add this to your Claude Desktop config (
claude_desktop_config.json):
{
"mcpServers": {
"site-shot": {
"command": "npx",
"args": ["-y", "site-shot-mcp"],
"env": { "SITESHOT_API_KEY": "YOUR_API_KEY" }
}
}
}- Restart Claude Desktop. Ask it to "take a full-page screenshot of https://news.ycombinator.com" and it will call the server and show you the image.
Works the same way in any MCP client (Cursor, Cline, VS Code, LangChain, CrewAI) โ point the client at
npx -y site-shot-mcp with SITESHOT_API_KEY in the environment.
Configuration
| Env var | Required | Description |
|---|---|---|
SITESHOT_API_KEY | yes | Your Site-Shot API key (used as userkey). |
The server is a thin wrapper over the existing Site-Shot HTTP API (https://api.site-shot.com/) โ no
separate backend.
Requirements
Node.js โฅ 18 (uses the built-in fetch).
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
License
MIT