lotux-mcp 0.8.0 → 0.10.0

package/README.md

@@ -64,7 +64,8 @@ Restart Claude, then try: *"list my LOTUX brands"*.
 | `iterate_concept` | Spawn a variation ({root}_Var{n}), the same as the app's Iterate button |
 | `list_kb_*` / `get_kb_doc` / `create_kb_doc` / `update_kb_doc` | Kennisbank pages |
 | `content_options` / `create_flywheel` / `update_flywheel` / `list_flywheels` / `get_flywheel` | Content flywheels (Marketing → Content, agency-only): one long-form video. Start with `content_options`; give flywheels a `key` so re-runs reuse them |
-| `push_assets` / `add_asset` / `get_asset` / `list_assets` / `update_asset` / `set_asset_status` / `add_comment` / `delete_asset` | Content assets, upserted on their `key`. Statuses: scripting → production → post_production → to_review → revisions → approved → live. Content you write lands in `to_review`; Claude can't set revisions, approve or mark live; deleting signed-off work needs `force` |
+| `push_assets` / `add_asset` / `get_asset` / `list_assets` / `update_asset` / `set_asset_status` / `add_comment` / `delete_asset` | Content assets, upserted on their `key`. Statuses: scripting → production → post_production → to_review → revisions → approved → live. Content you write lands in `to_review`; Claude can't set revisions, approve or mark live; deleting signed-off work needs `force`. Each asset carries `raw_footage_url` (raw files folder) and `final_asset_url` (the export — a change sends it to review), plus its content ID (`code`) and `name` = `"<code> - <title>"`; pass `code` instead of `asset_id` anywhere |
+| `get_setup_checks` / `set_setup_check` | A flywheel's setup checklist (Instagram auto-replies, setter replies, reel covers, YouTube, Klaviyo flow) — tick a step by `check_key` after doing it |
 
 Beats (`add_beat`, `update_beat`, `delete_beat`, `set_beat_translation`, `add_language`) were
 retired in Sep 2026 — scripts are documents now. Calling one returns a message pointing at the

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.8.0" });
+const server = new McpServer({ name: "lotux", version: "0.10.0" });
 
 // ── Reads ─────────────────────────────────────────────────────────────────────
 
@@ -481,6 +481,7 @@ const flywheelRef = {
 };
 const assetRef = {
   asset_id: z.string().optional(),
+  code: z.union([z.string(), z.number()]).optional().describe('The content ID ("57") instead of asset_id'),
   key: z.string().optional().describe("The asset's key — with flywheel_id or flywheel_key — instead of asset_id"),
   ...flywheelRef,
 };
