lotux-mcp 0.5.0 → 0.5.2

package/README.md

@@ -1,7 +1,7 @@
 # lotux-mcp
 
 Local MCP server that lets Claude (Desktop or Code) create and edit **LOTUX**
-concepts: fetch a brand's products / personas / angles / use-cases, create
+concepts: fetch a brand's products / personas / angles / use-cases / offers, create
 concepts, fill scripts, draft + link ad copy, and assign team members.
 
 It is a thin connector — all logic and data live in the LOTUX app. This package
@@ -51,7 +51,7 @@ Restart Claude, then try: *"list my LOTUX brands"*.
 | Tool | What it does |
 |------|--------------|
 | `list_brands` | Brands (+ agency) you can access |
-| `list_entities` / `create_entity` / `update_entity` / `delete_entity` | A brand's products / personas / angles / use-cases |
+| `list_entities` / `create_entity` / `update_entity` / `delete_entity` | A brand's products / personas / angles / use-cases / offers |
 | `list_concepts` / `get_concept` | Find a concept; read its full state (fields, links, **scripts** = markdown per language + shotlist, copy) |
 | `list_options` / `list_members` | Valid field values; assignable team members |
 | `create_concept` | New concept in Idea (+ optional links). Returns `{ id, script_id }` — write the script with `save_script` |

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.0" });
+const server = new McpServer({ name: "lotux", version: "0.5.1" });
 
 // ── Reads ─────────────────────────────────────────────────────────────────────
 
@@ -65,7 +65,7 @@ server.tool(
 
 server.tool(
   "list_entities",
-  "List a brand's products, personas, angles, and use-cases (the building blocks for a concept). Pass account_id from list_brands.",
+  "List a brand's products, personas, angles, use-cases and offers (the building blocks for a concept). Pass account_id from list_brands.",
   { account_id: z.string().describe("Brand (or agency) id from list_brands") },
   async ({ account_id }) => ok(await rpc("list_entities", { account_id }))
 );
@@ -257,6 +257,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.",
@@ -283,11 +300,11 @@ server.tool(
   async (args) => ok(await rpc("add_copy_translation", args))
 );
 
-// ── Brand-DB entities (products / personas / angles / use-cases) ────────────────
+// ── Brand-DB entities (products / personas / angles / use-cases / offers) ──────
 
 server.tool(
   "create_entity",
-  "Create a NEW brand-DB entity — a product, persona, use_case or angle that doesn't exist yet (to attach an EXISTING one to a concept, pass its id to set_concept_fields instead). name is required; description optional. `extras` carries the typed fields: products take average_price / margin_pct / cm_target (target contribution-margin %) / ltv_multiplier / be_ncroas / product_link / type / status; personas take awareness_stage / hypothesis; angles take belief_shift (core idea goes in description). Omit unknown fields. Personas/use_cases/angles get an auto id_code (p1/u1/a1), returned in the result. Link the new entity to a concept afterwards with set_concept_fields.",
+  "Create a NEW brand-DB entity — a product, persona, use_case, angle or offer that doesn't exist yet (to attach an EXISTING one to a concept, pass its id to set_concept_fields instead). name is required; description optional. `extras` carries the typed fields: products take average_price / margin_pct / cm_target (target contribution-margin %) / ltv_multiplier / be_ncroas / product_link / type / status; personas take awareness_stage / hypothesis; angles take belief_shift (core idea goes in description); offers take offer_type / value / starts_on / ends_on / landing_page_id / hypothesis / conclusion / status. Omit unknown fields. Personas/use_cases/angles/offers get an auto id_code (p1/u1/a1/o1), returned in the result. Link the new entity to a concept afterwards with set_concept_fields.",
   {
     account_id: z.string().describe("Brand id from list_brands"),
     kind: z.enum(["products", "personas", "angles", "use_cases", "offers"]),

package/package.json

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