Skip to content
MCP server

Witness

Records your voice and a browser session, then hands agents a causal evidence package

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.6.3
Listing updated
3 days ago

About Witness

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

The idea is to talk while you use your own product and let the recorder attach proof to each remark. One command, wit start with a dev URL, opens a managed browser and runs three streams at once: your speech with live transcription, every click with about 1.8 seconds of requests, responses, console errors and DOM changes afterwards, and a full rrweb DOM replay with screenshots. A click that produces no aftermath is itself logged as a dead click.

The result lands in a local .witness/sessions folder with a review.html for people and PROMPT.md, session.md and events.jsonl for agents. Running wit mcp turns the session into a stdio MCP server with 12 registered tools, so an agent can ask for just the evidence it needs. Nothing is uploaded and no account is required; the README describes it as MIT licensed.

It needs Node 18+ and Edge or Chrome, and installs from npm as witness-recorder.

Install

Run in a terminal

claude mcp add witness -- npx -y witness-recorder

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "witness": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "witness-recorder"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "witness": {
      "command": "npx",
      "args": [
        "-y",
        "witness-recorder"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "witness": {
      "command": "npx",
      "args": [
        "-y",
        "witness-recorder"
      ]
    }
  }
}

Tools this server provides (9)

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

list_says
Lists the spoken fragments in a session.
events_around
Returns events around a point in the timeline.
get_dom_state
Returns the page's DOM state.
get_errors
Returns errors captured in the session.
get_shot
Returns a screenshot from the session.
get_body
Returns a captured request or response body.
session_md
Returns the session timeline document.
get_asr
Reads the speech transcript.
set_asr
Updates the speech transcript.

What it does

Voice-anchored timeline
Attaches each spoken fragment to the clicks, requests and errors from that moment.
Dead click capture
Records clicks that cause nothing as evidence rather than dropping them.
DOM replay
Embeds an rrweb replay with screenshots and periodic snapshots.
Queryable session
Serves the session through a stdio MCP server instead of one large dump.
Local-first storage
Keeps everything on disk with no account or upload.
Pause for privacy
Freezes all events and audio when you press P.

Good for

  • Report a visual bug by talking through it once
  • Hand an agent the causal evidence behind a broken button
  • Review a design or motion pass with spoken notes attached to the page state
  • Collect several issues in one recording session

Pricing

Open source

MIT licensed, free to install from npm

Prices change. Check witness.zalize.com before you buy.

Witness FAQ

What do I need installed?

Node 18+ and a system Edge or Chrome; it falls back to bundled Chromium. Install with npm i -g witness-recorder.

Does anything leave my machine?

The README says sessions stay in .witness/sessions on your disk. Some commands re-run cloud ASR or an LLM, so check those settings.

Is it open source?

The comparison table on the site lists it as MIT.

How does an agent read the evidence?

Either paste PROMPT.md, or run wit mcp so the agent queries the session over stdio.

Is Witness free?

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

How do I add Witness to Claude Code?

Run this command in your terminal: claude mcp add witness -- npx -y witness-recorder

What are the best alternatives to Witness?

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

Alternatives to Witness

  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