@opennous/mcp 0.48.0 → 0.49.0

package/package.json

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

package/src/server.js

@@ -17,7 +17,7 @@
  *   WRITE   record · record_signal · save_note · propose_vault_file · merge_contacts ·
  *           sync_foundation
  *   ACT     send_linkedin_message
- *   CORRECT retract_observation · delete_note
+ *   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
@@ -27,7 +27,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.48.0";
+export const SERVER_VERSION = "0.49.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -406,12 +406,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.