# MCP server

SiteShot ships an official Model Context Protocol (MCP) server so AI agents and MCP-aware IDEs (Claude Desktop, Claude Code, Cursor, Windsurf) can take website screenshots as a native tool.

- npm package: `site-shot-mcp` — run with `npx -y site-shot-mcp`
- Official MCP Registry: `io.github.site-shot/site-shot-mcp`
- Source: https://github.com/site-shot/site-shot-mcp

The server is a thin stdio wrapper over the existing screenshot API. It does not change the screenshot backend; it authenticates with the same screenshot API key.

## Configuration

Set the screenshot API key as the `SITESHOT_API_KEY` environment variable. Example Claude Desktop / Cursor config:

```json
{
  "mcpServers": {
    "site-shot": {
      "command": "npx",
      "args": ["-y", "site-shot-mcp"],
      "env": { "SITESHOT_API_KEY": "YOUR_API_KEY" }
    }
  }
}
```

## Tools

- `capture_screenshot`: capture a web page and return it as an image. Supports viewport sizing, full-page capture, country proxies, and ad / cookie-banner removal.
- `capture_full_page`: convenience wrapper that captures the entire scrollable page.

## Parameters

Both tools accept `url` plus optional `width`, `height`, `format` (`png`/`jpeg`), `block_ads`, `block_cookie_banners`, `country`, `language`, `time_zone`, `geolocation`, `wait_ms`, and `max_height`. `capture_screenshot` also accepts `full_page`. Ad and cookie-banner removal default to on, producing cleaner images and fewer vision tokens for the agent.

These map to the same query parameters documented in the [Screenshot API](/api/v1/agent/docs/screenshot-api.md) page. Get an API key from the [pricing page](/pricing/).