@edda-business/mcp 0.62.0 → 0.63.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edda-business/mcp",
-  "version": "0.62.0",
+  "version": "0.63.0",
   "description": "Edda — the company data layer for AI agents.",
   "license": "Apache-2.0",
   "repository": {

package/src/client.js

@@ -24,7 +24,10 @@ function resolvedEnv(name) {
   return v;
 }
 
-const API_URL = resolvedEnv("NOUS_API_URL") || "https://api.opennous.cloud";
+// Prefer the EDDA_* env vars; fall back to the legacy NOUS_* names so existing configs keep working.
+const envKey = () => resolvedEnv("EDDA_API_KEY") ?? resolvedEnv("NOUS_API_KEY");
+const envUrl = () => resolvedEnv("EDDA_API_URL") ?? resolvedEnv("NOUS_API_URL");
+const API_URL = envUrl() || "https://api.opennous.cloud";
 
 // Per-request key context for the hosted HTTP server. Empty in stdio mode.
 export const apiKeyStore = new AsyncLocalStorage();
@@ -35,17 +38,16 @@ export function runWithApiKey(apiKey, fn) {
   return apiKeyStore.run({ apiKey }, fn);
 }
 
-// Credential written by `nous login` (the browser device-auth flow). The CLI and
-// the MCP server share ~/.nous/config.json, so a user who runs the login command
-// gets a key — and, for self-host, the API URL — the MCP picks up on the next
-// call, with no paste and no env var.
+// Credential written by the CLI login (the browser device-auth flow). The CLI and the MCP server
+// share a config.json, so a user who runs the login command gets a key — and, for self-host, the
+// API URL — the MCP picks up on the next call, with no paste and no env var. Checks ~/.edda first,
+// then legacy ~/.nous.
 function readFileConfig() {
-  try {
-    const dir = resolvedEnv("NOUS_CONFIG_DIR") || path.join(os.homedir(), ".nous");
-    return JSON.parse(fs.readFileSync(path.join(dir, "config.json"), "utf8"));
-  } catch {
-    return null;
+  const dirs = [resolvedEnv("EDDA_CONFIG_DIR"), resolvedEnv("NOUS_CONFIG_DIR"), path.join(os.homedir(), ".edda"), path.join(os.homedir(), ".nous")].filter(Boolean);
+  for (const dir of dirs) {
+    try { return JSON.parse(fs.readFileSync(path.join(dir, "config.json"), "utf8")); } catch { /* try next */ }
   }
+  return null;
 }
 function clean(v) {
   return v && !String(v).includes("${") ? v : undefined;   // drop unresolved ${...} markers
@@ -54,25 +56,22 @@ function fileApiKey() { return clean(readFileConfig()?.apiKey); }
 function fileApiUrl() { return clean(readFileConfig()?.apiUrl); }
 
 function currentApiKey() {
-  return apiKeyStore.getStore()?.apiKey ?? resolvedEnv("NOUS_API_KEY") ?? fileApiKey();
+  return apiKeyStore.getStore()?.apiKey ?? envKey() ?? fileApiKey();
 }
 
-// Resolve the API base per call: env → ~/.nous/config.json (set by `nous login
-// --url` on self-host) → cloud default. So a self-hoster who logs in via the CLI
-// gets the MCP pointed at their own instance automatically.
+// Resolve the API base per call: env → config.json (set by the CLI login on self-host) → cloud
+// default. So a self-hoster who logs in via the CLI gets the MCP pointed at their own instance.
 function currentApiUrl() {
-  return resolvedEnv("NOUS_API_URL") ?? fileApiUrl() ?? "https://api.opennous.cloud";
+  return envUrl() ?? fileApiUrl() ?? "https://api.opennous.cloud";
 }
 
-// stdio-only preflight. A key may come from the env OR from `nous login`'s
-// credential file. This is advisory — the server still starts without one so
-// the user can run the login command after installing the plugin, and the key
-// is resolved per-call.
+// stdio-only preflight. A key may come from the env OR the CLI login credential file. Advisory —
+// the server still starts without one so the user can log in after installing, key resolved per-call.
 export function validateConfig() {
-  if (!resolvedEnv("NOUS_API_KEY") && !fileApiKey()) {
+  if (!envKey() && !fileApiKey()) {
     throw new Error(
       "No Edda API key found. Run `npx @edda-business/cli login` to sign in (or `npx @edda-business/cli init` " +
-      "to set up from scratch), or set NOUS_API_KEY."
+      "to set up from scratch), or set EDDA_API_KEY."
     );
   }
 }

package/src/index.js

@@ -8,9 +8,10 @@
  * variant see http.js; the tools themselves live in server.js.
  *
  * Required env:
- *   NOUS_API_KEY   — workspace API key (Settings -> API Keys)
+ *   EDDA_API_KEY   — workspace API key (Sources -> API Keys). Encodes the workspace + scope.
  * Optional:
- *   NOUS_API_URL   — API base URL (default: https://api.opennous.cloud)
+ *   EDDA_API_URL   — API base URL for your instance, e.g. https://api.whitehayai.com
+ * (Legacy NOUS_API_KEY / NOUS_API_URL are still accepted as a fallback.)
  */
 
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/src/server.js

@@ -29,7 +29,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.62.0";
+export const SERVER_VERSION = "0.63.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -574,6 +574,80 @@ export function createServer() {
     },
   );
 
+  // ===========================================================================
+  // TOOL: list_my_files  —  GET /v2/personal/tree
+  // Navigate the member's personal PARA vault like a filesystem: Inbox · Projects ·
+  // Areas · Resources · Archive · People · Companies. Returns every file as a path.
+  // ===========================================================================
+  server.tool(
+    "list_my_files",
+    "List the files in your personal workspace — a PARA knowledge tree (Inbox, Projects, Areas, " +
+    "Resources, Archive, People, Companies) of markdown files you own. Use this to SEE what's there " +
+    "and navigate it like a filesystem before reading or writing. Returns each file's path " +
+    "(e.g. 'projects/acme-rollout/notes.md'); read one with read_my_file, write with save_personal_file.",
+    {
+      folder: z.string().optional().describe("Optional: only list files under this top-level folder (e.g. 'projects')."),
+    },
+    async ({ folder }) => {
+      const d = await get("/v2/personal/tree");
+      let files = d.files ?? [];
+      if (folder) files = files.filter((f) => f.folder === String(folder).toLowerCase());
+      if (!files.length) return { content: [{ type: "text", text: folder ? `No files in ${folder}/ yet.` : "Your personal workspace is empty." }] };
+      const lines = files.map((f) => `  ${f.path}${f.status === "inbox_pending" ? "  (pending approval)" : ""}`).join("\n");
+      return { content: [{ type: "text", text: `${files.length} file(s):\n${lines}` }] };
+    },
+  );
+
+  // ===========================================================================
+  // TOOL: read_my_file  —  GET /v2/personal/file?path=…
+  // Read one personal-vault file by its path.
+  // ===========================================================================
+  server.tool(
+    "read_my_file",
+    "Read one file from your personal workspace by its path (e.g. 'companies/acme.md' or " +
+    "'projects/acme-rollout/notes.md'). Use list_my_files first to find the path. Returns the " +
+    "markdown content so you can work with it, then save changes with save_personal_file.",
+    {
+      path: z.string().describe("The file path: 'folder/[subfolder/]name.md' (folder is one of inbox/projects/areas/resources/archive/people/companies)."),
+    },
+    async ({ path }) => {
+      try {
+        const d = await get("/v2/personal/file", { path });
+        let text = `# ${d.path}\n\n${d.content || "(empty)"}`;
+        const out = (d.outgoing ?? []).filter((l) => l.resolved);
+        const back = d.backlinks ?? [];
+        if (out.length || back.length) {
+          text += `\n\n---\n`;
+          if (out.length) text += `Links to: ${out.map((l) => `${l.target}${l.kind.startsWith("relation:") ? ` (${l.kind.slice(9)})` : ""}`).join(", ")}\n`;
+          if (back.length) text += `Linked from: ${back.map((l) => l.source).join(", ")}\n`;
+        }
+        return { content: [{ type: "text", text }] };
+      } catch (e) {
+        const msg = String(e?.message || "");
+        return { content: [{ type: "text", text: msg.includes("404") ? `No file at ${path}. Use list_my_files to see what's there.` : `Couldn't read ${path}.` }] };
+      }
+    },
+  );
+
+  // ===========================================================================
+  // TOOL: create_project  —  POST /v2/personal/project
+  // Scaffold a project folder with the standard sub-structure.
+  // ===========================================================================
+  server.tool(
+    "create_project",
+    "Create a new project in your workspace, scaffolded with the standard structure: Context, " +
+    "Working Documents, Decisions, People & Companies, Deliverables, Raw Documents, Archive. " +
+    "Use this when you start a real piece of work so everything about it has a home. Then write " +
+    "files into projects/<name>/<subfolder>/… (e.g. the current status goes in Context).",
+    {
+      name: z.string().describe("The project name, e.g. 'Acme rollout'."),
+    },
+    async ({ name }) => {
+      const d = await post("/v2/personal/project", { name });
+      return { content: [{ type: "text", text: `Created project "${d.project}" at ${d.path}/ with: ${(d.folders || []).join(", ")}.` }] };
+    },
+  );
+
   // ===========================================================================
   // TOOL: propose_vault_file  —  POST /v2/personal/propose
   // Propose a markdown file into the member's PERSONAL vault. It lands in their