@opennous/mcp 0.49.0 → 0.51.0

package/package.json

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

package/src/server.js

@@ -13,21 +13,22 @@
  * Tools, by group (the authoritative live catalog is `node scripts/list-tools.mjs`):
  *   READ    get_context · get_account · verify · query · attention · get_action_items ·
  *           pipeline · pipeline_intelligence · campaign_performance · score ·
- *           search_notes · get_foundation · get_insights
+ *           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 · set_workspace_profile · build_icp_model · train_icp_model ·
- *           sync_icp · export_icp_model · connect_integration · configure_crm_sync ·
- *           sync_crm_now · scrape_engagers · get_routing_preferences
+ *   RUN     get_workspace_status · whoami · list_integrations · set_workspace_profile ·
+ *           build_icp_model · train_icp_model · sync_icp · export_icp_model ·
+ *           connect_integration · configure_crm_sync · sync_crm_now · scrape_engagers ·
+ *           get_routing_preferences
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { get, post, del } from "./client.js";
 
-export const SERVER_VERSION = "0.49.0";
+export const SERVER_VERSION = "0.51.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -1638,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
@@ -1694,6 +1732,65 @@ export function createServer() {
     }
   );
 
+  // ===========================================================================
+  // TOOLS: list + introspect — enumerate what's on the workspace, and who you are.
+  // GET /v2/notes · /v2/workspace/integrations · /v2/workspace/members.
+  // ===========================================================================
+  server.tool(
+    "list_notes",
+    "List saved notes newest-first (chronological), optionally scoped to one person/company with " +
+    "`focus`. This is the LIST companion to search_notes (which is semantic): use it for \"show me the " +
+    "notes on X\", or to enumerate notes and get their ids — e.g. to pick one to delete_note. Returns " +
+    "id, type, title, date and a snippet for each.",
+    {
+      focus: z.string().optional().describe("Restrict to one person/company (email, LinkedIn URL, entity UUID, or domain). Omit for the whole workspace."),
+      limit: z.number().int().min(1).max(100).optional().describe("Max notes to return (default 20)."),
+    },
+    async ({ focus, limit }) => {
+      const r = await get("/v2/notes", { ...(focus ? { focus } : {}), ...(limit ? { limit } : {}) });
+      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 — re-call list_notes with one of these entity ids as focus:\n${opts}` }] };
+      }
+      if (!r.notes?.length) return { content: [{ type: "text", text: focus ? "No notes on that account." : "No notes saved yet." }] };
+      const lines = r.notes.map(n => `  • ${n.title || n.type}${n.date ? ` (${n.date})` : ""}  [${n.id}]\n    ${n.snippet}`).join("\n");
+      return { content: [{ type: "text", text: `${r.notes.length} note(s)${r.has_more ? " (more available — raise limit)" : ""}:\n${lines}` }] };
+    }
+  );
+
+  server.tool(
+    "list_integrations",
+    "List the integrations connected to this workspace (Gmail, HubSpot, Apollo, Instantly, LinkedIn, …) " +
+    "— what's wired in and whether it's verified. Use before telling the user to connect something, or " +
+    "to answer \"what's connected here?\".",
+    {},
+    async () => {
+      const r = await get("/v2/workspace/integrations");
+      if (!r.integrations?.length) return { content: [{ type: "text", text: "No integrations connected yet." }] };
+      const lines = r.integrations.map(i => `  • ${i.display_name}${i.category ? ` (${i.category})` : ""}${i.verified ? "" : " — not verified"}`).join("\n");
+      return { content: [{ type: "text", text: `Connected integrations:\n${lines}` }] };
+    }
+  );
+
+  server.tool(
+    "whoami",
+    "Report who this API key acts AS and who else is on the workspace — the agent's own identity in " +
+    "Nous. Returns your scope (a MEMBER key sees only that member's private content plus the shared " +
+    "graph; an ADMIN key sees all raw content) and the team roster with names and roles. Use it to " +
+    "understand whose view you have and to reference teammates. Emails show only for an admin key.",
+    {},
+    async () => {
+      const r = await get("/v2/workspace/members");
+      const scope = r.you?.scope === "admin"
+        ? "an ADMIN key — you see all raw content on this workspace"
+        : "a MEMBER key — you see only your own private content plus the shared graph";
+      const roster = (r.members || [])
+        .map(m => `  • ${m.name || "(unnamed)"} — ${m.role}${m.you ? " (you)" : ""}${m.email ? ` · ${m.email}` : ""}`)
+        .join("\n");
+      return { content: [{ type: "text", text: `You are ${scope}.\n\nWorkspace members (${r.count ?? 0}):\n${roster || "  (none)"}` }] };
+    }
+  );
+
   // ===========================================================================
   // TOOL: get_routing_preferences
   // The routing preferences that make THIS agent default to Nous for GTM. The