Vibe Test — Browser Testing Agent — Claude Code MCP server
An MCP server that equips coding editors with 14 Playwright tools, extracts routes directly from your project files, and spots UI regressions between runs without extra model calls.
claude mcp add vibe-testing -- npx -y vibe-testingWhat Vibe Test — Browser Testing Agent does
The server equips AI editors with 14 Playwright actions designed for browser automation. Instead of operating blindly, it parses local application files to identify authentic endpoints, form selectors, and handlers. You avoid drafting static test scripts by hand.
Test runs write snapshots to .vibe/run-snapshot.json and keep track of application URLs in .vibe/route-manifest.json. Comparing snapshots alerts the agent to fresh regressions, repaired pages, or route alterations after every commit. Pass and fail decisions rely on deterministic checks like URL switches, toaster popups, and failed network calls, avoiding extra token costs.
Running this MCP server requires Node.js 20 or newer, alongside the Playwright Chromium build installed via setup.
What it helps with
- run automated browser interactions through 14 Playwright tools
- detect regressions and fixed pages across consecutive testing runs
- extract real routes and input selectors from repository source files
- generate visual HTML inspection reports with step-by-step screenshots
Example prompts for the agent
- Scan this codebase and test the login flow on http://localhost:3000.
- Check what broke in the checkout sequence after the latest commit.
- Explore the admin routes and generate an HTML report with screenshots.
How to install Vibe Test — Browser Testing Agent
Platform CLI
claude mcp add vibe-testing -- npx -y vibe-testingPlatform CLI
codex mcp add vibe-test-browser-testing-agent -- npx -y vibe-testingConfig file
{
"mcpServers": {
"vibe-test-browser-testing-agent": {
"command": "npx",
"args": [
"-y",
"vibe-testing"
]
}
}
}Config file
{
"servers": {
"vibe-test-browser-testing-agent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vibe-testing"
]
}
}
}Platform CLI
gemini mcp add vibe-test-browser-testing-agent npx -y vibe-testingStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Vibe Test — Browser Testing Agent
How do I install Vibe Test — Browser Testing Agent in Claude Code?
Run claude mcp add vibe-test-browser-testing-agent -- npx -y vibe-testing in your terminal. You can also run npx vibe-testing@latest init to detect your editor and configure the environment.
What does Vibe Test — Browser Testing Agent do?
It provides 14 Playwright tools to AI editors, analyzes local source code to find routes and inputs, and flags regressions across browser runs.
Does the server require an external AI API key?
No external API key is needed because verification uses browser heuristics such as URL updates and toast elements. Your coding editor model handles all reasoning.
