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

All without requiring manual, error-prone steps, or leaving your IDE.

Who is this for?

• Engineers new to Applitools Eyes who haven't installed or implemented the Eyes SDK
• Existing Eyes SDK users who want to use the MCP server to add Ultrafast Grid coverage (cross-browser and device testing), convert existing tests into visual tests using Applitools visual AI, or retrieve and analyze visual test results
• Teams triaging visual test failures at scale
  • Who want an AI assistant to investigate a batch of failing tests, gather evidence, and tell them exactly what changed and whether it needs attention, instead of clicking through the Eyes dashboard test by test

Requirements & Limitations

• Node.js 18 or newer
• VS Code, Cursor, Claude Code, Cline, or any other MCP client assistant
• The setup and checkpoint tools (eyes_setup_project, eyes_setup_ufg, eyes_add_checkpoints_to_test) support only our Playwright Fixtures SDK. Support for additional SDK frameworks is coming soon!
  • Use the latest versions of Playwright, Node.js, and our Playwright JavaScript Fixtures SDK
  • Requires access to your project's source code (for the setup and checkpoint tools)
• The Inspection, Resolution, and Review tools (eyes_inspect_*, eyes_resolve_*, eyes_review_*) work with any Eyes test results, regardless of which SDK or language produced them, as they operate on already-captured batch, session, and DOM data
  • These tools require additional separate read and write API keys

Installation

Recommended: VS Code Extension or Cursor MCP Install

The easiest way to start using Eyes MCP is through the Applitools VS Code extension or by installing the MCP server directly in Cursor.

• Runs the MCP server automatically
• Connects it to Copilot or Cursor's AI assistant
• Provide context-aware code edits
• Surface visual test results inside your IDE or MCP client CLI of choice

Simply install the MCP server by clicking an option below:

Alternatively, you can install the server manually by following the Manual Setup section below.

Manual Setup

If you prefer not to use the extension, you can install the MCP server manually by following the examples below.

Standard MCP configuration:

{
  "mcpServers": {
    "applitools-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["--yes", "@applitools/mcp@latest"]
    }
  }
}