Optional: drive GuruWatcher from Claude / Cursor (MCP)

Skip this unless you already use Claude or Cursor

The product is the Mac/Windows app + Control Panel. Open the app → Load sample → Run once (safe) → Discord webhook → Keep checking. You do not need Claude, Cursor, or MCP for any of that.

MCP is optional — an extra for people who already drive tools from Claude Desktop or Cursor. Packaged-app buyers can ignore this page.

Install the optional extra

The stdio MCP server is a pip extra so the base zip stays light. From a source checkout (not required for the DMG / Windows zip):

pip install -e '.[mcp]'          # from a checkout
# or:  pip install 'guru-watcher[mcp]'

Without the extra, python3 -m guru_watcher mcp prints a clear pip install 'guru-watcher[mcp]' message instead of crashing.

Point Claude Desktop or Cursor at it

Stdio JSON, e.g. Claude Desktop’s ~/.claude.json or your Cursor MCP config:

{
  "mcpServers": {
    "guru-watcher": {
      "command": "python3",
      "args": ["-m", "guru_watcher", "mcp"],
      "env": { "GURU_WATCHER_DATA": "/absolute/path/to/gw-data" }
    }
  }
}

GURU_WATCHER_DATA is optional — without it the server uses ~/.guruwatcher.

Tools

• status — data dir, webhook yes/no, watch counts (never the URL)
• watches_list — armed / triggered watches
• drop_list / drop_put / drop_delete — drop folder
• run_once — ingest → reconcile → check once (dry-run or live)
• serve_status / serve_start / serve_stop — Keep checking
• webhook_status / webhook_set / webhook_clear

Webhook last-4 secret rule

Status tools never echo the full Discord webhook URL. They report configured plus the last 4 characters only (same rule as the Control Panel). Do not paste a live webhook into chats, tickets, or screenshots.

Next

Back to Guides, or the Setup guide. First hour still starts at Open the Control Panel.