@opennous/mcp 0.10.1 → 0.16.0

package/package.json

@@ -1,30 +1,23 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.10.1",
-  "description": "Nous MCP Server — GTM data infrastructure for agents.",
+  "version": "0.16.0",
+  "description": "Nous MCP Server — Customer graph for GTM agents.",
   "type": "module",
   "bin": {
     "nous-mcp": "src/index.js"
   },
   "main": "./src/index.js",
-  "files": [
-    "src"
-  ],
-  "keywords": [
-    "mcp",
-    "nous",
-    "memory",
-    "crm",
-    "gtm",
-    "agents"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "zod": "^3.23.8"
-  },
+  "files": ["src"],
   "scripts": {
     "dev": "node --watch src/index.js",
     "start": "node src/index.js",
+    "dev:http": "node --watch src/http.js",
+    "start:http": "node src/http.js",
     "typecheck": "echo 'no ts in mcp — skipping'"
+  },
+  "keywords": ["mcp", "nous", "memory", "crm", "gtm", "agents"],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.23.8"
   }
-}
+}

package/src/client.js

@@ -1,8 +1,15 @@
 /**
  * Nous API Client
  * Thin HTTP wrapper that handles auth, workspace context, and error handling.
+ *
+ * The API key is resolved per request: in the hosted HTTP server each request
+ * carries its own Bearer key (scoped via AsyncLocalStorage); in the stdio bin
+ * there is one key from the env. currentApiKey() checks the ALS store first,
+ * then falls back to NOUS_API_KEY, so tool handlers stay key-agnostic.
  */
 
+import { AsyncLocalStorage } from "node:async_hooks";
+
 // Resolve an env var defensively — Claude Code plugins use ${user_config.X}
 // substitution; when an optional userConfig field is left blank, the literal
 // "${user_config.field}" string can leak through. Treat any value that looks
@@ -15,10 +22,23 @@ function resolvedEnv(name) {
 }
 
 const API_URL = resolvedEnv("NOUS_API_URL") || "https://api.opennous.cloud";
-const API_KEY = resolvedEnv("NOUS_API_KEY");
 
