Pro feature

MCP Setup

VoiceDOM connects to your AI coding agent over the Model Context Protocol. Point at any element on a page, leave a voice note, and your agent gets exactly what you meant — the CSS selector, XPath, page URL, and your transcribed note. You don't install the server manually. Point your MCP client at npx voicedom-mcp and it runs on demand.

Two ways to use it

1 · Read

Read what you've captured. Annotate pages in the browser whenever you like; your agent reads the current set with read_annotations.

2 · Live

Interactive sessions. Tell your agent "open this on voicedom". It opens the page in your browser and starts a session — you point and talk, click Send to MCP, and the agent receives exactly the notes from that session. No copy-paste.

Requirements: Node.js 18+ and the VoiceDOM extension running in your browser.

1. Connect your agent

Claude Code

claude mcp add voicedom -- npx -y voicedom-mcp

Or add it to ~/.claude.json:

json

{
  "mcpServers": {
    "voicedom": {
      "command": "npx",
      "args": ["-y", "voicedom-mcp"]
    }
  }
}

Cursor / VS Code

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

json

{
  "mcpServers": {
    "voicedom": {
      "command": "npx",
      "args": ["-y", "voicedom-mcp"]
    }
  }
}

OpenAI Codex CLI

Add to ~/.codex/config.toml:

toml

[mcp_servers.voicedom]
command = "npx"
args = ["-y", "voicedom-mcp"]

2. Enable interactive sessions

So your agent can open a page and start a session for you, turn it on once:

VoiceDOM Options → MCP & Help → Enable AI-opened sessions.

This grants access to localhost pages only, requested at that moment — so a fresh install carries no broad permission warning. (read_annotations works without this step.)

3. Use it

Annotate in the browser and ask your agent to read:

Use the voicedom annotations to fix the elements I marked.

Or run a live session:

Open localhost:3000 on voicedom and wait for my notes.

Your agent opens the tab, you point + talk + click Send to MCP, and it picks up your notes automatically.

Tools

Tool	What it does
`read_annotations`	Returns all captured annotations as JSON (selector, XPath, URL, title, note). Optional `hostname` filters to one site.
`open_session`	Opens a `url` in your browser and starts an annotation session. Usually your local dev server.
`wait_for_session`	Blocks until you click Send to MCP, then returns the notes from that session. Optional `timeoutMs` (default 5 min).

Don't have VoiceDOM yet?

The MCP server is included in Pro — $19 lifetime, no subscription.

Add to Chrome