@agenticmail/mcp 0.9.7 → 0.9.8

package/dist/index.js

@@ -22672,6 +22672,7 @@ var TOOL_SETS = {
   /** Mail-server setup / onboarding wizards. */
   setup: [
     "setup_guide",
+    "setup_operator_email",
     "setup_email_relay",
     "setup_email_domain",
     "setup_gmail_alias",
@@ -23137,6 +23138,17 @@ var toolDefinitions = [
       required: ["name"]
     }
   },
+  {
+    name: "setup_operator_email",
+    description: 'Save the operator\'s notification email address for bridge-escalation alerts. When sub-agents mail a host bridge (e.g. `wake: ["codex"]`) AND no fresh host session is available for a headless resume, the dispatcher forwards a digest to this address so the operator gets a phone push (via Gmail / Apple Mail / whichever app handles their address). Master-key scoped. The host agent should call this during bootstrap after asking the operator: "what email should we alert you at when sub-agents need your attention?" \u2014 the answer is typically the operator\'s personal Gmail with mobile push enabled. Idempotent: re-running with a new address updates the config.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        email: { type: "string", description: "Operator notification email (e.g. ope@gmail.com). Pass `null` or an empty string to clear an existing setting." }
+      },
+      required: ["email"]
+    }
+  },
   {
     name: "setup_email_relay",
     description: "Configure Gmail/Outlook relay for sending real internet email (requires master API key). BEGINNER-FRIENDLY: Just needs a Gmail/Outlook email + app password. Agents send as user+agentname@gmail.com. Automatically creates a default agent (secretary) unless skipped. Best for: quick setup, personal use, no domain needed.",
@@ -24275,6 +24287,20 @@ ${r.messages.map((m) => `  UID ${m.uid} (${m.folder})`).join("\n")}`;
         hostTag ? `  Host: ${hostTag} (this account is owned by the ${hostTag} dispatcher)` : ""
       ].filter(Boolean).join("\n");
     }
+    case "setup_operator_email": {
+      const raw = args2.email;
+      const email2 = typeof raw === "string" ? raw.trim() : "";
+      const body = email2 ? { email: email2 } : { email: null };
+      const result = await apiRequest("PATCH", "/system/operator-email", body, true);
+      if (!email2) {
+        return "Operator escalation email cleared. Bridge alerts will still be recorded as system events but no email forward will be sent.";
+      }
+      return [
+        `\u2713 Operator escalation email set to ${result?.email ?? email2}.`,
+        `When sub-agents mail a bridge inbox and no fresh host session is available for a headless resume, the dispatcher will email this address with a digest so you get a phone push.`,
+        `Re-run setup_operator_email with a new address any time to update.`
+      ].join("\n");
+    }
     case "setup_email_relay": {
       const result = await apiRequest("POST", "/gateway/relay", {
         provider: args2.provider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/mcp",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "mcpName": "io.github.agenticmail/mcp",
   "description": "MCP server for AgenticMail — give any AI client real email and SMS capabilities",
   "type": "module",
@@ -30,7 +30,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.24.0",
-    "@agenticmail/core": "^0.9.5"
+    "@agenticmail/core": "^0.9.6"
   },
   "devDependencies": {
     "tsup": "^8.4.0",