# QA Wrap bridge

> QA Wrap bridge is an open-source MCP server for developer tools. Let a coding agent read QA Wrap browser test sessions and failures, locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Chrome extension, macOS, Windows, Linux
- **Website:** https://nj-burrito.github.io/QA-Wrap/
- **Repository:** https://github.com/nj-burrito/qa-wrap/tree/HEAD/helper
- **MCP Registry name:** io.github.NJ-Burrito/qa-wrap-bridge
- **Categories:** developer tools, browser automation
- **Listing updated:** 2026-11-15

## About

QA Wrap is a free MIT-licensed browser extension that records a manual test session and links each failing request or console error to the click that preceded it. This bridge lets an agent such as Claude Code or Cursor read what the extension holds, so the agent can see failures with their causes.

It works through two parts: a stdio MCP server started by the agent, and a native messaging host started by Chrome or Edge. Setup is npx qa-wrap-bridge once, then switching on Agent bridge in QA Wrap's Settings, which asks for a single nativeMessaging permission. It needs Node 20 or later and is optional.

The README is explicit about limits. The four tools are read-only. The host uses a local socket, opens no outgoing connection, and authenticates with a private key file. Answers are masked for passwords, tokens, keys and cards, request and response bodies are never included in full, and output is shortened to fit the browser's 1 MiB limit.

## Features

- **List sessions:** Shows recorded sessions on this machine, newest first.
- **Read one session:** Returns a session in the documented qawrap.session/1 format.
- **Failures only:** Returns failing requests and console errors, with duplicates folded.
- **AI brief:** Provides the compact text block the extension produces for AI.
- **Local only:** No network connections; communication is over a local socket.
- **Masked output:** Passwords, tokens, keys and card numbers are masked.

## Good for

- Have an agent diagnose a failure from a recorded test
- Turn a failing request into a fix suggestion
- Summarise a QA session for a developer
- Compare failures across recent sessions

## Install

### Claude Code (Terminal)

```sh
claude mcp add qa-wrap-bridge -- npx -y qa-wrap-bridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "qa-wrap-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "qa-wrap-bridge"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "qa-wrap-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "qa-wrap-bridge"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "qa-wrap-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "qa-wrap-bridge"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "qa-wrap-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "qa-wrap-bridge"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "qa-wrap-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "qa-wrap-bridge"
      ]
    }
  }
}
```

## Tools

- `list_sessions`: Sessions on this machine, newest first, with counts and status.
- `get_session`: One session in the qawrap.session/1 format.
- `get_failures`: Only the failures of a session.
- `get_ai_brief`: The compact plain-text block produced by Copy for AI.

## FAQ

### Is it required to use QA Wrap?

No. The bridge is optional and off until you turn on Agent bridge.

### Can it change my sessions?

No. The four tools are read-only and nothing can write or delete.

### Does it use the network?

No; it listens on a local pipe or unix socket and makes no outgoing connection.

### What Node version is needed?

Node 20 or newer.

### Is QA Wrap bridge free?

Yes. QA Wrap bridge is open source, so you can use and self-host it for free.

### How do I add QA Wrap bridge to Claude Code?

Run this command in your terminal: claude mcp add qa-wrap-bridge -- npx -y qa-wrap-bridge

### What are the best alternatives to QA Wrap bridge?

The closest alternatives to QA Wrap bridge are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/qa-wrap-bridge
