MCP Server

The Pixel House exposes a Model Context Protocol server so AI coding assistants can trigger visual regression tests directly from your development environment.

MCP server access is included on all paid plans. Coming in v2.0.

Claude Code

Option A: Local server (recommended) — runs via the CLI with no network roundtrip for the MCP protocol. Install the CLI first, then:

claude mcp add pixelhouse -- pixelhouse mcp serve

The CLI resolves your API key from PIXELHOUSE_API_KEY, .pixelhouserc.json, or the --api-key flag.

Option B: Remote server — connect directly over HTTP, no CLI needed:

claude mcp add --transport http pixelhouse \
  https://mcp.thepixelhouse.co.uk/mcp \
  --header "Authorization: Bearer ph_live_your_key"

Cursor

Local server — add to .cursor/mcp.json:

{
  "mcpServers": {
    "pixelhouse": {
      "command": "pixelhouse",
      "args": ["mcp", "serve"]
    }
  }
}

Remote server — no CLI needed:

{
  "mcpServers": {
    "pixelhouse": {
      "url": "https://mcp.thepixelhouse.co.uk/mcp",
      "headers": {
        "Authorization": "Bearer ${PIXELHOUSE_API_KEY}"
      }
    }
  }
}

Windsurf

Local server — add to your MCP config:

{
  "mcpServers": {
    "pixelhouse": {
      "command": "pixelhouse",
      "args": ["mcp", "serve"]
    }
  }
}

Remote server — no CLI needed:

{
  "mcpServers": {
    "pixelhouse": {
      "serverUrl": "https://mcp.thepixelhouse.co.uk/mcp",
      "headers": {
        "Authorization": "Bearer ${PIXELHOUSE_API_KEY}"
      }
    }
  }
}

Available tools

take_screenshotCapture a URL screenshot across viewports

compare_screenshotsDiff two screenshots with pixel-level comparison

run_visual_regressionCapture and compare against baseline in one call

create_baselinePromote a screenshot to baseline

approve_changesAccept detected changes, update baseline

list_baselinesList baselines for a project

get_diff_reportGet regression test results with diff images

discover_pagesCrawl sitemap to find testable pages

Example conversation

You

Check if my CSS changes broke the homepage layout

Claude

Running visual regression on your homepage...

run_visual_regression

PASS0.3% diff · below 1% threshold

No visual regressions detected. Your CSS changes are safe to ship.