Skip to main content
MCP server CX Codex

ghost-qa — Claude Code MCP server: browser QA and setup

The ghost-qa MCP server for Claude Code and Codex checks a running web app in a browser. It visits internal routes and reports runtime, network, and layout issues.

MIT ★ 50 updated 2026-11-14

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add ghost-qa -- npx -y ghost-qa
Open on GitHub

What ghost-qa does

ghost-qa launches a headless browser, visits internal routes in a running app, and tests interactive controls. Its checks cover three viewport sizes in both light and dark themes. The server catches JavaScript errors, failed requests, and layout problems, then returns a diagnostic report with selectors for fixes.

After changes, the check can run again; compare two runs with ghost-qa compare before.json after.json. It requires Node.js 20 or newer, a running app server, and Chromium. Install the browser with npx playwright install chromium. Without a running app, ghost-qa has no pages to inspect.

What it helps with

  • catch JavaScript errors while pages load
  • find failed API requests and broken assets
  • check layouts across viewport sizes
  • compare QA results before and after changes

Example prompts for the agent

  • Check the app at http://localhost:3000 and report browser issues.
  • Run the browser check again after my changes.
  • Compare before.json with after.json and report new regressions.

How to install ghost-qa

Platform CLI

claude mcp add ghost-qa -- npx -y ghost-qa

Step 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 ghost-qa

How do I install ghost-qa in Claude Code?

Run claude mcp add ghost-qa -- npx -y ghost-qa.

What does ghost-qa do?

It checks a running web app in a browser, visits internal routes, and reports runtime, network, and layout problems.

What does ghost-qa need to run?

It needs Node.js 20 or newer, a running app server, and Chromium. Install Chromium with npx playwright install chromium.

Similar MCP servers

All MCP servers for Testing and QA →

Project sponsors

Companies that keep this analytics open