How to Use the Applitools MCP in Windsurf

Q: How does Windsurf Cascade run Applitools audits?

Cascade plans a multi-step sequence using listbatches and getbatchstats. It gathers your Applitools visual test statuses, identifies unresolved failures, and presents the exact visual diff statistics in your Windsurf editor panel.

Q: Can I delete failed Applitools batches directly from Windsurf?

Yes, Cascade uses the deletebatch tool to remove entire Applitools test runs. Be careful with this command because it's going to permanently delete the batch data from your history.

Q: How do I set up this Applitools integration in Windsurf?

Open your mcpconfig.json file in Windsurf and add the server configuration under the MCP Server key. Cascade automatically discovers the Applitools visual testing tools once you hit refresh.

Q: Can I check Applitools visual branches with Windsurf?

Yes, your Windsurf agent uses listbranchbaselines to check branch-specific visual states in Applitools. This lets you verify layouts on feature branches before merging them.

Let Cascade run visual test audits and prune outdated baselines directly inside your Windsurf editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Applitools MCP to Windsurf

Create your Vinkius account to connect Applitools to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Applitools with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-analyze Applitools runs with Windsurf Cascade

Windsurf uses `list_batches` to fetch your recent Applitools visual test runs and spot failed builds without you leaving the editor. Cascade takes the batch IDs, pulls the Applitools numbers via `get_batch_stats`, and decides if a run needs a deeper look. Instead of clicking through a web UI, you don't have to leave your editor to find broken Applitools builds using this MCP Server. Cascade chains these tools to flag unresolved steps, giving you a quick summary of visual diffs right in your Windsurf workspace.

Clean up stale visual baselines in Windsurf

The `list_baselines` tool lets your Windsurf editor scan active Applitools configurations to find outdated UI layouts. When you redesign a component, Cascade can run this check, compare it against your active branch using `list_branch_baselines`, and pinpoint exactly which visual states are stale. Once Cascade identifies the dead layouts, it invokes `delete_baseline` to purge them from Applitools. This keeps your Windsurf visual regression suite accurate without manual cleanup.

Inspect specific visual failures using this MCP Server

When an Applitools build fails, `get_session` pulls the exact visual differences and execution details for a failed test run into Windsurf. Cascade reads these session details alongside your local workspace code to find the exact layout change that triggered the visual mismatch. By combining `list_results` with local file context, Windsurf pinpoints the exact line of code causing the Applitools visual regression. You get a clear picture of why a button shifted or an image broke.

Setup guide

Set up Applitools MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Applitools MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Applitools payment history." If connected, Cascade will call the Applitools tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "applitools-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Applitools. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Applitools now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Applitools MCP in Windsurf

Cascade plans a multi-step sequence using `list_batches` and `get_batch_stats`. It gathers your Applitools visual test statuses, identifies unresolved failures, and presents the exact visual diff statistics in your Windsurf editor panel.

Yes, Cascade uses the `delete_batch` tool to remove entire Applitools test runs. Be careful with this command because it's going to permanently delete the batch data from your history.

Open your `mcp_config.json` file in Windsurf and add the server configuration under the MCP Server key. Cascade automatically discovers the Applitools visual testing tools once you hit refresh.

Yes, your Windsurf agent uses `list_branch_baselines` to check branch-specific visual states in Applitools. This lets you verify layouts on feature branches before merging them.

Your Applitools API key is never stored on Vinkius; it resides in your local Windsurf environment. The `validate_key` tool runs inside an isolated sandbox, ensuring your visual test configurations and baseline data remain completely private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript