lotux-mcp 0.6.0 → 0.8.1

package/README.md

@@ -63,6 +63,8 @@ Restart Claude, then try: *"list my LOTUX brands"*.
 | `list_landing_pages` / `create_landing_page` | A brand's landing pages + the agency pool; link them with `set_concept_fields` |
 | `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) |
 
 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.6.0" });
+const server = new McpServer({ name: "lotux", version: "0.8.1" });
 
 // ── Reads ─────────────────────────────────────────────────────────────────────
 
@@ -454,6 +454,220 @@ server.tool(
   async (args) => ok(await rpc("update_kb_doc", args))
 );
 
+// ── Content flywheels (Marketing → Content, agency-only) ─────────────────────
+// A flywheel = one long-form YouTube video + every asset made from it. LOTUX
+// only TRACKS content: creating a flywheel creates no assets — your skills push
+// them (push_assets / add_asset). Anything you write lands in "to_review"; a
+// human approves in LOTUX. Built for re-runs: give flywheels and assets a stable
+// `key` (flywheel = the video's content folder, asset = e.g. "clip-3") and every
+// push updates instead of duplicating. account_id is optional everywhere
+// (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,
+// 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"];
+// video = "To long form".
+const CTAS = ["none", "video", "lead_magnet", "dm_keyword", "booking", "follow"];
+// long_form carries the YouTube pieces: title = YouTube title, body =
+// description + chapters, cover_url = thumbnail. clip / creator_video: cover_url
+// = reel cover.
+const ASSET_TYPES = ["long_form", "clip", "creator_video", "story_sequence", "carousel", "post", "email", "vsl_ad", "follower_ad", "lead_magnet_ad", "lead_magnet_page", "other"];
+const attachment = z.object({ url: z.string(), label: z.string().optional() });
+const flywheelRef = {
+  flywheel_id: z.string().optional(),
+  flywheel_key: z.string().optional().describe("The key you gave the flywheel (instead of flywheel_id)"),
+};
+const assetRef = {
+  asset_id: z.string().optional(),
+  key: z.string().optional().describe("The asset's key — with flywheel_id or flywheel_key — instead of asset_id"),
+  ...flywheelRef,
+};
+// Every asset field. Omitted = left as is (on update) or the type's default (on create).
+const assetFields = {
+  asset_type: z.enum(ASSET_TYPES).optional(),
+  title: z.string().optional().describe("Card title. long_form: the YouTube title"),
+  platform: z.enum(PLATFORMS).optional().describe("Defaults from the type"),
+  cross_post: z.array(z.enum(PLATFORMS)).optional().describe("Also posted on (defaults from the type)"),
+  account: z.enum(["personal", "company"]).optional().describe("personal = Niels, company = the agency"),
+  cta: z.enum(CTAS).optional(),
+  dm_keyword: z.string().optional(),
+  dm_reply: z.enum(["booking", "lead_magnet"]).optional().describe("For a dm_keyword CTA: what the DM reply sends"),
+  destination_url: z.string().optional().describe("Override the flywheel URL this CTA would use"),
+  posting_date: z.string().optional().describe("YYYY-MM-DD"),
+  deadline: z.string().optional().describe("YYYY-MM-DD; defaults to posting date − the agency's lead days"),
+  owner: z.string().optional().describe('"claude", "none" or a profile id (see content_options.owners)'),
+  status: z.enum(CLAUDE_STATUSES).optional(),
+  must_post: z.boolean().optional(),
+  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(),
+};
+
+server.tool(
+  "content_options",
+  "Allowed values for content: asset types (with their default platform / cross-posts / CTA and what body + cover_url mean), platforms, CTAs, DM reply targets, accounts, statuses (and which you may set), owners (team members + claude), the default deadline lead and the rules. Call this first.",
+  { account_id: z.string().optional() },
+  async (args) => ok(await rpc("content_options", args))
+);
+
+server.tool(
+  "create_flywheel",
+  "Create a content flywheel for a long-form YouTube video. With a key that already exists you get that flywheel back (created: false) — safe to re-run. Creates no assets. Returns { id, created }.",
+  {
+    key: z.string().optional().describe("Your stable id for this video, e.g. the content folder '2026-10 Claude Code'"),
+    title: z.string().describe("Video title"),
+    d0: z.string().describe("Long-form publish date, YYYY-MM-DD"),
+    topic: z.string().optional(),
+    youtube_url: z.string().optional(),
+    lead_magnet_url: z.string().optional().describe("Lead magnet page: email form that redirects to the video"),
+    booking_url: z.string().optional(),
+    transcript: z.string().optional().describe("Full transcript text"),
+    notes: z.string().optional(),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("create_flywheel", args))
+);
+
+server.tool(
+  "update_flywheel",
+  "Update a flywheel: title, topic, status, URLs, transcript, notes. Changing d0 moves every asset that isn't live by the same number of days. Omitted fields are left unchanged.",
+  {
+    ...flywheelRef,
+    title: z.string().optional(),
+    topic: z.string().optional(),
+    d0: z.string().optional().describe("YYYY-MM-DD — shifts the assets with it"),
+    status: z.enum(["planning", "production", "live", "done"]).optional(),
+    youtube_url: z.string().optional(),
+    lead_magnet_url: z.string().optional(),
+    booking_url: z.string().optional(),
+    transcript: z.string().optional(),
+    notes: z.string().optional(),
+    new_key: z.string().optional().describe("Give the flywheel a (new) key"),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("update_flywheel", args))
+);
+
+server.tool(
+  "list_flywheels",
+  "List content flywheels with progress (approved / total), next deadline and overdue count. Filter by status, a title/key search, or an exact key.",
+  {
+    status: z.enum(["planning", "production", "live", "done"]).optional(),
+    query: z.string().optional().describe("Matches the title or key"),
+    key: z.string().optional(),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("list_flywheels", args))
+);
+
+server.tool(
+  "get_flywheel",
+  "One flywheel and all its assets (each with `link` = where its CTA / DM reply points, and `warnings`). Bodies and the transcript only when asked.",
+  {
+    ...flywheelRef,
+    include_bodies: z.boolean().optional(),
+    include_transcript: z.boolean().optional(),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("get_flywheel", args))
+);
+
+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 }.",
+  {
+    ...flywheelRef,
+    assets: z.array(z.object({ key: z.string().optional(), ...assetFields })).max(100),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("push_assets", args))
+);
+
+server.tool(
+  "add_asset",
+  "Push one asset. With a key that exists on the flywheel it updates that asset instead. The type fills platform, cross-posts and CTA when you leave them out. With content it lands in to_review, owned by Claude; without, as an unassigned slot in scripting.",
+  {
+    ...flywheelRef,
+    key: z.string().optional(),
+    ...assetFields,
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("add_asset", args))
+);
+
+server.tool(
+  "get_asset",
+  "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))
+);
+
+server.tool(
+  "list_assets",
+  "Assets across flywheels with filters. Find work: status revisions (a human asked for changes), scripting + owner claude, posting_to next week, overdue.",
+  {
+    ...flywheelRef,
+    key: z.string().optional(),
+    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"),
+    account: z.enum(["personal", "company"]).optional(),
+    owner: z.string().optional().describe('"claude", "none" (unassigned) or a profile id'),
+    overdue: z.boolean().optional(),
+    posting_from: z.string().optional().describe("YYYY-MM-DD"),
+    posting_to: z.string().optional().describe("YYYY-MM-DD"),
+    include_bodies: z.boolean().optional(),
+    limit: z.number().int().min(1).max(500).optional(),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("list_assets", args))
+);
+
+server.tool(
+  "update_asset",
+  "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,
+    add_attachments: z.array(attachment).optional().describe("Appends links"),
+    new_key: z.string().optional().describe("Give the asset a (new) key"),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("update_asset", args))
+);
+
+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.",
+  {
+    ...assetRef,
+    status: z.enum(CLAUDE_STATUSES),
+    comment: z.string().optional().describe("Shown in the asset's activity"),
+    account_id: z.string().optional(),
+  },
+  async (args) => ok(await rpc("set_asset_status", args))
+);
+
+server.tool(
+  "add_comment",
+  "Leave a comment on an asset (shown in its activity in LOTUX).",
+  { ...assetRef, comment: z.string(), account_id: z.string().optional() },
+  async (args) => ok(await rpc("add_comment", args))
+);
+
+server.tool(
+  "delete_asset",
+  "Delete an asset. An approved or live one needs force: true.",
+  { ...assetRef, force: z.boolean().optional(), account_id: z.string().optional() },
+  async (args) => ok(await rpc("delete_asset", args))
+);
+
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

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