Back to Browse

Snapdiff MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Visual-diff & change-detection tools that catch agentic UI drift for coding agents.

About

Visual-diff & change-detection tools that catch agentic UI drift for coding agents.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (4 strong, 5 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

13 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

SnapDiff API key. Get one at https://snapdiff.ai/dashboard.Required

Environment variable: SNAPDIFF_API_KEY

Override the API base URL. Defaults to https://api.snapdiff.ai/v1.Optional

Environment variable: SNAPDIFF_API_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "ai-snapdiff-mcp": {
      "env": {
        "SNAPDIFF_API_KEY": "your-snapdiff-api-key-here",
        "SNAPDIFF_API_URL": "your-snapdiff-api-url-here"
      },
      "args": [
        "-y",
        "@corralimited/snapdiff-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

@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

NamePurpose
snapdiff_verify_ui_changeChecks 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_pagesRaw 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_screenshotSingle screenshot of a URL.
snapdiff_html_to_imageRender 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.


HTTP transport (advanced)

Besides stdio, if you're hosting an MCP gateway and need a streamable HTTP server, run with --http:

SNAPDIFF_API_KEY=sk_live_... npx @corralimited/snapdiff-mcp --http --port 8787

Then point clients at http://localhost:8787/mcp with the standard MCP HTTP transport.


Configuration

Env varRequiredNotes
SNAPDIFF_API_KEYyesGet one at https://snapdiff.ai/dashboard
SNAPDIFF_API_URLnoOverride the API base. Defaults to https://api.snapdiff.ai/v1.

CLI flags (HTTP mode only):

FlagDefaultNotes
--httpoffRun as a streamable HTTP server instead of stdio.
--port <n>8787Port for --http mode.
--host <h>127.0.0.1Bind address for --http mode.

License

MIT — see LICENSE.

Reviews

No reviews yet

Be the first to review this server!