lotux-mcp 0.5.2 → 0.8.0

package/README.md

@@ -59,8 +59,12 @@ Restart Claude, then try: *"list my LOTUX brands"*.
 | `save_script` | Write a script: markdown body for one language (`- **Hook:** …`, `- **1:** …`, `- **CTA:** …`), the shotlist, a rename. Pass `language` for a translation |
 | `add_script` / `delete_script` / `remove_script_language` / `set_base_language` | More scripts per concept; language housekeeping |
 | `set_beats` / `set_beat_translations` | **Compatibility** for older prompts: a beat list is stored as the script document. Prefer `save_script` |
-| `list_copy` / `create_copy` / `link_copy` / `unlink_copy` / `add_copy_translation` | Ad copy library + concept links |
+| `list_copy` / `create_copy` / `update_copy` / `delete_copy` / `link_copy` / `unlink_copy` / `add_copy_translation` | Ad copy library + concept links. `update_copy` edits in place; `delete_copy` removes it everywhere (status stays app-only) |
+| `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` |
 
 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.5.1" });
+const server = new McpServer({ name: "lotux", version: "0.8.0" });
 
 // ── Reads ─────────────────────────────────────────────────────────────────────
 
@@ -157,6 +157,14 @@ server.tool(
     angle_ids: z.array(z.string()).optional(),
     use_case_ids: z.array(z.string()).optional(),
     offer_ids: z.array(z.string()).optional(),
+    landing_page_ids: z
+      .array(z.string())
+      .optional()
+      .describe("Landing page ids from list_landing_pages; replaces the concept's set"),
+    landing_page_id: z
+      .string()
+      .optional()
+      .describe("Convenience for a single landing page — ignored if landing_page_ids is given"),
     // Team roles — pass a member id from list_members.
     strategist_id: z.string().optional().describe("Member id from list_members"),
     copy_checker_id: z.string().optional().describe("Member id from list_members"),
@@ -164,8 +172,14 @@ server.tool(
     media_buyer_id: z.string().optional().describe("Member id from list_members"),
     final_check_id: z.string().optional().describe("Member id from list_members"),
   },
-  async ({ concept_id, ...patch }) =>
-    ok(await rpc("set_concept_fields", { concept_id, patch }))
+  // A concept can run several landing pages (one per market), so the column is
+  // a list. Fold the single-id convenience into it; an explicit list wins.
+  async ({ concept_id, landing_page_id, ...patch }) => {
+    if (landing_page_id && patch.landing_page_ids === undefined) {
+      patch.landing_page_ids = [landing_page_id];
+    }
+    return ok(await rpc("set_concept_fields", { concept_id, patch }));
+  }
 );
 
 // ── Scripts (document model) ────────────────────────────────────────────────
@@ -288,6 +302,29 @@ server.tool(
   async (args) => ok(await rpc("unlink_copy", args))
 );
 
+server.tool(
+  "update_copy",
+  "Edit an existing copy item in place (fix a typo, correct the language or the product). Only the fields you pass change. Status is deliberately not settable here — approving or rejecting stays in the app.",
+  {
+    copy_item_id: z.string().describe("From list_copy or get_concept"),
+    text: z.string().optional(),
+    type: z.enum(["adcopy", "headline", "description"]).optional(),
+    product_ids: z.array(z.string()).optional(),
+    promotion: z.string().optional(),
+    country: z.string().optional(),
+    language: z.string().optional().describe("Full-written name, e.g. English"),
+    funnel_stage: z.string().optional(),
+  },
+  async (args) => ok(await rpc("update_copy", args))
+);
+
+server.tool(
+  "delete_copy",
+  "Delete a copy item from the brand library. It disappears from every concept it was linked to. To keep the copy and remove it from one concept, use unlink_copy instead.",
+  { copy_item_id: z.string() },
+  async (args) => ok(await rpc("delete_copy", args))
+);
+
 server.tool(
   "add_copy_translation",
   "Add a language variant to an existing copy ('primary text') so it reads as one copy with a language switcher in the app. Clones the base copy's products/promotion/country/funnel with a new language + text and groups them (translation_group_id). base_copy_id comes from list_copy or get_concept; language is a full-written name (e.g. Dutch). Optionally pass concept_id to also link the new variant to that concept. Returns the new copy id.",
@@ -300,6 +337,39 @@ server.tool(
   async (args) => ok(await rpc("add_copy_translation", args))
 );
 
+// ── Landing pages ────────────────────────────────────────────────────────
+
+server.tool(
+  "list_landing_pages",
+  "A brand's landing pages, plus the agency-wide pool. Use it to get an id for set_concept_fields (landing_page_id / landing_page_ids) or for an offer's landing_page_id.",
+  { account_id: z.string().describe("Brand id from list_brands") },
+  async (args) => ok(await rpc("list_landing_pages", args))
+);
+
+server.tool(
+  "create_landing_page",
+  "Create a landing page for a brand. `type` is required and feeds the ad-name token (pdp = product page, hp = homepage, cp = category page, li = listicle, adv = advertorial, lp = landing page). `id_code` is the short suffix ad names use (pdpa1). Tag `country` when the brand runs several markets — that is how a concept picks the right page.",
+  {
+    account_id: z.string().describe("Brand id from list_brands"),
+    title: z.string().describe("The page's name in LOTUX"),
+    url: z.string(),
+    type: z.enum(["pdp", "hp", "cp", "li", "adv", "lp"]),
+    id_code: z.string().optional(),
+    country: z.string().optional().describe("2-letter code, e.g. NL"),
+    language: z.string().optional().describe("Full-written name, e.g. Dutch"),
+  },
+  async (args) => ok(await rpc("create_landing_page", args))
+);
+
+// ── Iterate ──────────────────────────────────────────────────────────────
+
+server.tool(
+  "iterate_concept",
+  "Spawn a variation of a concept, the same as the app's Iterate button. The new concept is coded {root}_Var{n} (89 becomes 89_Var1), lands in Idea, and inherits the products / personas / angles / offers, team, brief, scripts, copy and references. Variations are flat: iterating 89_Var2 makes 89_Var3 off 89. Timeline, media buying and landing pages are reset, and base_language goes back to English even though the copied script texts keep their own languages. Returns { id, concept_code, script_id }; script_id is null when the source had no script.",
+  { concept_id: z.string() },
+  async (args) => ok(await rpc("iterate_concept", args))
+);
+
 // ── Brand-DB entities (products / personas / angles / use-cases / offers) ──────
 
 server.tool(
@@ -384,6 +454,218 @@ 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"),
+  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, 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 or cover_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.5.2",
+  "version": "0.8.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": {