Skip to content
MCP server

QA Wrap bridge

Let a coding agent read QA Wrap browser test sessions and failures, locally

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Chrome extension, macOS
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About QA Wrap bridge

QA Wrap bridge is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "qa-wrap-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "qa-wrap-bridge"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "qa-wrap-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "qa-wrap-bridge"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free; QA Wrap is MIT licensed.

Prices change. Check nj-burrito.github.io before you buy.

QA Wrap bridge 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 to QA Wrap bridge

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools