plannotator

MCP server for AI plan review and code review with annotated feedback.

Submit plans for human review before execution. Get structured feedback with inline annotations.

Installation

Zero-install (recommended)

npx plannotator

Global install

npm install -g plannotator

Usage

stdio transport (Claude Desktop, VS Code)

plannotator
# or
npx plannotator

HTTP/SSE transport

plannotator --transport=http
plannotator --transport=http --port=8080

Remote mode (devcontainers, SSH)

plannotator --remote
# Uses fixed port, skips browser auto-open

CLI Flags

| Flag | Description | Default | | ----------------------- | ---------------------------------------- | ------- | | --transport=stdio|http| Transport type | stdio | | --port=NUMBER | Port for HTTP transport | 19434 | | --remote | Remote mode (fixed port, no browser) | false | | --browser=PATH | Custom browser to open plans in | — | | --version, -v | Print version and exit | — | | --help, -h | Print usage and exit | — |

Environment Variables

| Variable | Description | | --------------------- | --------------------------------------------------------------------------- | | PLANNOTATOR_REMOTE | Set to 1 for remote mode (devcontainer, SSH). Uses fixed port, no browser | | PLANNOTATOR_PORT | Fixed port number. Default: random locally, 19432 for remote sessions | | PLANNOTATOR_BROWSER | Custom browser to open plans in. macOS: app name. Linux/Windows: exe path |

MCP Client Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "plannotator": {
      "command": "npx",
      "args": ["plannotator"]
    }
  }
}

VS Code MCP

Add to .vscode/mcp.json:

{
  "servers": {
    "plannotator": {
      "type": "stdio",
      "command": "npx",
      "args": ["plannotator"]
    }
  }
}

MCP Tools

• submit_plan — Submit plan markdown for user review
• get_plan_status — Poll for user's decision (approved/denied + feedback)
• submit_review — Submit git diff for code review
• get_review_status — Poll for review feedback
• save_plan — Save plan to disk
• share_plan — Generate compressed shareable URL

Requirements

• Node.js >= 18

License

FBSL-1.0 — FredonBytes Source License