+// Per-request key context for the hosted HTTP server. Empty in stdio mode.
+export const apiKeyStore = new AsyncLocalStorage();
+
+// Run `fn` with `apiKey` bound for the duration of its async execution, so any
+// request() call inside it uses that key.
+export function runWithApiKey(apiKey, fn) {
+  return apiKeyStore.run({ apiKey }, fn);
+}
+
+function currentApiKey() {
+  return apiKeyStore.getStore()?.apiKey ?? resolvedEnv("NOUS_API_KEY");
+}
+
+// stdio-only preflight: the env key must be present at startup.
 export function validateConfig() {
-  if (!API_KEY) {
+  if (!resolvedEnv("NOUS_API_KEY")) {
     throw new Error(
       "NOUS_API_KEY is required. Get yours at opennous.cloud → Settings → API Keys"
     );
@@ -26,6 +46,11 @@ export function validateConfig() {
 }
 
 async function request(method, path, { body, query } = {}) {
+  const apiKey = currentApiKey();
+  if (!apiKey) {
+    throw new Error("Missing Nous API key. Pass it as an Authorization: Bearer header.");
+  }
+
   const url = new URL(path, API_URL);
 
   if (query) {
@@ -37,7 +62,7 @@ async function request(method, path, { body, query } = {}) {
   }
 
   const headers = {
-    Authorization: `Bearer ${API_KEY}`,
+    Authorization: `Bearer ${apiKey}`,
     "Content-Type": "application/json",
     "X-Nous-Client": "mcp",
   };

package/src/http.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+/**
+ * Nous MCP Server — hosted, multi-tenant HTTP entrypoint (mcp.opennous.cloud).
+ *
+ * Serves the same seven tools (server.js) over the MCP Streamable HTTP transport,
+ * so cloud clients that cannot launch a local process — n8n cloud above all —
+ * can connect by pasting one URL plus their workspace API key.
+ *
+ * Auth: each request carries its own `Authorization: Bearer pk_...` (the same
+ * workspace key the REST API already validates). A `?key=pk_...` query param is
+ * accepted as a fallback for url-only clients (less secure: it can land in logs).
+ * The key is bound for the request via AsyncLocalStorage (runWithApiKey), so the
+ * tool handlers stay key-agnostic.
+ *
+ * Stateless: a fresh server + transport per request — clean tenant isolation,
+ * no session store.
+ *
+ * Env:
+ *   PORT           — listen port (default 3002)
+ *   NOUS_API_URL   — API base URL (default https://api.opennous.cloud; in-cluster: http://api:3000)
+ */
+
+import http from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { runWithApiKey } from "./client.js";
+import { createServer, SERVER_VERSION } from "./server.js";
+
+const PORT = Number(process.env.PORT) || 3002;
+const MCP_PATH = "/mcp";
+
+const CORS_HEADERS = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
+  "Access-Control-Allow-Headers": "Authorization, Content-Type, Mcp-Session-Id, Mcp-Protocol-Version",
+  "Access-Control-Expose-Headers": "Mcp-Session-Id",
+};
+
+function sendJson(res, status, payload) {
+  const text = JSON.stringify(payload);
+  res.writeHead(status, { ...CORS_HEADERS, "Content-Type": "application/json" });
+  res.end(text);
+}
+
+// JSON-RPC shaped error so MCP clients render it cleanly.
+function rpcError(res, status, message, id = null) {
+  sendJson(res, status, { jsonrpc: "2.0", error: { code: -32000, message }, id });
+}
+
+function extractApiKey(req, url) {
+  const auth = req.headers["authorization"];
+  if (auth && auth.startsWith("Bearer ")) return auth.slice(7).trim();
+  const qp = url.searchParams.get("key");
+  if (qp) return qp.trim();
+  return null;
+}
+
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (c) => chunks.push(c));
+    req.on("end", () => {
+      const raw = Buffer.concat(chunks).toString("utf8");
+      if (!raw) return resolve(undefined);
+      try { resolve(JSON.parse(raw)); }
+      catch (e) { reject(e); }
+    });
+    req.on("error", reject);
+  });
+}
+
+const httpServer = http.createServer(async (req, res) => {
+  const url = new URL(req.url, `http://${req.headers.host ?? "localhost"}`);
+
+  if (req.method === "OPTIONS") {
+    res.writeHead(204, CORS_HEADERS);
+    return res.end();
+  }
+
+  if (url.pathname === "/health" || url.pathname === "/") {
+    return sendJson(res, 200, { status: "ok", server: "nous-mcp", version: SERVER_VERSION });
+  }
+
+  if (url.pathname !== MCP_PATH) {
+    return rpcError(res, 404, "Not found. The MCP endpoint is POST /mcp.");
+  }
+
+  const apiKey = extractApiKey(req, url);
+  if (!apiKey) {
+    return rpcError(res, 401, "Missing API key. Send Authorization: Bearer <your Nous API key>.");
+  }
+
+  let body;
+  try {
+    body = req.method === "POST" ? await readBody(req) : undefined;
+  } catch {
+    return rpcError(res, 400, "Invalid JSON body.");
+  }
+
+  // Fresh server + transport per request (stateless), with the key bound for
+  // the whole async handling so every tool call uses this tenant's key.
+  await runWithApiKey(apiKey, async () => {
+    const server = createServer();
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    res.on("close", () => {
+      transport.close();
+      server.close();
+    });
+    try {
+      await server.connect(transport);
+      await transport.handleRequest(req, res, body);
+    } catch (err) {
+      if (!res.headersSent) {
+        rpcError(res, 500, `MCP error: ${err?.message ?? "unknown"}`);
+      }
+    }
+  });
+});
+
+httpServer.listen(PORT, () => {
+  console.log(`Nous MCP (HTTP) v${SERVER_VERSION} listening on :${PORT}${MCP_PATH}`);
+});

package/src/index.js

