lotux-mcp 0.8.1 → 0.10.2

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`. Each asset carries `raw_footage_url` (raw files folder) and `final_asset_url` (the export — a change sends it to review) |
+| `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 → ready_for_post → 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.1" });
+const server = new McpServer({ name: "lotux", version: "0.10.2" });
 
 // ── Reads ─────────────────────────────────────────────────────────────────────
 
@@ -464,10 +464,10 @@ server.tool(
 // (defaults to your agency). Call content_options first for the allowed values.
 
 const PLATFORMS = ["youtube", "youtube_shorts", "instagram", "tiktok", "linkedin", "x", "email", "meta_ads", "opt_in_page", "google_doc", "internal"];
-// Statuses follow production. You may set the first four; revisions,
+// Statuses follow production. You may set the first five; revisions,
 // approved and live are a human's call.
-const STATUSES = ["scripting", "production", "post_production", "to_review", "revisions", "approved", "live"];
-const CLAUDE_STATUSES = ["scripting", "production", "post_production", "to_review"];
+const STATUSES = ["scripting", "production", "ready_for_post", "post_production", "to_review", "revisions", "approved", "live"];
+const CLAUDE_STATUSES = ["scripting", "production", "ready_for_post", "post_production", "to_review"];
 // video = "To long form".
 const CTAS = ["none", "video", "lead_magnet", "dm_keyword", "booking", "follow"];
 // long_form carries the YouTube pieces: title = YouTube title, body =
@@ -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,
 };
@@ -507,6 +508,7 @@ const assetFields = {
   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(
@@ -549,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>, 4 emails for sign-ups); its setup check ticks once the flow is live"),
+    klaviyo_campaign_id: z.string().optional().describe("The Klaviyo announcement campaign (one \"new video\" email to the list); its setup check ticks once it is scheduled"),
     account_id: z.string().optional(),
   },
   async (args) => ok(await rpc("update_flywheel", args))
@@ -580,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),
@@ -614,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"),
@@ -644,7 +649,7 @@ server.tool(
 
 server.tool(
   "set_asset_status",
-  "Move an asset through scripting, production, post_production or to_review (to_review hands it to a human). Revisions, approved and live are a human's call in LOTUX.",
+  "Move an asset through scripting, production, ready_for_post, post_production or to_review (to_review hands it to a human). Revisions, approved and live are a human's call in LOTUX.",
   {
     ...assetRef,
     status: z.enum(CLAUDE_STATUSES),
@@ -668,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, 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-*, lead-magnet-page) 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.1",
+  "version": "0.10.2",
   "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": {