@edda-business/mcp 0.60.0 → 0.61.0

package/package.json

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

package/src/server.js

@@ -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.60.0";
+export const SERVER_VERSION = "0.61.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -712,7 +712,7 @@ export function createServer() {
       name: z.string().describe("The page name, e.g. 'Refund Policy' or 'Q3 Planning — 2026-08-22'. A '.md' suffix is added if missing."),
       content: z.string().describe("The full markdown content of the page."),
       visibility: z.enum(["owner", "department", "company"]).optional().describe("Who can see the page: 'department' (the team it's filed in — default), 'company' (everyone), or 'owner' (just you)."),
-      folder: z.string().optional().describe("Folder to file under, by NAME or path, e.g. 'Projects/Data Centre'. Created if it doesn't exist (needs a write role). Use this OR folder_id."),
+      folder: z.string().optional().describe("Folder to file under, by NAME or path. Top-level folders are fixed — a bare name becomes a project under Projects (e.g. 'Agency' → Projects/Agency); 'Top-Level/Sub' nests under a fixed folder. Created if missing (write role). Use this OR folder_id."),
       subfolder: z.string().optional().describe("Optional subfolder within `folder`, e.g. 'Specs'."),
       folder_id: z.string().optional().describe("Id of an existing company folder to file under (alternative to `folder`). Omit both to use the default 'wiki' folder."),
     },
@@ -744,12 +744,14 @@ export function createServer() {
   // ===========================================================================
   server.tool(
     "create_folder",
-    "Create a folder (or a nested path) in the SHARED COMPANY knowledge tree so you can file pages into it. " +
-    "Pass `path` as a name or slash-path, e.g. 'Projects/Data Centre' — every missing level is created. A " +
-    "folder directly under 'Projects' becomes a project (it gets a 'Shared with' control the Ambassador uses " +
-    "to grant departments). A write role is required and the folder appears immediately. Then add pages with " +
-    "propose_company_file / propose_company_files using the same `folder` path. Returns the folder id.",
-    { path: z.string().describe("Folder name or path, e.g. 'Projects/Data Centre' or 'Playbooks'.") },
+    "Create a folder in the SHARED COMPANY knowledge tree so you can file pages into it. The TOP-LEVEL " +
+    "folders are FIXED (Company · Projects · Decisions · Companies · People · Raw Documents · Archive) — you " +
+    "cannot add new ones. A bare name (or a path that doesn't start with one of those) becomes a PROJECT under " +
+    "Projects: 'Agency' → Projects/Agency. To nest under a specific top-level folder, start the path with it, " +
+    "e.g. 'Company/Policies' or 'Projects/Data Centre/Specs'. A project gets a 'Shared with' control the " +
+    "Ambassador uses to grant departments. A write role is required; the folder appears immediately. Then add " +
+    "pages with propose_company_file / propose_company_files using the same path. Returns the folder id.",
+    { path: z.string().describe("Folder name or path. A bare name → a project under Projects; 'Top-Level/Sub' nests under a fixed top-level folder.") },
     async ({ path }) => {
       try {
         const r = await post("/v2/company/folders", { path });
@@ -775,7 +777,7 @@ export function createServer() {
     "a write role publishes them live; a viewer sends the whole batch to the company inbox. Name the target with " +
     "`folder` (a path, created if missing) + optional `subfolder`, or an existing `folder_id`. Max 50 pages.",
     {
-      folder: z.string().optional().describe("Folder path to file all pages under, e.g. 'Projects/Data Centre'. Created if missing."),
+      folder: z.string().optional().describe("Folder to file all pages under. Top-level is fixed — a bare name becomes a project under Projects (e.g. 'Agency' → Projects/Agency); 'Top-Level/Sub' nests under a fixed folder. Created if missing."),
       subfolder: z.string().optional().describe("Optional subfolder within `folder`."),
       folder_id: z.string().optional().describe("Id of an existing folder (alternative to `folder`)."),
       visibility: z.enum(["owner", "department", "company"]).optional().describe("Default visibility for the pages (a page can override its own). Default 'department'."),