Enables AI agents to perform visual diffing, screenshot capture, and HTML-to-image rendering to detect UI drift and regressions.
Also known as corralimited/snapdiff-mcp, snapdiff-mcp, @corralimited/snapdiff-mcp
- Stars
- 5
- Tools
- 4
- Downloads, 30 days
- 278
- Latest version
- 0.5.0
- Last commit
- Sep 11, 2026
- License
- MIT
What is SnapDiff MCP?
SnapDiff enables AI agents to perform visual diffing, screenshot capture, and HTML-to-image rendering to detect UI drift and regressions. It exposes 4 tools, such as snapdiff_verify_ui_change, snapdiff_compare_pages, snapdiff_capture_screenshot.
Summary generated from the project's README
About SnapDiff MCP server
Detecting UI drift and visual regressions is possible through this MCP server that connects AI agents to the SnapDiff REST API. Developers can integrate this tool into local environments using editors like Claude Code, Cursor, Cline, Zed, or Continue by configuring a stdio subprocess. It requires a personal API key provided via the SNAPDIFF_API_KEY environment variable to function.
The server provides four specific tools to handle visual tasks. Agents can use snapdiff_capture_screenshot to take pictures of URLs or snapdiff_html_to_image to render HTML and CSS into images for assets like social media cards or email headers. For testing, snapdiff_compare_pages allows for raw visual diffing between two web pages, while snapdiff_verify_ui_change provides a structured verdict to determine if a visual change was expected or represents an unexpected regression.
What you can do with it
- 1Verify UI changesAsk the agent to check if a recent code change caused an unexpected visual regression compared to a baseline.
- 2Compare web pagesRequest a visual comparison between two different URLs to see the percentage of difference.
- 3Generate social assetsInstruct the agent to render specific HTML and CSS into an image for use as an OG card.
- 4Capture site screenshotsHave the agent take a single screenshot of a specific web address.
Written from the project's README. Every use case is checked against a quote from it.
How to install SnapDiff MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SnapDiff MCP in Claude Code
$ claude mcp add --env 'SNAPDIFF_API_KEY=<YOUR_SNAPDIFF_API_KEY>' snapdiff-mcp -- npx -y @corralimited/snapdiff-mcpInstall SnapDiff MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"snapdiff-mcp": {
"command": "npx",
"args": [
"-y",
"@corralimited/snapdiff-mcp"
],
"env": {
"SNAPDIFF_API_KEY": "<YOUR_SNAPDIFF_API_KEY>"
}
}
}
}Install SnapDiff MCP in VS Code
.vscode/mcp.json
{
"servers": {
"snapdiff-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@corralimited/snapdiff-mcp"
],
"env": {
"SNAPDIFF_API_KEY": "<YOUR_SNAPDIFF_API_KEY>"
}
}
}
}Install SnapDiff MCP in VS Code CLI
$ code --add-mcp '{"name":"snapdiff-mcp","type":"stdio","command":"npx","args":["-y","@corralimited/snapdiff-mcp"],"env":{"SNAPDIFF_API_KEY":"<YOUR_SNAPDIFF_API_KEY>"}}'Install SnapDiff MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"snapdiff-mcp": {
"command": "npx",
"args": [
"-y",
"@corralimited/snapdiff-mcp"
],
"env": {
"SNAPDIFF_API_KEY": "<YOUR_SNAPDIFF_API_KEY>"
}
}
}
}Install SnapDiff MCP in Codex
$ codex mcp add snapdiff-mcp --env 'SNAPDIFF_API_KEY=<YOUR_SNAPDIFF_API_KEY>' -- npx -y @corralimited/snapdiff-mcpInstall SnapDiff MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.snapdiff-mcp] command = "npx" args = ["-y", "@corralimited/snapdiff-mcp"] [mcp_servers.snapdiff-mcp.env] SNAPDIFF_API_KEY = "<YOUR_SNAPDIFF_API_KEY>"
Install SnapDiff MCP in Gemini CLI
$ gemini mcp add -s user -e 'SNAPDIFF_API_KEY=<YOUR_SNAPDIFF_API_KEY>' snapdiff-mcp npx -- -y @corralimited/snapdiff-mcpInstall SnapDiff MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"snapdiff-mcp": {
"command": "npx",
"args": [
"-y",
"@corralimited/snapdiff-mcp"
],
"env": {
"SNAPDIFF_API_KEY": "<YOUR_SNAPDIFF_API_KEY>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
SnapDiff MCP tools 4
Detected from the READMEsnapdiff_verify_ui_changesnapdiff_compare_pagessnapdiff_capture_screenshotsnapdiff_html_to_image
Configuration
SNAPDIFF_API_KEYRequiredSecretSnapDiff API key. Get one at https://snapdiff.ai/dashboard.
SNAPDIFF_API_URLOverride the API base URL. Defaults to https://api.snapdiff.ai/v1.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablecorralimited/snapdiff-mcp is public and reachablegithub.com/corralimited/snapdiff-mcp ↗Pass
- Package names this repository as its source@corralimited/snapdiff-mcp names corralimited/snapdiff-mcp as sourcenpmjs.com/package/@corralimited/snapdiff-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @corralimited/snapdiff-mcpnpmjs.com/package/@corralimited/snapdiff-mcp/v/0.5.0#provena ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-11github.com/corralimited/snapdiff-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @corralimited/snapdiff-mcpPass
- No critical advisory in the package or its dependencies103 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@corralimited/snapdiff-mcp
Standalone MCP server for SnapDiff. Exposes four tools to local agents:
- Compare two web pages visually — diff percentage plus a highlighted diff image
- Capture a screenshot of any URL
- Check whether a page changed vs. a previous capture
- Render HTML/CSS to an image (OG cards, social images, email headers)
Hits the public SnapDiff REST API. Bring your own API key.
Quickstart
Get an API key at https://snapdiff.ai/dashboard, then drop the snippet for your agent below.
Claude Code
claude mcp add snapdiff -e SNAPDIFF_API_KEY=sk_live_... -- npx -y @corralimited/snapdiff-mcp
Or edit ~/.claude/settings.json:
{
"mcpServers": {
"snapdiff": {
"command": "npx",
"args": ["-y", "@corralimited/snapdiff-mcp"],
"env": { "SNAPDIFF_API_KEY": "sk_live_..." }
}
}
}
Cursor
~/.cursor/mcp.json (or project-level .cursor/mcp.json):
{
"mcpServers": {
"snapdiff": {
"command": "npx",
"args": ["-y", "@corralimited/snapdiff-mcp"],
"env": { "SNAPDIFF_API_KEY": "sk_live_..." }
}
}
}
Cline (VS Code)
Cline > MCP Servers > Edit Config:
{
"mcpServers": {
"snapdiff": {
"command": "npx",
"args": ["-y", "@corralimited/snapdiff-mcp"],
"env": { "SNAPDIFF_API_KEY": "sk_live_..." }
}
}
}
Zed
~/.config/zed/settings.json:
{
"context_servers": {
"snapdiff": {
"command": {
"path": "npx",
"args": ["-y", "@corralimited/snapdiff-mcp"],
"env": { "SNAPDIFF_API_KEY": "sk_live_..." }
}
}
}
}
Continue
~/.continue/config.yaml:
mcpServers:
- name: snapdiff
command: npx
args: ["-y", "@corralimited/snapdiff-mcp"]
env:
SNAPDIFF_API_KEY: sk_live_...
Anything else with a generic stdio MCP slot
command: npx
args: -y @corralimited/snapdiff-mcp
env: SNAPDIFF_API_KEY=sk_live_...
Tools
| Name | Purpose |
|---|---|
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. |
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. |
snapdiff_capture_screenshot |
Single screenshot of a URL. |
snapdiff_html_to_image |
Render HTML/CSS to an image (OG cards, social images, email headers). |
Schemas live in src/tools/ and are exported from @corralimited/snapdiff-mcp/tools.
The hosted SnapDiff backend imports the same schemas so its in-process /mcp endpoint and this
standalone stdio server expose an identical surface — agents see the same tool names, descriptions,
and parameters whether they connect to https://api.snapdiff.ai/mcp or run this server locally.
Remote HTTP access
This package speaks stdio only — your editor spawns it as a subprocess, and the Playwright-backed localhost tools run on your machine, where your dev server actually is. It does not open a port.
If you need an HTTP endpoint, use the hosted one at https://mcp.snapdiff.ai/mcp,
which authenticates every request with your API key and exposes the same tool surface.
Configuration
| Env var | Required | Notes |
|---|---|---|
SNAPDIFF_API_KEY |
yes | Get one at https://snapdiff.ai/dashboard |
SNAPDIFF_API_URL |
no | Override the API base. Defaults to https://api.snapdiff.ai/v1. |
There are no CLI flags beyond --help.
License
MIT — see LICENSE.
SnapDiff MCP questions
How do I add SnapDiff MCP to Claude Code?
Run claude mcp add --env 'SNAPDIFF_API_KEY=<YOUR_SNAPDIFF_API_KEY>' snapdiff-mcp -- npx -y @corralimited/snapdiff-mcp in your terminal. Add --scope user to make it available in every project.
How do I add SnapDiff MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does SnapDiff MCP provide?
It exposes 4 tools, including snapdiff_verify_ui_change, snapdiff_compare_pages, snapdiff_capture_screenshot, snapdiff_html_to_image.