lotux-mcp 0.10.3 → 0.16.0

package/index.mjs

@@ -52,17 +52,141 @@ const ok = (result) => ({
   content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
 });
 
-const server = new McpServer({ name: "lotux", version: "0.10.3" });
+const server = new McpServer({ name: "lotux", version: "0.16.0" });
 
 // ── Reads ─────────────────────────────────────────────────────────────────────
 
 server.tool(
   "list_brands",
-  "List the LOTUX brands (and the agency) you can access. Use the returned id as account_id for other tools.",
+  "List the LOTUX brands (and the agency) you can access, with each brand's slug and client_status (active / archived / internal). Use the returned id as account_id for other tools.",
   {},
   async () => ok(await rpc("list_brands"))
 );
 
+// ── Client workspaces (agency team only) ──────────────────────────────────────
+// Where a client's things live for the Cowork editors: Dropbox client folder,
+// raw-footage folders, the agentic workspace folder (01_CLIENTS/<slug>) and the
+// second brain (Kennisbank).
+
+server.tool(
+  "get_brand",
+  "One client's workspace settings: slug, client_status, second brain (Kennisbank id + name, shared with the client or not), workspace_folder, dropbox_client_path, raw_footage_paths, Claude project name, the Claude project kit (instructions text) and the active work claims.",
+  { account_id: z.string().describe("Brand id from list_brands") },
+  async (args) => ok(await rpc("get_brand", args))
+);
+
+server.tool(
+  "update_brand_settings",
+  "Change a client's workspace settings. Omitted fields stay as they are. slug is refused once client setup has run (it names the workspace folder). dropbox_client_path follows the Dropbox connection and workspace_folder follows the slug, so neither is set here.",
+  {
+    account_id: z.string().describe("Brand id from list_brands"),
+    client_status: z.enum(["active", "archived", "internal"]).optional(),
+    slug: z.string().optional().describe("Lowercase letters, digits and hyphens"),
+    kb_workspace_id: z.string().nullable().optional().describe("Kennisbank workspace id (list_kb_workspaces) to link as the second brain"),
+    raw_footage_paths: z.array(z.string()).optional().describe("Dropbox paths, e.g. /CLIENTS/Active/Dr. Kegel/01_video/01_raw footage"),
+    claude_project_name: z.string().optional(),
+  },
+  async (args) => ok(await rpc("update_brand_settings", args))
+);
+
+server.tool(
+  "run_client_setup",
+  "Run client setup for a brand: slug, second brain (an \"Agentic workspace\" page plus Client Feedback and Basic Rules folders in its \"Exposed to MCP\" section), the agentic workspace folder + CLIENT.md settings block, and (once the brand has connected Dropbox) the linked Dropbox client folder. It already runs by itself when a brand is created and when it connects Dropbox; run it again to fill gaps. Only creates what's missing; running it twice changes nothing. Skipped for clients that aren't active. dry_run: true returns the plan without changing anything. Returns a report per step (created / linked / updated / already there / failed + reason).",
+  {
+    account_id: z.string().describe("Brand id from list_brands"),
+    dry_run: z.boolean().optional(),
+  },
+  async (args) => ok(await rpc("run_client_setup", args))
+);
+
+server.tool(
+  "list_kb_folders",
+  "The folders in a Kennisbank workspace's \"Exposed to MCP\" section, the only part of a second brain the MCP can see (id, name, parent_id, path; parent_id null = directly in the section). Use a folder id as folder_id in create_kb_doc.",
+  { workspace_id: z.string().describe("Workspace id from list_kb_workspaces or get_brand") },
+  async (args) => ok(await rpc("list_kb_folders", args))
+);
+
+server.tool(
+  "create_kb_folder",
+  "Create a folder in a Kennisbank workspace's \"Exposed to MCP\" section (at its top level, or inside parent_id). Returns the folder id.",
+  {
+    workspace_id: z.string(),
+    name: z.string(),
+    parent_id: z.string().optional().describe("Parent folder id from list_kb_folders"),
+  },
+  async (args) => ok(await rpc("create_kb_folder", args))
+);
+
+// ── Work claims ───────────────────────────────────────────────────────────────
+// Several editors work on one client at once, never on the same piece. Claim
+// before you write files; the database decides who's first (Dropbox is too slow
+// for lock files). Claiming again while you hold it renews it.
+
+server.tool(
+  "claim_work",
+  "Claim a piece of work before writing files for it. kind: concept (ref = concept id; prep / edit / revise / re-render one concept; 6 h), inventory (the brand's inventory run; 6 h), brand_shared (files several concepts of the brand use: logos, shared media, shared code; 15 min), house_rules (the shared house rules or style spec, agency-wide; 15 min). Returns {ok: true, claim_id, expires_at} or {ok: false, held_by, since, expires_at} when someone else holds it: then don't write, ask or wait. A concept claim warns when you're not its editor and sets you as editor when it has none.",
+  {
+    account_id: z.string().describe("Brand id from list_brands (house_rules: any brand of the agency, or the agency)"),
+    kind: z.enum(["concept", "inventory", "brand_shared", "house_rules"]),
+    ref: z.string().optional().describe("Concept id, for kind concept"),
+    note: z.string().optional().describe("What you're doing, e.g. \"render v2 of the 9:16\""),
+  },
+  async (args) => ok(await rpc("claim_work", args))
+);
+
+server.tool(
+  "renew_claim",
+  "Extend a claim you hold (long renders, long inventory runs). Returns the new expires_at. Fails when it already expired or was released: claim again.",
+  { claim_id: z.string() },
+  async (args) => ok(await rpc("renew_claim", args))
+);
+
+server.tool(
+  "release_work",
+  "Release a claim as soon as you're done writing, so the next editor can start.",
+  { claim_id: z.string() },
+  async (args) => ok(await rpc("release_work", args))
+);
+
+server.tool(
+  "list_claims",
+  "Active claims: who is working on what right now, since when, until when. With a brand's account_id: that brand plus the agency-wide house_rules claim; empty: every brand.",
+  { account_id: z.string().optional() },
+  async (args) => ok(await rpc("list_claims", args))
+);
+
+// ── Deliverables ──────────────────────────────────────────────────────────────
+// Never guess a file name: LOTUX generates it (the brand's naming convention)
+// and moves the "Concept <code>" folder between stage folders. Versions stay
+// with you: <base_name>.mp4, then <base_name>_v2.mp4, _v3 …; move the previous
+// version into archive_folder. _var<N> is a variation (its own concept), not a version.
+
+server.tool(
+  "get_deliverable",
+  "The file name and folder for one deliverable: base_name (exactly the name LOTUX generates for that hook and language, without extension or version), extension (mp4 for video), folder (the concept's current stage folder in Dropbox, /CLIENTS/Active/<Brand>/01_video/02_deliverables/<stage>/Concept <code>) and archive_folder (folder + /Archive). Name the concept by concept_id, or account_id + code (\"8\" or \"c8\"); variation 2 = the concept's _Var2.",
+  {
+    concept_id: z.string().optional(),
+    account_id: z.string().optional().describe("Brand id, with code"),
+    code: z.string().optional().describe("Concept code, e.g. 8 or c8"),
+    hook: z.string().describe("h1, h2, h3 … (h for a single hook, \"Hook 2\" works too), b1 for the body-only export"),
+    language: z.string().optional().describe("English / en … (default: the concept's base language)"),
+    variation: z.number().int().optional().describe("2 for the concept's _Var2"),
+    kind: z.enum(["video", "static", "carousel"]).optional().describe("Default video"),
+  },
+  async (args) => ok(await rpc("get_deliverable", args))
+);
+
+server.tool(
+  "list_deliverables",
+  "Every deliverable name of a concept: base_name per hook and language, for the concept and for each of its variations, each with its folder and archive_folder.",
+  {
+    concept_id: z.string().optional(),
+    account_id: z.string().optional().describe("Brand id, with code"),
+    code: z.string().optional(),
+  },
+  async (args) => ok(await rpc("list_deliverables", args))
+);
+
 server.tool(
   "list_entities",
   "List a brand's products, personas, angles, use-cases and offers (the building blocks for a concept). Pass account_id from list_brands.",
@@ -412,28 +536,28 @@ server.tool(
 
 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.",
+  "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.",
   {},
   async () => ok(await rpc("list_kb_workspaces"))
 );
 
 server.tool(
   "list_kb_docs",
-  "List the pages in a Kennisbank workspace (id, title, folder path). 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). 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.",
+  "Read one Kennisbank page's full markdown content by id. Only pages in the \"Exposed to MCP\" section can be read.",
   { 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. Returns the new doc id. content is markdown; folder_id is optional (root if omitted).",
+  "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.",
   {
     workspace_id: z.string().describe("Workspace id from list_kb_workspaces"),
     title: z.string(),
@@ -445,7 +569,7 @@ server.tool(
 
 server.tool(
   "update_kb_doc",
-  "Update a Kennisbank page's title and/or markdown content. Omitted fields are left unchanged.",
+  "Update a Kennisbank page's title and/or markdown content (pages in the \"Exposed to MCP\" section only). Omitted fields are left unchanged.",
   {
     doc_id: z.string(),
     title: z.string().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lotux-mcp",
-  "version": "0.10.3",
+  "version": "0.16.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": {