applitools avatar

Applitools

applitools/mcp

Connects your AI assistant to Applitools Eyes for visual testing in Playwright JavaScript/TypeScript projects. You get tools to verify your API key, set up the Fixtures SDK with recommended defaults, add visual checkpoints to existing tests, configure Ultrafast Grid for cross-browser coverage, and pull structured test results directly into your workflow. It reads from your config files and environment variables, extends the Playwright HTML reporter with Eyes results, and surfaces batch URLs from console output. Reach for this when you're adding visual regression testing to a Playwright suite or expanding coverage across browsers and want your AI to handle the configuration and checkpoint placement instead of doing it manually.

tools
22
transport
STDIO
last updated
Nov 12, 2026

Tools

22 tools

Public tool metadata for what this MCP can expose to an agent.

eyes_verify_api_keyValidates your Applitools API key and, if provided, verifies connectivity to a specified Eyes server URL (e.g., non-public cloud).

Validates your Applitools API key and, if provided, verifies connectivity to a specified Eyes server URL (e.g., non-public cloud).

No parameter schema in public metadata yet.

eyes_setup_projectGuides the setup of Applitools Eyes in your Playwright project (Fixtures variant).

Guides the setup of Applitools Eyes in your Playwright project (Fixtures variant).

No parameter schema in public metadata yet.

eyes_add_checkpoints_to_testAdds Eyes visual checkpoints to your existing Playwright test in line with best practices.

Adds Eyes visual checkpoints to your existing Playwright test in line with best practices.

No parameter schema in public metadata yet.

eyes_setup_ufgConfigures the Ultrafast Grid (UFG) for cross-browser and cross-device testing.

Configures the Ultrafast Grid (UFG) for cross-browser and cross-device testing.

No parameter schema in public metadata yet.

eyes_inspect_sessionsLists a batch's sessions and batch-wide stats.

Lists a batch's sessions and batch-wide stats.

No parameter schema in public metadata yet.

eyes_inspect_stepsLists a session's steps: whether each is matching, plus baseline/checkpoint image and DOM IDs, sizes, and resolution status.

Lists a session's steps: whether each is matching, plus baseline/checkpoint image and DOM IDs, sizes, and resolution status.

No parameter schema in public metadata yet.

eyes_inspect_changed_areasReturns a step's diff regions, clustered from raw pixel-level differences and already accounting for any regions you've added.

Returns a step's diff regions, clustered from raw pixel-level differences and already accounting for any regions you've added.

No parameter schema in public metadata yet.

eyes_inspect_imageExports a baseline or checkpoint screenshot for a step, optionally cropped to a specific area.

Exports a baseline or checkpoint screenshot for a step, optionally cropped to a specific area.

No parameter schema in public metadata yet.

eyes_inspect_image_diffExports the checkpoint screenshot with changed areas highlighted.

Exports the checkpoint screenshot with changed areas highlighted.

No parameter schema in public metadata yet.

eyes_inspect_domExports a DOM capture for a step to a file, with a stable id assigned to every element.

Exports a DOM capture for a step to a file, with a stable id assigned to every element.

No parameter schema in public metadata yet.

eyes_inspect_dom_diffReturns the structural difference between a step's checkpoint and baseline DOM (only what actually changed).

Returns the structural difference between a step's checkpoint and baseline DOM (only what actually changed).

No parameter schema in public metadata yet.

eyes_inspect_dom_searchSearches a DOM capture using a predicate query language.

Searches a DOM capture using a predicate query language.

No parameter schema in public metadata yet.

eyes_inspect_evidenceReturns everything needed to review a step's changed areas in one call.

Returns everything needed to review a step's changed areas in one call.

No parameter schema in public metadata yet.

eyes_inspect_regionsReturns the match regions currently in effect for a step.

Returns the match regions currently in effect for a step.

No parameter schema in public metadata yet.

eyes_inspect_historyReturns a DOM node's diff history across prior runs.

Returns a DOM node's diff history across prior runs.

No parameter schema in public metadata yet.

eyes_review_progressDrives a guided investigation at whatever scope you ask for (a batch, a scenario, a session, or a single step).

Drives a guided investigation at whatever scope you ask for (a batch, a scenario, a session, or a single step).

No parameter schema in public metadata yet.

eyes_review_diff_reportRecords a structured finding for one changed area.

Records a structured finding for one changed area.

No parameter schema in public metadata yet.

eyes_review_endSummarizes and finalizes the investigation at the given scope, deduplicating every child finding into one clean summary.

Summarizes and finalizes the investigation at the given scope, deduplicating every child finding into one clean summary.

No parameter schema in public metadata yet.

eyes_resolve_checkpointMarks a step's checkpoint as accepted or rejected.

Marks a step's checkpoint as accepted or rejected.

No parameter schema in public metadata yet.

eyes_resolve_regionsAdds, removes, or updates a step's match regions, read against either the baseline or the checkpoint image/DOM.

Adds, removes, or updates a step's match regions, read against either the baseline or the checkpoint image/DOM.

No parameter schema in public metadata yet.

eyes_resolve_saveCommits every accepted/rejected step and every region change in the whole batch to the baseline.

Commits every accepted/rejected step and every region change in the whole batch to the baseline.

No parameter schema in public metadata yet.

eyes_resolve_resetRestores a session's or batch's baseline to the revision the test originally ran against, and clears any pending resolution decisions.

Restores a session's or batch's baseline to the revision the test originally ran against, and clears any pending resolution decisions.

No parameter schema in public metadata yet.

Sponsors

Readme

Applitools MCP Server

The Applitools MCP server helps you create, update, review, and resolve visual tests using Applitools Eyes across any of our supported SDKs.

It connects to AI assistants through the Model Context Protocol (MCP), letting tools like Cursor, GitHub Copilot, Cline, and Claude Code (and more) set up tests, add visual checkpoints, configure cross-browser testing, and investigate visual test failures (accepting, rejecting, or adjusting the changes behind them) without ever leaving your IDE.

To learn more, please visit our MCP documentation.

Purpose

This server is built for developers, testers, or QA working with AI-assisted workflows.

It enables your AI assistant to:

  • Understand your project configuration
  • Guide Eyes setup
  • Add visual checkpoints and suggest best practices
  • Investigate a batch, scenario, session, or step of visual test failures and tell you what changed, whether it's a bug, and why
  • Accept, reject, or adjust match regions for a checkpoint, with your explicit approval before anything is committed to baseline

View the full README on GitHub

Details

Repository
github.com/applitools/mcp
Website
applitools.com
Package
@applitools/mcp
Transport
STDIO
Registry
MCP registry, active