@ng-annotate/mcp-server

List all browser sessions connected to the dev server

Get a session and all its annotations

Get all pending annotations for a specific session

Startup step: get all pending annotations across all sessions, sorted oldest first. Call this on startup to drain annotations that arrived before the agent connected, then enter the watch_annotations loop.

Acknowledge a pending annotation (pending → acknowledged). Call this IMMEDIATELY after receiving an annotation and BEFORE reading any files or starting edits. This signals to the browser that the agent is working on it.

Mark an annotation as resolved. Call this ONLY after the file change has been successfully written to disk. Include a one-sentence summary of what was changed.

Dismiss an annotation as not actionable. Use when the request is out of scope, contradicts existing code, or cannot be safely implemented. A reason is required.

Add an agent reply to an annotation thread without resolving it. Use to ask for clarification when the request is ambiguous. Do NOT call resolve until the user has responded.

Propose a unified diff for the developer to review before applying. Transitions the annotation to diff_proposed status. Call this after acknowledge, before writing any files. Then call watch_diff_response to wait for developer approval or rejection.

Wait for the developer to approve or reject a proposed diff. Long-polls until the developer responds or the timeout is reached. Returns {status:"approved"|"rejected",annotation} or {status:"timeout"}. Default timeout is 5 minutes.

Long-poll for new pending annotations (polls every 500ms, default ${String(DEFAULT_WATCH_TIMEOUT_MS / 1000)}s timeout). Returns immediately if pending annotations already exist. This is the main event loop — call it again after processing annotations or on timeout, and keep calling it indefinitely. Result shape: {"status":"annotations","annotations":[...]} or {"status":"timeout"}.