@@ -1,350 +1,24 @@
 #!/usr/bin/env node
 
 /**
- * Nous MCP Server — the context layer for GTM agents.
+ * Nous MCP Server — stdio entrypoint (published as @opennous/mcp).
  *
- * Reads from and writes to the v2 evidence substrate via the Context API.
- * The agent never sees raw rows — it gets engineered, epistemics-tagged
- * context. It never "updates" — it records observations; Nous derives.
+ * Runs locally and is launched by the client via `npx -y @opennous/mcp`. The
+ * workspace API key comes from the env. For the hosted, multi-tenant HTTP
+ * variant see http.js; the tools themselves live in server.js.
  *
  * Required env:
  *   NOUS_API_KEY   — workspace API key (Settings -> API Keys)
  * Optional:
  *   NOUS_API_URL   — API base URL (default: https://api.opennous.cloud)
- *
- * Tools (all v2 — thin clients of the Context API):
- *   get_context          — engineered context for a task (draft_email, follow_up, ...)
- *   get_account          — the full account record: every claim + the timeline
- *   record               — record what happened / what you learned (observe, never update)
- *   query                — retrieve + summarise a corpus of activity across many people
- *   attention            — what needs your attention (accounts gone quiet, facts decayed)
- *   verify               — re-check a fact before acting on it
- *   get_workspace_facts  — workspace-level facts (ICP, market, pricing, product, competitors)
  */
 
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import { validateConfig, get, post } from "./client.js";
-
-// ─── helpers ──────────────────────────────────────────────────────────────────
-
-function relAge(ts) {
-  if (!ts) return "—";
-  const d = Math.floor((Date.now() - new Date(ts).getTime()) / 86400000);
-  if (d < 1)   return "today";
-  if (d === 1) return "1d ago";
-  if (d < 30)  return `${d}d ago`;
-  const m = Math.floor(d / 30);
-  if (m < 12)  return `${m}mo ago`;
-  return `${Math.floor(m / 12)}y ago`;
-}
-
-const fmtType = (p) => (p || "").replace(/^interaction\./, "").replace(/_/g, " ");
-const fmtVal  = (v) => (v != null && typeof v === "object") ? JSON.stringify(v) : String(v ?? "");
-const pct     = (c) => `${Math.round((c ?? 0) * 100)}%`;
+import { validateConfig } from "./client.js";
+import { createServer } from "./server.js";
 
 validateConfig();
 
