@opennous/mcp 0.48.0 → 0.50.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.48.0",
+  "version": "0.50.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
- *   CORRECT retract_observation · delete_note
- *   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
+ *   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 ·
+ *           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.48.0";
+export const SERVER_VERSION = "0.50.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -406,12 +407,54 @@ export function createServer() {
         (r.relationships_repointed || r.relationships_removed)
           ? `  relationships: ${r.relationships_repointed} re-pointed, ${r.relationships_removed} pruned` : null,
         moved ? `  re-pointed: ${moved}` : null,
-        `The duplicate is now a reversible tombstone (merged into the survivor).`,
+        `Reversible: if this was wrong, unmerge_contacts with drop_id "${r.drop_id}" puts it all back.`,
       ].filter(Boolean);
       return { content: [{ type: "text", text: lines.join("\n") }] };
     }
   );
 
+  server.tool(
+    "unmerge_contacts",
+    "REVERSE a merge — split a wrongly-merged duplicate back out into its own account. Identify the " +
+    "merge to undo either by `drop_id` (the tombstone's id, exactly as merge_contacts reported it) or by " +
+    "`keep` (an identifier for the survivor — undoes the MOST RECENT merge into it). Every re-pointed " +
+    "identifier, claim, observation, relationship and the record itself go back where they were. " +
+    "Forward-only: it can only reverse merges made after reversible-merge tracking existed — an older " +
+    "merge returns a clear 'not reversible'. Use this when two DIFFERENT people were merged by mistake; " +
+    "it is not for editing a correctly-merged account.",
+    {
+      drop_id: z.string().optional().describe("The merged-away entity's id, from the merge_contacts result. Provide this OR keep."),
+      keep: z.string().optional().describe("The survivor (email, LinkedIn URL, entity UUID, or name) — undoes the most recent un-reversed merge into it."),
+    },
+    async ({ drop_id, keep }) => {
+      if (!drop_id && !keep) {
+        return { content: [{ type: "text", text: "Give me the drop_id from the merge result, or the `keep` survivor whose last merge to undo." }] };
+      }
+      try {
+        const r = await post("/v2/accounts/unmerge", { drop_id, keep });
+        if (r.status === "ambiguous") {
+          const opts = (r.candidates ?? []).map(c => `  • ${c.name ?? "(unnamed)"}  [${c.entity_id}]`).join("\n");
+          return { content: [{ type: "text", text: `"${keep}" matches several people. Re-call unmerge_contacts with one of these entity ids as keep:\n${opts}` }] };
+        }
+        const lines = [
+          `Un-merged — ${r.drop_id} is its own account again.`,
+          `  identifiers restored: ${r.identifiers}, claims: ${r.claims}, observations: ${r.observations}, relationships: ${r.relationships}`,
+          r.contact_restored ? `  the contact record was recreated.` : null,
+        ].filter(Boolean);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (e) {
+        const msg = /not_reversible/.test(e.message)
+          ? "That merge can't be reversed — it predates reversible-merge tracking, or it was already un-merged."
+          : /no_reversible_merge/.test(e.message)
+          ? "No un-reversed merge on that survivor to undo."
+          : /entity_not_found/.test(e.message)
+          ? "Couldn't find that survivor — check the keep identifier."
+          : `Couldn't un-merge: ${e.message}`;
+        return { content: [{ type: "text", text: msg }] };
+      }
+    }
+  );
+
   // ===========================================================================
   // TOOL: record  —  POST /v2/observations
   // The single write verb. You observe — Nous derives the updated facts.
@@ -1652,6 +1695,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