# Vibe Test — Browser Testing Agent MCP server

Code-aware browser testing agent — 14 Playwright tools for AI code editors via MCP

## At a glance

Vibe Test — Browser Testing Agent is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y vibe-testing`, and declares no required credentials. It exposes 17 tools, including configure, scan_codebase and get_context. It scores A (88/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install Vibe Test — Browser Testing Agent in Claude Code

1. Add the server

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

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. configure, scan_codebase, get_context). It discovers them automatically.

### How to install Vibe Test — Browser Testing Agent in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

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

3. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install Vibe Test — Browser Testing Agent in Cursor

1. Create / edit .cursor/mcp.json in your project

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

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install Vibe Test — Browser Testing Agent in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.vibe-testing]
command = "npx"
args = ["-y", "vibe-testing"]
```

2. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install Vibe Test — Browser Testing Agent in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

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

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install Vibe Test — Browser Testing Agent in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

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

### How to install Vibe Test — Browser Testing Agent in VS Code

1. Create .vscode/mcp.json

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

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `configure` — Start here on a new project. Detects framework, server, and authentication
- `scan_codebase` — Always first. Reads source code, finds routes/forms/tests/gaps
- `get_context` — Before writing test steps. Returns source files for a feature
- `login` — When app requires authentication
- `scan_page_elements` — To see all interactive elements on a page
- `explore_page` — Broad "does everything work?" testing
- `execute_scenario` — Run specific test steps
- `get_coverage` — View coverage map and untested routes
- `suggest_tests` — Find coverage gaps after exploration
- `take_screenshot` — Quick visual verification
- `generate_report` — Build HTML report (auto-opens)
- `run_full_test` — One-shot: scan, execute, explore, report
- `run_converge` — Iterative testing until thresholds
- `cleanup` — Close browsers, free resources
- `selector` — the target must be visible. CSS, `text=`, `label=`, and
- `value` — visible text must contain this string, on the selected element or on
- `url` — the current URL must exactly match this absolute URL or path resolved

Source repository: https://github.com/AishwaryShrivastav/vibe-testing

---

Source: https://mcp-skills-hub.vercel.app/mcps/io-github-aishwaryshrivastav-vibe-testing · MCP Skills Hub · data as of 2026-10-28T12:31:05Z