{
  "markdown": "# @corralimited/snapdiff-mcp\n\nStandalone MCP server for [SnapDiff](https://snapdiff.ai). Exposes four tools to local agents:\n\n- **Compare two web pages visually** — diff percentage plus a highlighted diff image\n- **Capture a screenshot** of any URL\n- **Check whether a page changed** vs. a previous capture\n- **Render HTML/CSS to an image** (OG cards, social images, email headers)\n\nHits the public SnapDiff REST API. Bring your own [API key](https://snapdiff.ai/dashboard).\n\n---\n\n## Quickstart\n\nGet an API key at https://snapdiff.ai/dashboard, then drop the snippet for your agent below.\n\n### Claude Code\n\n```bash\nclaude mcp add snapdiff -e SNAPDIFF_API_KEY=sk_live_... -- npx -y @corralimited/snapdiff-mcp\n```\n\nOr edit `~/.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"snapdiff\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@corralimited/snapdiff-mcp\"],\n      \"env\": { \"SNAPDIFF_API_KEY\": \"sk_live_...\" }\n    }\n  }\n}\n```\n\n### Cursor\n\n`~/.cursor/mcp.json` (or project-level `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"snapdiff\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@corralimited/snapdiff-mcp\"],\n      \"env\": { \"SNAPDIFF_API_KEY\": \"sk_live_...\" }\n    }\n  }\n}\n```\n\n### Cline (VS Code)\n\n`Cline > MCP Servers > Edit Config`:\n\n```json\n{\n  \"mcpServers\": {\n    \"snapdiff\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@corralimited/snapdiff-mcp\"],\n      \"env\": { \"SNAPDIFF_API_KEY\": \"sk_live_...\" }\n    }\n  }\n}\n```\n\n### Zed\n\n`~/.config/zed/settings.json`:\n\n```json\n{\n  \"context_servers\": {\n    \"snapdiff\": {\n      \"command\": {\n        \"path\": \"npx\",\n        \"args\": [\"-y\", \"@corralimited/snapdiff-mcp\"],\n        \"env\": { \"SNAPDIFF_API_KEY\": \"sk_live_...\" }\n      }\n    }\n  }\n}\n```\n\n### Continue\n\n`~/.continue/config.yaml`:\n\n```yaml\nmcpServers:\n  - name: snapdiff\n    command: npx\n    args: [\"-y\", \"@corralimited/snapdiff-mcp\"]\n    env:\n      SNAPDIFF_API_KEY: sk_live_...\n```\n\n### Anything else with a generic stdio MCP slot\n\n```\ncommand: npx\nargs:    -y @corralimited/snapdiff-mcp\nenv:     SNAPDIFF_API_KEY=sk_live_...\n```\n\n---\n\n## Tools\n\n| Name                          | Purpose                                                                                                                                                                                                                                                                                                                                  |\n| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `snapdiff_verify_ui_change`   | Checks whether a visual change matches the agent's stated intent. Returns `verdict` (`pass` / `expected_change_detected` / `unexpected_regression` / `no_change_detected` / `needs_human_review`) and a `next_action`. Requires a project + baseline. **Use this in the verification loop.** |\n| `snapdiff_compare_pages`      | Raw visual diff between two URLs, or a URL vs. a stored project baseline. Use for ad-hoc diffs that don't fit the verify-ui-change verdict shape.                                                                                                                                                                                        |\n| `snapdiff_capture_screenshot` | Single screenshot of a URL.                                                                                                                                                                                                                                                                                                              |\n| `snapdiff_html_to_image`      | Render HTML/CSS to an image (OG cards, social images, email headers).                                                                                                                                                                                                                                                                    |\n\nSchemas live in [`src/tools/`](./src/tools/) and are exported from `@corralimited/snapdiff-mcp/tools`.\nThe hosted SnapDiff backend imports the same schemas so its in-process `/mcp` endpoint and this\nstandalone stdio server expose an identical surface — agents see the same tool names, descriptions,\nand parameters whether they connect to `https://api.snapdiff.ai/mcp` or run this server locally.\n\n---\n\n## HTTP transport (advanced)\n\nBesides stdio, if you're hosting an MCP gateway\nand need a streamable HTTP server, run with `--http`:\n\n```bash\nSNAPDIFF_API_KEY=sk_live_... npx @corralimited/snapdiff-mcp --http --port 8787\n```\n\nThen point clients at `http://localhost:8787/mcp` with the standard MCP HTTP transport.\n\n---\n\n## Configuration\n\n| Env var            | Required | Notes                                                            |\n| ------------------ | -------- | ---------------------------------------------------------------- |\n| `SNAPDIFF_API_KEY` | yes      | Get one at https://snapdiff.ai/dashboard                         |\n| `SNAPDIFF_API_URL` | no       | Override the API base. Defaults to `https://api.snapdiff.ai/v1`. |\n\nCLI flags (HTTP mode only):\n\n| Flag         | Default     | Notes                                             |\n| ------------ | ----------- | ------------------------------------------------- |\n| `--http`     | off         | Run as a streamable HTTP server instead of stdio. |\n| `--port <n>` | `8787`      | Port for `--http` mode.                           |\n| `--host <h>` | `127.0.0.1` | Bind address for `--http` mode.                   |\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n",
  "bytes": 5860,
  "sha": "7e8547b16091ce9957c5d307eb0c909180ab1c436de32bba94ca8b6c47ce3ca9",
  "repo_slug": "corralimited/snapdiff-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_snapdiff_mcp_a04a37f1/readme"
}