-const server = new McpServer({
-  name: "nous",
-  version: "0.10.1",
-  description:
-    "Nous — the context layer for GTM agents. Call get_context before drafting outreach or " +
-    "preparing for a meeting. Call record after every interaction, or whenever you learn something.",
-  icons: [
-    { src: "https://opennous.cloud/newlogoP.png", mimeType: "image/png", sizes: ["64x64"] },
-  ],
-});
-
-// ===========================================================================
-// TOOL: get_context  —  POST /v2/context
-// The headline tool. Engineered, intent-shaped context for a specific task.
-// ===========================================================================
-server.tool(
-  "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 " +
-  "stakeholders, and open predictions. 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' " +
-  "act on it, 'suspect'/'expired' verify first.",
-  {
-    focus: z.string().describe("Who to look up — an email, a LinkedIn URL, a domain, an entity UUID, or a name. A name may match several people; you'll get candidates to choose from."),
-    intent: z.enum(["draft_email", "follow_up", "meeting_prep", "call_prep", "account_review"])
-      .optional()
-      .describe("What you are about to do — shapes which context surfaces (default: account_review)"),
-    budget_tokens: z.number().optional().describe("Approximate token budget for the context block"),
-  },
-  async ({ focus, intent, budget_tokens }) => {
-    const ctx = await post("/v2/context", { focus, intent: intent ?? "account_review", budget_tokens });
-
-    // a name matched several people — surface the candidates to choose from
-    if (ctx.status === "ambiguous") {
-      const opts = (ctx.candidates ?? []).map(c =>
-        `  • ${c.name ?? "(unnamed)"}${c.detail ? ` — ${c.detail}` : ""}  [${c.entity_id}]`).join("\n");
-      return { content: [{ type: "text", text:
-        `"${focus}" matches several people. Call get_context again with one of these entity ids:\n${opts}` }] };
-    }
-
-    const lines = [ctx.summary, ""];
-
-    if (ctx.claims?.length) {
-      lines.push(`FACTS (${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}]`);
-      }
-      lines.push("");
-    }
-    if (ctx.workspace?.length) {
-      lines.push("YOUR CONTEXT (ICP / product / positioning):");
-      for (const w of ctx.workspace) lines.push(`  ${w.property}: ${fmtVal(w.value)}`);
-      lines.push("");
-    }
-    if (ctx.timeline?.length) {
-      lines.push("TIMELINE:");
-      for (const t of ctx.timeline) {
-        if (t.tier === "count") lines.push(`  ${t.count}× ${fmtType(t.type)}`);
-        else lines.push(`  ${relAge(t.when)}  ${fmtType(t.type)}${t.summary ? `: ${t.summary}` : ""}`);
-      }
-      lines.push("");
-    }
-    if (ctx.stakeholders?.length) {
-      lines.push("STAKEHOLDERS:");
-      for (const s of ctx.stakeholders) lines.push(`  ${s.name ?? "—"} — ${s.role ?? ""}`);
-      lines.push("");
-    }
-    if (ctx.predictions?.length) {
-      lines.push("PREDICTIONS:");
-      for (const p of ctx.predictions) {
-        lines.push(`  ${p.kind}: ${fmtVal(p.value)} (${pct(p.confidence)})`);
-      }
-    }
-    return {
-      content: [{ type: "text", text: `${lines.join("\n").trim()}\n\n(entity_id: ${ctx.entity?.id})` }],
-    };
-  }
-);
-
-// ===========================================================================
-// TOOL: get_account  —  GET /v2/accounts/:id
-// The full account-record projection. For a focused view, prefer get_context.
-// ===========================================================================
-server.tool(
-  "get_account",
-  "Get the full account record for a person or company — every known fact (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") },
-  async ({ id }) => {
-    const rec = await get(`/v2/accounts/${encodeURIComponent(id)}`);
-    const lines = [`${rec.type} · ${rec.entity_id}`, ""];
-
-    const claims = Object.values(rec.claims ?? {});
-    if (claims.length) {
-      lines.push(`FACTS (${claims.length}):`);
-      for (const c of claims) {
-        lines.push(`  ${c.property}: ${fmtVal(c.value)}  [${pct(c.confidence)} · ${c.freshness}]`);
-      }
-      lines.push("");
-    }
-    const obs = rec.recent_observations ?? [];
-    if (obs.length) {
-      lines.push(`TIMELINE (${obs.length}):`);
-      for (const o of obs.slice(0, 30)) {
-        lines.push(`  ${relAge(o.observed_at)}  ${fmtType(o.property)}`);
-      }
-    }
-    return { content: [{ type: "text", text: lines.join("\n").trim() }] };
-  }
-);
-
-// ===========================================================================
-// TOOL: record  —  POST /v2/observations
-// The single write verb. You observe — Nous derives the updated facts.
-// ===========================================================================
-server.tool(
-  "record",
-  "Record what happened or what you learned about a person or company. You never overwrite " +
-  "anything — you observe, and Nous derives the updated facts. Use kind:'event' for an interaction " +
-  "(property like 'interaction.email_sent', 'interaction.call_held', 'interaction.email_reply') and " +
-  "kind:'state' for a fact (property like 'job_title', 'deal.proposal_amount'). Examples — sent an " +
-  "email: {kind:'event',property:'interaction.email_sent',value:{description:'intro email'}}; " +
-  "learned their title changed: {kind:'state',property:'job_title',value:'VP of Engineering'}; " +
-  "a fact ended (they left): {kind:'state',property:'job_title',value:null}.",
-  {
-    focus: z.string().describe("Email address or entity UUID of the person or company"),
-    observations: z.array(z.object({
-      kind: z.enum(["event", "state"]).describe("event = an interaction; state = a fact"),
-      property: z.string().describe("e.g. 'interaction.email_sent' or 'job_title'"),
-      value: z.any().optional().describe("the event detail or the fact value; null = the fact ended"),
-      source: z.string().optional().describe("where this came from (default: agent)"),
-    })).describe("One or more observations to record"),
-  },
-  async ({ focus, observations }) => {
-    const result = await post("/v2/observations", { focus, observations });
-    const parts = [`Recorded ${result.recorded} observation${result.recorded !== 1 ? "s" : ""}.`];
-    if (result.claims_recomputed?.length) {
-      parts.push(`Facts updated: ${result.claims_recomputed.join(", ")}.`);
-    }
-    parts.push(`(entity_id: ${result.entity_id})`);
-    return { content: [{ type: "text", text: parts.join("\n") }] };
-  }
-);
-
-// ===========================================================================
-// TOOL: query  —  POST /v2/query
-// Retrieve a corpus of activity across many people. You do the analysis.
-// ===========================================================================
-server.tool(
-  "query",
-  "Retrieve and summarise activity across many people. Three powers:\n" +
-  "  1. return:'entities' groups results by person/company (one row per entity, ranked by " +
-  "most-recent matching activity). Use for 'hottest leads', 'who replied this week', " +
-  "'who's in evaluating stage'.\n" +
-  "  2. `without` subtracts entities — 'sent in 5d MINUS replied in 5d' = 'no-reply leads'. " +
-  "'activity in 30d MINUS activity in 5d' = 'cooled leads'.\n" +
-  "  3. rollups.by_value appears when scope.kind='state' — counts entities by current value " +
-  "(use scope.property='stage' for funnel reports).",
-  {
-    scope: z.object({
-      kind: z.enum(["event", "state"]).optional(),
-      property: z.string().optional().describe("property prefix — 'interaction.email' covers email_sent and email_replied"),
-      source: z.string().optional().describe("e.g. 'gmail', 'linkedin', 'slack'"),
-      entity_id: z.string().optional().describe("scope to one person/company"),
-      since_days: z.number().optional().describe("only activity within the last N days"),
-      limit: z.number().optional().describe("max items (default 50, cap 200)"),
-    }).describe("Corpus filter"),
-    without: z.object({
-      kind: z.enum(["event", "state"]).optional(),
-      property: z.string().optional(),
-      source: z.string().optional(),
-      entity_id: z.string().optional(),
-      since_days: z.number().optional(),
-    }).optional().describe("Subtract entities matching this scope from the result — same shape as scope. Enables 'sent but no reply', 'cooled in last N days'."),
-    return: z.enum(["observations", "entities"]).optional()
-      .describe("observations (default) = one row per observation. entities = one row per entity, ranked by most-recent matching activity."),
-    question: z.string().optional().describe("What you want to learn — echoed back; enables semantic ranking"),
-  },
-  async ({ scope, without, return: returnMode, question }) => {
-    const body = { scope, question };
-    if (without)    body.without = without;
-    if (returnMode) body.return  = returnMode;
-    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" : "");
-    const roll = Object.entries(r.rollups?.by_type ?? {})
-      .map(([t, n]) => `${n}× ${fmtType(t)}`).join(" · ");
-    const lines = [head, roll].filter(Boolean);
-    if (r.rollups?.by_value && Object.keys(r.rollups.by_value).length) {
-      lines.push("BY VALUE: " + Object.entries(r.rollups.by_value).map(([v, n]) => `${v}: ${n}`).join(", "));
-    }
-    lines.push("");
-    for (const it of r.items ?? []) {
-      if (r.return === "entities") {
-        lines.push(`  ${it.entity_name ?? it.entity_id}  ` +
-                   `(${it.matches} match${it.matches !== 1 ? "es" : ""}, last ${relAge(it.most_recent_at)})` +
-                   (it.most_recent_value != null ? `  → ${fmtVal(it.most_recent_value)}` : "") +
-                   (it.most_recent_summary ? `\n      ${it.most_recent_summary}` : ""));
-      } else {
-        lines.push(`  ${relAge(it.when)}  ${it.entity_name ?? it.entity_id}  ` +
-                   `${fmtType(it.type)}${it.summary ? `: ${it.summary}` : ""}`);
-      }
-    }
-    return { content: [{ type: "text", text: lines.join("\n").trim() }] };
-  }
-);
-
-// ===========================================================================
-// TOOL: attention  —  GET /v2/attention
-// What to look at: accounts gone quiet, key facts decayed.
-// ===========================================================================
-server.tool(
-  "attention",
-  "What needs your attention across the workspace right now — accounts that have gone quiet and " +
-  "key facts that have decayed. Returns ranked items, each with what happened and a suggested " +
-  "action. Call this to decide who to work next.",
-  {
-    limit: z.number().min(1).max(100).optional().describe("Max items (default 25)"),
-  },
-  async ({ limit }) => {
-    const r = await get("/v2/attention", limit ? { limit } : {});
-    if (!r.items?.length) {
-      return { content: [{ type: "text", text: "Nothing needs attention right now." }] };
-    }
-    const lines = r.items.map(it =>
-      `  ${it.entity_name ?? it.entity_id} — ${it.what}\n      → ${it.suggested_action}`);
-    return { content: [{ type: "text", text: `Needs attention (${r.items.length}):\n${lines.join("\n")}` }] };
-  }
-);
-
-// ===========================================================================
-// TOOL: verify  —  POST /v2/verify
-// Re-check a fact before acting on it — the calibration check.
-// ===========================================================================
-server.tool(
-  "verify",
-  "Re-check a specific fact before you act on it — e.g. an email or a deal stage that looks stale " +
-  "in get_context. Pass the person/company and the property name. Returns the fact re-derived from " +
-  "current evidence, and tells you whether it is still unverified.",
-  {
-    focus: z.string().describe("Email, LinkedIn URL, entity UUID, or name"),
-    property: z.string().describe("The fact to re-check — e.g. 'email', 'job_title', 'pipeline_stage'"),
-  },
-  async ({ focus, property }) => {
-    const r = await post("/v2/verify", { focus, property });
-    if (r.status === "ambiguous") {
-      const opts = (r.candidates ?? []).map(c =>
-        `  • ${c.name ?? "(unnamed)"}${c.detail ? ` — ${c.detail}` : ""}  [${c.entity_id}]`).join("\n");
-      return { content: [{ type: "text", text:
-        `"${focus}" matches several people. Call verify again with one of these entity ids:\n${opts}` }] };
-    }
-    const a = r.after ?? {};
-    return { content: [{ type: "text", text:
-      `${property}: ${fmtVal(a.value)}  [${pct(a.confidence)} · ${a.freshness}]\n${r.note ?? ""}` }] };
-  }
-);
-
-// ===========================================================================
-// TOOL: get_workspace_facts  —  GET /v2/workspace/facts
-// The user's OWN playbook: ICP, market, product, pricing, competitors.
-// Use this for any question about the user's business — NOT get_account.
-// ===========================================================================
-server.tool(
-  "get_workspace_facts",
-  "Get workspace-level facts the user has recorded about THEIR OWN business — ICP, target market, " +
-  "product, pricing, competitors, playbooks. These are NOT facts about people or companies; they " +
-  "are the user's own playbook. Use this for any question about the user's ICP, target buyer, " +
-  "pricing, market, or differentiators. ALWAYS prefer this over query/get_account when the " +
-  "question is about the user's business.",
-  {
-    categories: z.array(z.string()).optional()
-      .describe("Optional category filter, e.g. ['ICP'] or ['Pricing','Competitors']. Omit for all."),
-    limit: z.number().min(1).max(500).optional()
-      .describe("Max facts to return (default 50)"),
-  },
-  async ({ categories, limit }) => {
-    const params = {};
-    if (categories?.length) params.categories = categories.join(",");
-    if (limit != null) params.limit = limit;
-    const r = await get("/v2/workspace/facts", params);
-    if (!r.facts?.length) {
-      return { content: [{ type: "text", text:
-        "No workspace facts recorded yet. The user can add them in the Intelligence tab." }] };
-    }
-    const groups = {};
-    for (const f of r.facts) (groups[f.category] ??= []).push(f);
-    const lines = [];
-    for (const [cat, facts] of Object.entries(groups)) {
-      lines.push(`${cat.toUpperCase()} (${facts.length}):`);
-      for (const f of facts) lines.push(`  ${f.content}  [${relAge(f.recorded_at)}]`);
-      lines.push("");
-    }
-    return { content: [{ type: "text", text: lines.join("\n").trim() }] };
-  }
-);
-
-// ───────────────────────────────────────────────────────────────────────────
+const server = createServer();
 const transport = new StdioServerTransport();
 await server.connect(transport);