lotux-mcp 0.1.2 → 0.3.0

package/index.mjs

@@ -52,7 +52,7 @@ const ok = (result) => ({
   content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
 });
 
-const server = new McpServer({ name: "lotux", version: "0.1.2" });
+const server = new McpServer({ name: "lotux", version: "0.3.0" });
 
 // ── Reads ─────────────────────────────────────────────────────────────────────
 
@@ -113,7 +113,7 @@ server.tool(
 
 server.tool(
   "create_concept",
-  "Create a new concept in the brand's first (Idea) stage, optionally linking products/personas/angles/use-cases. Returns the new concept id. A human moves it through the copy-check gate later in the app.",
+  "Create a new concept in the brand's first (Idea) stage, optionally linking products/personas/angles/use-cases. Returns { id, beat_ids } — the concept id plus the ids of 3 pre-seeded empty Hook beats. Fill those 3 with update_beat; do NOT add_beat for the first three hooks or you get duplicates. A human moves the concept through the copy-check gate later in the app.",
   {
     account_id: z.string().describe("Brand id from list_brands"),
     title: z.string(),
@@ -132,9 +132,10 @@ server.tool(
 
 server.tool(
   "set_concept_fields",
-  "Update fields on an existing concept. Any omitted field is left unchanged; the id arrays, when given, replace the full set of links. Assign team roles by passing a person id from list_members into strategist_id / copy_checker_id / editor_id / media_buyer_id / final_check_id.",
+  "Update fields on an existing concept — including renaming it via title. Any omitted field is left unchanged; the id arrays, when given, replace the full set of links. Assign team roles by passing a person id from list_members into strategist_id / copy_checker_id / editor_id / media_buyer_id / final_check_id.",
   {
     concept_id: z.string(),
+    title: z.string().optional().describe("Rename the concept (blank is ignored — title is required)"),
     funnel_stage: z.string().optional(),
     format: z.string().optional(),
     messaging_framework: z.string().optional(),
@@ -164,28 +165,89 @@ server.tool(
 
 server.tool(
   "add_beat",
-  "Add a script beat (Hook / Body / CTA) to a concept. `text` is the spoken/script line shown in the Script tab's VO/TH/TEXT field. Returns the new beat id.",
+  "Add a script beat (Hook / Body / CTA) to a concept. `text` is the spoken/script line shown in the Script tab's VO/TH/TEXT field. Returns the new beat id. NOTE: new concepts already come with 3 empty Hook beats (see create_concept) — fill those with update_beat first; only add_beat for extra beats beyond them.",
   {
     concept_id: z.string(),
     beat_type: z.enum(["hook", "body", "cta"]).optional(),
     text: z.string().optional().describe("The script line / what's said (the visible beat text)"),
     visual_note: z.string().optional().describe("Optional on-screen visual note"),
+    delivery_kind: z
+      .enum(["voiceover", "talking_head", "text_on_screen"])
+      .optional()
+      .describe("Per-beat delivery type dropdown"),
   },
   async (args) => ok(await rpc("add_beat", args))
 );
 
 server.tool(
   "update_beat",
-  "Update an existing script beat's script text, type, or visual note.",
+  "Update an existing script beat's script text, type, delivery kind, or visual note. Use this (not add_beat) to edit a beat — the beat_id comes from create_concept or get_concept.",
   {
     beat_id: z.string(),
     beat_type: z.enum(["hook", "body", "cta"]).optional(),
     delivery_text: z.string().optional().describe("The script line / what's said"),
     visual_note: z.string().optional(),
+    delivery_kind: z
+      .enum(["voiceover", "talking_head", "text_on_screen"])
+      .optional()
+      .describe("Per-beat delivery type dropdown"),
   },
   async ({ beat_id, ...patch }) => ok(await rpc("update_beat", { beat_id, patch }))
 );
 
+server.tool(
+  "delete_beat",
+  "Delete a script beat by id (its translations are removed with it). Use to remove a wrong or leftover beat instead of blanking its text.",
+  { beat_id: z.string() },
+  async ({ beat_id }) => ok(await rpc("delete_beat", { beat_id }))
+);
+
+server.tool(
+  "set_beats",
+  "Set a concept's ENTIRE script in one call (the efficient way to build or restructure beats). AUTHORITATIVE: the beats array becomes the full ordered script — order = array order, beats with an id are updated in place, id-less beats are inserted, and any existing beat you omit is deleted. Preserves translations on kept beats. Returns { beat_ids } in final order — feed those to set_beat_translation for per-language text. Prefer this over repeated add_beat/update_beat/delete_beat. Read the current beats with get_concept first so you resend the ones you want to keep.",
+  {
+    concept_id: z.string(),
+    beats: z
+      .array(
+        z.object({
+          id: z.string().optional().describe("Existing beat id to update; omit to insert a new beat"),
+          beat_type: z.enum(["hook", "body", "cta"]).optional(),
+          text: z.string().optional().describe("The script line / what's said"),
+          visual_note: z.string().optional(),
+          delivery_kind: z.enum(["voiceover", "talking_head", "text_on_screen"]).optional(),
+        })
+      )
+      .describe("The full ordered beat list. Anything not included is deleted."),
+  },
+  async (args) => ok(await rpc("set_beats", args))
+);
+
+server.tool(
+  "set_beat_translations",
+  "Write one language's ENTIRE translated script in a single call (the efficient partner to set_beats). Registers the language (if new) and upserts each beat's translated line. Prefer this over repeated add_language + set_beat_translation. beat_id values come from set_beats or get_concept; language is a full-written name (e.g. Dutch).",
+  {
+    concept_id: z.string(),
+    language: z.string().describe("Full-written name, e.g. Dutch"),
+    items: z
+      .array(
+        z.object({
+          beat_id: z.string(),
+          text: z.string().optional().describe("The translated script line"),
+          visual_note: z.string().optional(),
+        })
+      )
+      .describe("One entry per beat to translate for this language"),
+  },
+  async (args) => ok(await rpc("set_beat_translations", args))
+);
+
+server.tool(
+  "delete_concept",
+  "Delete an entire concept by id. Removes its beats, translations, entity links and copy links. Irreversible — confirm the id via list_concepts / get_concept first.",
+  { concept_id: z.string() },
+  async ({ concept_id }) => ok(await rpc("delete_concept", { concept_id }))
+);
+
 server.tool(
   "set_base_language",
   "Set the concept's base script language (the 'Original' tab), e.g. English.",
@@ -239,6 +301,97 @@ server.tool(
   async (args) => ok(await rpc("link_copy", args))
 );
 
+server.tool(
+  "unlink_copy",
+  "Unlink a copy item from a concept. The copy stays in the brand library; only the link is removed.",
+  { concept_id: z.string(), copy_item_id: z.string() },
+  async (args) => ok(await rpc("unlink_copy", args))
+);
+
+// ── Brand-DB entities (products / personas / angles / use-cases) ────────────────
+
+server.tool(
+  "create_entity",
+  "Create a brand-DB entity (persona / product / use_case / angle). name is required; description optional. `extras` carries the typed fields (e.g. persona awareness_stage/hypothesis, angle core idea via description + belief_shift, product average_price/margin_pct) — omit if unknown. Personas/use_cases/angles get an auto id_code (p1/u1/a1), returned in the result. Link it to a concept afterwards with set_concept_fields.",
+  {
+    account_id: z.string().describe("Brand id from list_brands"),
+    kind: z.enum(["products", "personas", "angles", "use_cases"]),
+    name: z.string(),
+    description: z.string().optional(),
+    extras: z.record(z.any()).optional().describe("Typed fields keyed by column name (see list_entities output shape)"),
+  },
+  async (args) => ok(await rpc("create_entity", args))
+);
+
+server.tool(
+  "update_entity",
+  "Update a brand-DB entity by id. Omitted fields are left unchanged; a blank name is ignored (name is required). Use extras to patch typed fields.",
+  {
+    entity_id: z.string(),
+    kind: z.enum(["products", "personas", "angles", "use_cases"]),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    extras: z.record(z.any()).optional(),
+  },
+  async (args) => ok(await rpc("update_entity", args))
+);
+
+server.tool(
+  "delete_entity",
+  "Delete a brand-DB entity by id. Its links to concepts are removed with it. Irreversible — confirm via list_entities first.",
+  {
+    entity_id: z.string(),
+    kind: z.enum(["products", "personas", "angles", "use_cases"]),
+  },
+  async (args) => ok(await rpc("delete_entity", args))
+);
+
+// ── Kennisbank (knowledge base) ─────────────────────────────────────────────────
+
+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.",
+  {},
+  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.",
+  { 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.",
+  { 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).",
+  {
+    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(),
+  },
+  async (args) => ok(await rpc("create_kb_doc", args))
+);
+
+server.tool(
+  "update_kb_doc",
+  "Update a Kennisbank page's title and/or markdown content. Omitted fields are left unchanged.",
+  {
+    doc_id: z.string(),
+    title: z.string().optional(),
+    content: z.string().optional().describe("Markdown body (replaces the page content)"),
+  },
+  async (args) => ok(await rpc("update_kb_doc", args))
+);
+
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

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