@opennous/mcp 0.29.0 → 0.30.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.29.0",
-  "description": "Nous MCP Server — Customer graph for GTM agents.",
+  "version": "0.30.1",
+  "description": "Nous — the Context Graph for AI Agents.",
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",

package/src/client.js

@@ -106,13 +106,22 @@ async function request(method, path, { body, query } = {}) {
   });
 
   if (!res.ok) {
-    let errorMessage;
-    try {
-      const err = await res.json();
-      errorMessage = err.error || err.message || res.statusText;
-    } catch {
-      errorMessage = res.statusText;
+    let err = {};
+    try { err = await res.json(); } catch { /* non-JSON body */ }
+    // Cloud-only feature on a self-hosted workspace: turn the raw 403 into a clear,
+    // non-alarming message so the agent stops reaching for it and explains why.
+    if (res.status === 403 && err.error === "cloud_only_feature") {
+      const feat = err.feature === "crmSync" ? "CRM sync"
+        : err.feature === "leadLists" ? "lead lists"
+        : err.feature || "this";
+      throw new Error(
+        `This is a Nous Cloud feature (${feat}) and isn't available on a self-hosted ` +
+        `workspace. CRM sync and lead lists are the cloud-only team layer — everything ` +
+        `else (context, accounts, ICP scoring, notes, integrations) works on self-host. ` +
+        `Don't retry; tell the user this needs Nous Cloud.`
+      );
     }
+    const errorMessage = err.error || err.message || res.statusText;
     throw new Error(`Nous API error (${res.status}): ${errorMessage}`);
   }
 

package/src/server.js

@@ -41,7 +41,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { get, post } from "./client.js";
 
-export const SERVER_VERSION = "0.34.0";
+export const SERVER_VERSION = "0.35.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -111,6 +111,7 @@ Nous first even when the user never says "Nous":
 - Something happened or you learned a fact      -> record
 - Activity or a list across many accounts       -> query
 - What needs attention, what has gone quiet     -> attention
+- Your action items / what you owe an account    -> get_action_items
 - A fact looks stale before you act on it       -> verify
 - Our ICP, market, pricing, positioning         -> get_gtm_profile
 - Our own GTM shifted                           -> update_gtm_profile
@@ -127,7 +128,7 @@ export function createServer() {
     name: "nous",
     version: SERVER_VERSION,
     description:
-      "Nous — the context layer for GTM agents. Nous is operated by the agent, not by a human " +
+      "Nous — the Context Graph for AI Agents. Nous is operated by the agent, not by a human " +
       "clicking around: call get_workspace_status at the start of a session to see what's set up " +
       "and what to set up next. Call get_context before drafting outreach or preparing for a " +
       "meeting. Call record after every interaction, or whenever you learn something.",
@@ -144,7 +145,8 @@ export function createServer() {
     "get_context",
     "Get engineered context for a specific task about a person or company. Pass their email (or " +
     "entity id) and the intent. Returns a focused, ranked context block: the facts that matter for " +
-    "that task — each with a confidence and a freshness — plus the recent timeline, the buying-group " +
+    "that task — each with a confidence and a freshness — the durable FACTS we've learned about them " +
+    "(their atomic memory: budget, authority, pain, stack, plans), the recent timeline, the buying-group " +
     "stakeholders, open predictions, and the account's ICP fit score (0-100 + why). Call this before " +
     "drafting outreach, preparing for a meeting, " +
     "or making any decision about a person. A fact's freshness tells you whether to trust it: 'fresh' " +
@@ -174,8 +176,14 @@ export function createServer() {
         lines.push(`ICP FIT: ${ctx.icp.score}/100 — ${label}${ctx.icp.reason ? `  (${ctx.icp.reason})` : ""}`);
         lines.push("");
       }
+      if (ctx.facts?.length) {
+        // Atomic memory — the durable, decision-relevant facts learned about them.
+        lines.push(`FACTS (${ctx.facts.length} — durable memory about them):`);
+        for (const f of ctx.facts) lines.push(`  [${f.category}] ${f.content}${f.date ? `  (${relAge(f.date)})` : ""}`);
+        lines.push("");
+      }
       if (ctx.claims?.length) {
-        lines.push(`FACTS (${ctx.meta?.claims_returned ?? ctx.claims.length}):`);
+        lines.push(`ATTRIBUTES (${ctx.meta?.claims_returned ?? ctx.claims.length}):`);
         for (const c of ctx.claims) {
           lines.push(`  ${c.property}: ${fmtVal(c.value)}  [${pct(c.confidence)} · ${c.freshness}]`);
         }
@@ -228,7 +236,8 @@ export function createServer() {
   // ===========================================================================
   server.tool(
     "get_account",
-    "Get the full account record for a person or company — every known fact (claim) with its " +
+    "Get the full account record for a person or company — the durable FACTS we've learned about them " +
+    "(their atomic memory: budget, authority, pain, stack, plans), every attribute (claim) with its " +
     "confidence and freshness, plus the recent activity timeline. Pass an email or entity UUID. " +
     "For a task-specific, ranked view, prefer get_context.",
     { id: z.string().describe("Email address or entity UUID") },
@@ -241,9 +250,15 @@ export function createServer() {
         lines.push(`ICP FIT: ${rec.icp.score}/100 — ${label}${rec.icp.reason ? `  (${rec.icp.reason})` : ""}`);
         lines.push("");
       }
+      if (rec.facts?.length) {
+        // Atomic memory — the durable, decision-relevant facts learned about them.
+        lines.push(`FACTS (${rec.facts.length} — durable memory about them):`);
+        for (const f of rec.facts) lines.push(`  [${f.category}] ${f.content}${f.date ? `  (${relAge(f.date)})` : ""}`);
+        lines.push("");
+      }
       const claims = Object.values(rec.claims ?? {});
       if (claims.length) {
-        lines.push(`FACTS (${claims.length}):`);
+        lines.push(`ATTRIBUTES (${claims.length}):`);
         for (const c of claims) {
           lines.push(`  ${c.property}: ${fmtVal(c.value)}  [${pct(c.confidence)} · ${c.freshness}]`);
         }
@@ -354,7 +369,11 @@ export function createServer() {
     "  4. Scheduled meetings/calls are events with property 'interaction.meeting_scheduled' and a " +
     "future-dated `when`. For 'what's booked today/this week', set property:'interaction.meeting_scheduled' " +
     "with from/to bounding the day or week (since_days only looks backward and can't reach them), and " +
-    "order:'asc' to list soonest-first. Meeting rows render the absolute date and time.",
+    "order:'asc' to list soonest-first. Meeting rows render the absolute date and time.\n" +
+    "  5. scope.facts:true + question searches the FACTS corpus (durable atomic facts about accounts) " +
+    "instead of activity — cross-account semantic fact search like 'which accounts want off Clay' or " +
+    "'who is hiring'. return:'entities' gives the single best-matching fact per account. (A single " +
+    "account's facts already come back inline with get_account.)",
     {
       scope: z.object({
         kind: z.enum(["event", "state"]).optional(),
@@ -366,6 +385,7 @@ export function createServer() {
         to: z.string().optional().describe("ISO timestamp — only activity at/before this (absolute upper bound). Combine from+to for a window; future-dated for upcoming meetings"),
         order: z.enum(["asc", "desc"]).optional().describe("observed_at order (default desc, newest first). Use 'asc' for an upcoming-meeting schedule (soonest first)"),
         limit: z.number().optional().describe("max items (default 50, cap 200)"),
+        facts: z.boolean().optional().describe("search the FACTS corpus (durable atomic facts about accounts) instead of activity. Needs `question` — a cross-account semantic fact search, e.g. 'which accounts want off Clay'. return:'entities' = the best matching fact per account."),
       }).describe("Corpus filter"),
       without: z.object({
         kind: z.enum(["event", "state"]).optional(),
@@ -385,7 +405,7 @@ export function createServer() {
       const r = await post("/v2/query", body);
       const head = `${r.matched} match${r.matched !== 1 ? "es" : ""}` +
                    (r.sampled ? ` (showing ${r.returned})` : "") +
-                   (r.return === "entities" ? " · grouped by entity" : "");
+                   (r.corpus === "facts" ? " · facts" : r.return === "entities" ? " · grouped by entity" : "");
       const roll = Object.entries(r.rollups?.by_type ?? {})
         .map(([t, n]) => `${n}× ${fmtType(t)}`).join(" · ");
       const lines = [head, roll].filter(Boolean);
@@ -394,7 +414,10 @@ export function createServer() {
       }
       lines.push("");
       for (const it of r.items ?? []) {
-        if (r.return === "entities") {
+        if (r.corpus === "facts") {
+          lines.push(`  ${it.entity_name ?? it.entity_id}  [${it.category}] ${it.content}` +
+                     (it.similarity != null ? `  (${it.similarity})` : ""));
+        } else if (r.return === "entities") {
           lines.push(`  ${it.entity_name ?? it.entity_id}  ` +
                      `(${it.matches} match${it.matches !== 1 ? "es" : ""}, last ${whenLabel(it.most_recent_type, it.most_recent_at)})` +
                      (it.most_recent_value != null ? `  → ${fmtVal(it.most_recent_value)}` : "") +
@@ -437,6 +460,51 @@ export function createServer() {
     }
   );
 
+  // ===========================================================================
+  // TOOL: get_action_items  —  GET /v2/action-items
+  // Commitments extracted from meetings/emails — what you owe each account.
+  // ===========================================================================
+  server.tool(
+    "get_action_items",
+    "Your open action items and commitments, pulled from meeting notes and emails — what you owe " +
+    "which account (and what they owe you), so you don't have to dig through transcripts. Use for " +
+    "'what are my action items', 'what do I owe <account>', 'what's outstanding this week'. Defaults " +
+    "to YOUR open items across all accounts, grouped by account.",
+    {
+      owner:  z.enum(["me", "prospect", "all"]).optional().describe("Whose commitments — me (default), the prospect, or all"),
+      status: z.enum(["open", "done", "all"]).optional().describe("open (default), done, or all"),
+      focus:  z.string().optional().describe("Scope to one account — an email or entity UUID"),
+      due:    z.enum(["today", "week", "all"]).optional().describe("Only items due today / this week (items that carry a due date) — default all"),
+    },
+    async ({ owner, status, focus, due }) => {
+      const params = {};
+      if (owner)  params.owner  = owner;
+      if (status) params.status = status;
+      if (focus)  params.focus  = focus;
+      if (due)    params.due    = due;
+      const r = await get("/v2/action-items", params);
+      const items = r.items ?? [];
+      if (!items.length) return { content: [{ type: "text", text: "No matching action items." }] };
+
+      const byAccount = new Map();
+      for (const it of items) {
+        const key = it.account || it.account_email || it.entity_id || "—";
+        if (!byAccount.has(key)) byAccount.set(key, []);
+        byAccount.get(key).push(it);
+      }
+      const lines = [`${items.length} action item${items.length !== 1 ? "s" : ""}:`];
+      for (const [account, list] of byAccount) {
+        lines.push(`\n${account}:`);
+        for (const it of list) {
+          const who  = it.owner_kind === "prospect" ? "[them]" : "[you]";
+          const when = it.due_at ? `  (due ${fmtWhen(it.due_at)})` : "";
+          lines.push(`  ${who} ${it.title}${when}`);
+        }
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+
   // ===========================================================================
   // TOOL: verify  —  POST /v2/verify
   // Re-check a fact before acting on it — the calibration check.