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).
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.
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.
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.
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 stdio
Requirements
Node.js ≥ 18 (uses the built-in fetch).
License
MIT