lotux-mcp 0.26.0 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lotux-mcp",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "type": "module",
   "description": "Local MCP server that lets Claude create LOTUX concepts (fetch brand-DB entities, create concepts, fill scripts + copy). Talks to the LOTUX app with a personal token; no business logic or secrets live here.",
   "bin": {

package/tools.mjs

@@ -702,6 +702,15 @@ export function registerTools(server, rpc) {
 
   // ── Kennisbank (knowledge base) ─────────────────────────────────────────────────
 
+  // How a Second Brain page's markdown is laid out — the app renders these.
+  const KB_FORMAT =
+    " Page markdown supports, besides normal markdown (headings, lists, tables, --- dividers, images): " +
+    "fenced blocks the app renders as page blocks — ```cards (one card per line: Label | Title | Text), " +
+    "```stats (Value | Label | Note), ```steps (Title | Text), ```callout (first line = title, the rest = body), " +
+    "```buttons (Label | link), ```mermaid (a Mermaid diagram). Any of those may start with a line " +
+    "`tone: gray|yellow|blue|green|red|purple|ink` for its colour. Link to another page with a normal markdown link " +
+    "to /brain/second-brain?ws=<workspace id>&doc=<page id>.";
+
   server.tool(
     "list_kb_workspaces",
     "List the Kennisbank (knowledge base) workspaces you can access — markdown docs the team and AI share. Returns id, name, visibility. Use a workspace id with list_kb_docs / create_kb_doc. Only each workspace's \"Exposed to MCP\" section is visible to the MCP; the rest is the team's own notes.",
@@ -711,37 +720,41 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "list_kb_docs",
-    "List the pages in a Kennisbank workspace's \"Exposed to MCP\" section (id, title, folder path inside the section; \"\" = its top level). Pages outside the section are not listed. Use a doc id with get_kb_doc.",
+    "List the pages in a Kennisbank workspace's \"Exposed to MCP\" section (id, title, folder path inside the section; \"\" = its top level; tags; date). Pages outside the section are not listed. Use a doc id with get_kb_doc.",
     { workspace_id: z.string().describe("Workspace id from list_kb_workspaces") },
     async ({ workspace_id }) => ok(await rpc("list_kb_docs", { workspace_id }))
   );
 
   server.tool(
     "get_kb_doc",
-    "Read one Kennisbank page's full markdown content by id. Only pages in the \"Exposed to MCP\" section can be read.",
+    "Read one Kennisbank page by id: title, author, date, tags, full markdown content and linked_pages (the pages it links to; a linked page outside an \"Exposed to MCP\" section shows only its id with exposed: false). Only pages in the \"Exposed to MCP\" section can be read." + KB_FORMAT,
     { doc_id: z.string() },
     async ({ doc_id }) => ok(await rpc("get_kb_doc", { doc_id }))
   );
 
   server.tool(
     "create_kb_doc",
-    "Create a new markdown page in a Kennisbank workspace's \"Exposed to MCP\" section. Returns the new doc id. content is markdown; folder_id is optional (top of the section if omitted) and must be a folder from list_kb_folders.",
+    "Create a new markdown page in a Kennisbank workspace's \"Exposed to MCP\" section. Returns the new doc id. content is markdown; folder_id is optional (top of the section if omitted) and must be a folder from list_kb_folders. You become the page's author." + KB_FORMAT,
     {
       workspace_id: z.string().describe("Workspace id from list_kb_workspaces"),
       title: z.string(),
       content: z.string().optional().describe("Markdown body"),
       folder_id: z.string().optional(),
+      tags: z.array(z.string()).optional().describe("Page tags"),
+      date: z.string().optional().describe("Page date, YYYY-MM-DD (default: today)"),
     },
     async (args) => ok(await rpc("create_kb_doc", args))
   );
 
   server.tool(
     "update_kb_doc",
-    "Update a Kennisbank page's title and/or markdown content (pages in the \"Exposed to MCP\" section only). Omitted fields are left unchanged.",
+    "Update a Kennisbank page's title, markdown content, tags and/or date (pages in the \"Exposed to MCP\" section only). Omitted fields are left unchanged." + KB_FORMAT,
     {
       doc_id: z.string(),
       title: z.string().optional(),
       content: z.string().optional().describe("Markdown body (replaces the page content)"),
+      tags: z.array(z.string()).optional().describe("Replaces the page's tags"),
+      date: z.string().nullable().optional().describe("Page date YYYY-MM-DD; null = back to the created date"),
     },
     async (args) => ok(await rpc("update_kb_doc", args))
   );