Site-Shot MCP Server

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.

GitHub

ドキュメント

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