# Vibe Test — Browser Testing Agent

> Vibe Test — Browser Testing Agent is an open-source MCP server for browser automation. Code-aware Playwright browser testing for AI coding editors, via MCP or CLI. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web, vscode, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/aishwaryshrivastav/vibe-testing
- **MCP Registry name:** io.github.AishwaryShrivastav/vibe-testing
- **Categories:** [browser automation](https://ai-powered.com/categories/browser-automation), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Vibe Test reads your project's source so its browser tests use real routes and form field names instead of guessed selectors. It then runs those tests in Playwright Chromium and keeps memory of earlier runs, so each new run can show what got fixed or broke since the last one.

It is delivered as an MCP server exposing 14 testing tools to editors such as Claude Code, Cursor, Windsurf, VS Code Copilot and Roo Code, and also as a standalone CLI. The README says the tool makes no LLM calls itself; the editor's model chooses what to test while the tool handles browsing and heuristic pass/fail checks.

The README describes it as aimed at developers who build with AI coding agents and want a repeatable regression check on their app. Source code is optional: pointed at a bare URL, it runs a black-box pass instead.

## Features

- **Source-aware scenario generation:** Scans routes, forms, and existing test suites to derive scenarios that use the app's actual field names.
- **Browser exploration:** Clicks through pages in Playwright and reports server errors, console errors, and broken values.
- **Run-to-run regression diff:** Stores a snapshot after each run and lists newly failing and newly passing routes.
- **Configurable safety limits:** Lets you block destructive actions and control whether exploration may change app data.
- **HTML reports with screenshots:** Generates a report with screenshots of each step and a summary of failed scenarios.

## Good for

- Check a web app for regressions after an AI-assisted code change
- Smoke-test a staging environment from the command line
- Find broken routes and console errors on a project without writing test cases
- Verify a specific bug fix through a real browser session

## Install

### Claude Code (Terminal)

```sh
claude mcp add vibe-testing -- npx -y vibe-testing
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vibe-testing": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-testing"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vibe-testing": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-testing"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vibe-testing": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vibe-testing"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vibe-testing": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-testing"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vibe-testing": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-testing"
      ]
    }
  }
}
```

## Tools

- `configure`: Detects framework, server, and authentication for a new project.
- `scan_codebase`: Reads source code and finds routes, forms, tests and gaps.
- `get_context`: Returns source files for a feature.
- `login`: Authenticates in a real browser.
- `scan_page_elements`: Lists interactive elements on a page.
- `explore_page`: Interacts with a page and reports problems.
- `execute_scenario`: Runs specific test steps.
- `get_coverage`: Shows coverage map and untested routes.
- `suggest_tests`: Finds coverage gaps and suggests scenarios.
- `take_screenshot`: Captures a screenshot of a URL.
- `generate_report`: Builds an HTML report.
- `run_full_test`: Scans, executes, explores and reports in one run.
- `run_converge`: Iterates testing until thresholds are met.
- `cleanup`: Closes browsers and frees resources.

## FAQ

### Does it call an LLM internally?

No. The README says verification is heuristic and the editor's model decides what to test.

### Which editors are supported?

The README lists Claude Code, Cursor, Windsurf, VS Code Copilot and Roo Code, plus Codex and Cline configuration examples.

### Does it need source code?

No. Given only a URL, it tests the app black-box, with lighter coverage than when source is available.

### Is Vibe Test — Browser Testing Agent free?

Yes. Vibe Test — Browser Testing Agent is open source, so you can use and self-host it for free.

### How do I add Vibe Test — Browser Testing Agent to Claude Code?

Run this command in your terminal: claude mcp add vibe-testing -- npx -y vibe-testing

### What are the best alternatives to Vibe Test — Browser Testing Agent?

The closest alternatives to Vibe Test — Browser Testing Agent are VibeView, Vibe Shipped, VibeKit, Playwright MCP and Momentic.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [VibeView](https://ai-powered.com/mcp/vibeview): VibeView is a freemium MCP server for developer tools.
- [Vibe Shipped](https://ai-powered.com/mcp/vibe-shipped): Vibe Shipped is a free MCP server for developer tools.
- [VibeKit](https://ai-powered.com/mcp/vibekit): VibeKit is a freemium MCP server for developer tools.
- [Playwright MCP](https://ai-powered.com/mcp/playwright-mcp): Playwright MCP is an open-source MCP server for browser automation.
- [Momentic](https://ai-powered.com/mcp/momentic): Momentic is a freemium MCP server for developer tools.
- [VibeRaven](https://ai-powered.com/mcp/viberaven-2): VibeRaven is a freemium MCP server for security.
- [VibeDoctor](https://ai-powered.com/mcp/vibedoctor): VibeDoctor is a freemium MCP server for security.
- [UI Verify](https://ai-powered.com/mcp/ui-verify): UI Verify is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/vibe-test-browser-testing-agent
