Name: Vibetest Use
Author: browser-use

LABSCO SUMMARY

A QA sweep you can ask for in one sentence.

The agent count is the only dial that matters: three for a quick look, ten when you want the site properly walked — and either way the request is a sentence, not a test suite you have to write first.

What it is

An MCP server that launches multiple browser-use agents in parallel against a URL and reports the technical problems they find. It is aimed at sites that were put together quickly and never systematically tested.

What you get

A QA pass run by several agents at once, looking for UI bugs, broken links, accessibility issues and other technical problems
Both live websites and local development servers as targets — https://example.com and localhost:3000 are equally valid
Control over thoroughness by agent count: 3 by default, more agents meaning a more thorough sweep
A choice of headless or non-headless runs, with non-headless the default so you can watch

Requirements

Python 3.11+, and a Google API key for the gemini-2.0-flash model that drives the agents. Set up with uv venv, uv pip install -e . and playwright install chromium --with-deps --no-shell. In Claude Code, register it with claude mcp add vibetest <YOUR_PATH_TO_VIBETEST_USE>/.venv/bin/vibetest-mcp -e GOOGLE_API_KEY="<YOUR_GOOGLE_API_KEY>"; in Cursor, point the command at the same vibetest-mcp binary and put the key in the env block. Built on the browser-use agent framework.

Setup effort

Build from source — git clone https://github.com/browser-use/vibetest-use.git

See installation options

USE CASES

01

Checking a site you built fast

Ask for a run against the URL and get back UI bugs, broken links and accessibility problems, without writing a single test case.

02

Testing before it goes live

Point it at localhost on whatever port your dev server uses; the agents treat it the same as a public site.

03

Deciding how deep to go

Three agents for a quick pass, ten when you want the site properly covered — the count is stated in the request itself.

04

Running it in the background

Ask for a headless run when you do not want browser windows opening on your desktop.

BEFORE YOU INSTALL

What to know first

Requires

uv on PATH
Python 3.11+
GOOGLE_API_KEY in your environment

INSTALLATION

Connect your client

Server setup

TERMINAL

git clone https://github.com/browser-use/vibetest-use.git
cd vibetest-use
uv venv
source .venv/bin/activate
uv pip install -e .
playwright install chromium --with-deps --no-shell

MCP Clients

Claude Code

CLAUDE CODE · TERMINAL

claude mcp add vibetest <YOUR_PATH_TO_VIBETEST_USE>/.venv/bin/vibetest-mcp -e GOOGLE_API_KEY="<YOUR_GOOGLE_API_KEY>"

<YOUR_PATH_TO_VIBETEST_USE> is the full path of the folder you cloned (run pwd inside it).

Cursor

CURSOR · JSON

{
  "mcpServers": {
    "vibetest": {
      "command": "<YOUR_PATH_TO_VIBETEST_USE>/.venv/bin/vibetest-mcp",
      "env": {
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>"
      }
    }
  }
}