@opennous/mcp 0.49.0 → 0.50.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.49.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 · 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.50.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -1694,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