@opennous/mcp 0.50.0 → 0.51.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "description": "Nous — the Context Graph for AI Agents.",
   "license": "Apache-2.0",
   "repository": {

package/src/server.js

@@ -16,7 +16,7 @@
  *           search_notes · list_notes · get_foundation · get_insights
  *   WRITE   record · record_signal · save_note · propose_vault_file · merge_contacts ·
  *           sync_foundation
- *   ACT     send_linkedin_message
+ *   ACT     draft_email · send_linkedin_message
  *   CORRECT retract_observation · delete_note · unmerge_contacts
  *   RUN     get_workspace_status · whoami · list_integrations · set_workspace_profile ·
  *           build_icp_model · train_icp_model · sync_icp · export_icp_model ·
@@ -28,7 +28,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { get, post, del } from "./client.js";
 
-export const SERVER_VERSION = "0.50.0";
+export const SERVER_VERSION = "0.51.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -1639,6 +1639,43 @@ export function createServer() {
     }
   );
 
+  server.tool(
+    "draft_email",
+    "DRAFT a follow-up email for the operator to review and SEND themselves — you draft, they send. " +
+    "This does NOT send: it puts a card in front of the operator with To / Subject / Body and a Send " +
+    "button; the email goes out from THEIR OWN Gmail, in their name, only when they click send. Use it " +
+    "whenever the ask is to email, follow up by email, send a recap, or reply by email. Identify the " +
+    "recipient with `focus` (their email, LinkedIn URL, entity id, or name); the recipient address is " +
+    "read off the record unless you pass `to`. Write a real `subject` and `body` in the operator's " +
+    "voice — real paragraphs, no placeholders or [brackets] — and give the `rationale`, the one line " +
+    "they judge the draft against. For a LinkedIn-only contact with no email, use send_linkedin_message.",
+    {
+      focus: z.string().describe("The recipient — email, LinkedIn URL, entity UUID, or name."),
+      subject: z.string().describe("The email subject line."),
+      body: z.string().min(1).describe("The email body, in the operator's voice. Real paragraphs, no placeholders."),
+      to: z.string().optional().describe("Override the recipient email address (else the entity's best email on record is used)."),
+      rationale: z.string().optional().describe("One line on what the draft is based on — shown to the operator on the card."),
+    },
+    async ({ focus, subject, body, to, rationale }) => {
+      try {
+        const r = await post("/v2/drafts/email", { focus, subject, body, to, rationale });
+        if (r.status === "ambiguous") {
+          const opts = (r.candidates ?? []).map(c => `  • ${c.name ?? "(unnamed)"}  [${c.entity_id}]`).join("\n");
+          return { content: [{ type: "text", text: `"${focus}" matches several people. Re-call draft_email with one of these entity ids as focus:\n${opts}` }] };
+        }
+        return { content: [{ type: "text", text:
+          `Email draft ready for ${r.recipient} <${r.to}> — it's in front of the operator to review and send from their own Gmail. You have not sent it.` }] };
+      } catch (e) {
+        const msg = /no_email/.test(e.message)
+          ? "No email on file for that person. Ask the operator for the address (pass it as `to`), or draft a LinkedIn message instead."
+          : /entity_not_found/.test(e.message)
+          ? "Couldn't find that recipient on the record — check the focus identifier."
+          : `Couldn't create the draft: ${e.message}`;
+        return { content: [{ type: "text", text: msg }] };
+      }
+    }
+  );
+
   // ===========================================================================
   // TOOLS: the CORRECTION layer — unsay something recorded by mistake. `record` and
   // `save_note` are how you write; these are how you take it back. Both heal the