@@ -503,8 +504,11 @@ const assetFields = {
   body: z.string().optional().describe("Markdown content. long_form: YouTube description + chapters"),
   attachments: z.array(attachment).optional().describe("Replaces all links (Figma, Drive, Dropbox…)"),
   cover_url: z.string().optional().describe("long_form: thumbnail · clip / creator_video: reel cover"),
+  raw_footage_url: z.string().optional().describe("Folder with the raw footage this piece is cut from (Dropbox / Drive). Several assets may share one"),
+  final_asset_url: z.string().optional().describe("The exported deliverable (file or folder link). Signed off with the asset"),
   published_url: z.string().optional(),
   notes: z.string().optional(),
+  klaviyo_message_id: z.string().optional().describe("Email cards: the Klaviyo flow message id this card became (after the flow is built)"),
 };
 
 server.tool(
@@ -547,6 +551,8 @@ server.tool(
     transcript: z.string().optional(),
     notes: z.string().optional(),
     new_key: z.string().optional().describe("Give the flywheel a (new) key"),
+    klaviyo_flow_id: z.string().optional().describe("The Klaviyo flow built for this video (LM · <key>) — ticks the Klaviyo flow setup check"),
+    klaviyo_campaign_id: z.string().optional().describe("The Klaviyo keep-warm campaign — ticks the keep-warm setup check"),
     account_id: z.string().optional(),
   },
   async (args) => ok(await rpc("update_flywheel", args))
@@ -578,7 +584,7 @@ server.tool(
 
 server.tool(
   "push_assets",
-  "Push many assets into a flywheel in one call (max 100). Each item is upserted on its `key`: new keys are created (asset_type + title required), existing keys are updated with only the fields you send. Content lands in to_review. Returns counts + per-item { key, id, created, status, link, warnings } or { key, error }.",
+  "Push many assets into a flywheel in one call (max 100). Each item is upserted on its `key`: new keys are created (asset_type + title required), existing keys are updated with only the fields you send. Content lands in to_review. Every piece gets a content ID; its name is \"<code> - <title>\" (use it for file names). Returns counts + per-item { key, id, code, name, created, status, link, warnings } or { key, error }.",
   {
     ...flywheelRef,
     assets: z.array(z.object({ key: z.string().optional(), ...assetFields })).max(100),
@@ -601,7 +607,7 @@ server.tool(
 
 server.tool(
   "get_asset",
-  "One asset in full — body, attachments, cover/thumbnail, resolved link, warnings — plus its activity (status changes and comments, newest first). Use it to read what a human asked to change.",
+  "One asset in full — body, attachments, cover/thumbnail, raw footage + final asset links, resolved link, warnings — plus its activity (status changes and comments, newest first). Use it to read what a human asked to change.",
   { ...assetRef, account_id: z.string().optional() },
   async (args) => ok(await rpc("get_asset", args))
 );
@@ -612,6 +618,7 @@ server.tool(
   {
     ...flywheelRef,
     key: z.string().optional(),
+    code: z.union([z.string(), z.number()]).optional().describe('A content ID ("57")'),
     asset_type: z.array(z.enum(ASSET_TYPES)).optional(),
     status: z.array(z.enum(STATUSES)).optional(),
     platform: z.array(z.enum(PLATFORMS)).optional().describe("Matches the main platform or a cross-post"),
@@ -629,7 +636,7 @@ server.tool(
 
 server.tool(
   "update_asset",
-  "Update an asset by asset_id (or flywheel + key). Changing body, attachments or cover_url moves it to to_review (even if it was approved) so a human signs it off. Omitted fields are left unchanged.",
+  "Update an asset by asset_id (or flywheel + key). Changing body, attachments, cover_url or final_asset_url moves it to to_review (even if it was approved) so a human signs it off. Omitted fields are left unchanged.",
   {
     ...assetRef,
     ...assetFields,
@@ -666,6 +673,26 @@ server.tool(
   async (args) => ok(await rpc("delete_asset", args))
 );
 
+server.tool(
+  "get_setup_checks",
+  "A flywheel's setup checklist: the steps outside LOTUX (Instagram auto-reply per lead-magnet DM keyword, setter saved reply per booking keyword, reel covers, YouTube scheduling, the Klaviyo flow + keep-warm campaign). Each with check_key, status (open / done / n_a), due date, owner, and whether LOTUX ticks it itself (auto).",
+  { ...flywheelRef, account_id: z.string().optional() },
+  async (args) => ok(await rpc("get_setup_checks", args))
+);
+
+server.tool(
+  "set_setup_check",
+  "Tick a setup step after you did it (e.g. check_key \"dm-keyword:EXIT\" once the Instagram auto-reply is set up AND tested). status done / open / n_a, plus an optional note. Auto checks (klaviyo-*) tick themselves. Logged as done by Claude.",
+  {
+    ...flywheelRef,
+    check_key: z.string().describe('From get_setup_checks, e.g. "dm-keyword:EXIT", "reel-covers", "youtube"'),
+    status: z.enum(["open", "done", "n_a"]).optional(),
+    note: z.string().optional(),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("set_setup_check", args))
+);
+
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

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