lotux-mcp 0.5.1 → 0.6.0

package/README.md

@@ -59,7 +59,9 @@ 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 |
 
 Beats (`add_beat`, `update_beat`, `delete_beat`, `set_beat_translation`, `add_language`) were

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.6.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) ────────────────────────────────────────────────
@@ -257,6 +271,23 @@ server.tool(
   async (args) => ok(await rpc("set_base_language", args))
 );
 
+server.tool(
+  "create_copy",
+  "Create a brand-scoped ad copy item (adcopy / headline / description) and link it to a concept. Returns the new copy id. To add another language to an existing copy use add_copy_translation instead.",
+  {
+    account_id: z.string().describe("Brand id from list_brands"),
+    concept_id: z.string(),
+    type: z.enum(["adcopy", "headline", "description"]),
+    text: z.string(),
+    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("create_copy", args))
+);
+
 server.tool(
   "link_copy",
   "Link an existing copy item to a concept.",
@@ -271,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.",
@@ -283,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(

package/package.json

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