lotux-mcp 0.18.0 → 0.21.0

package/index.mjs

@@ -10,7 +10,7 @@
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
+import { registerTools, SERVER_INFO } from "./tools.mjs";
 
 const API = (process.env.LOTUX_API_URL || "").replace(/\/$/, "");
 const TOKEN = process.env.LOTUX_MCP_TOKEN || "";
@@ -48,939 +48,8 @@ async function rpc(method, params = {}) {
   return data.result;
 }
 
-const ok = (result) => ({
-  content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-});
-
-const server = new McpServer({ name: "lotux", version: "0.18.0" });
-
-// ── Reads ─────────────────────────────────────────────────────────────────────
-
-server.tool(
-  "list_brands",
-  "List the LOTUX brands (and the agency) you can access, with each brand's slug and client_status (active / archived / internal). Use the returned id as account_id for other tools.",
-  {},
-  async () => ok(await rpc("list_brands"))
-);
-
-// ── Client workspaces (agency team only) ──────────────────────────────────────
-// Where a client's things live for the Cowork editors: Dropbox client folder,
-// raw-footage folders, the agentic workspace folder (01_CLIENTS/<slug>) and the
-// second brain (Kennisbank).
-
-server.tool(
-  "get_brand",
-  "One client's workspace settings: slug, client_status, second brain (Kennisbank id + name, shared with the client or not), workspace_folder, dropbox_client_path, raw_footage_paths, Claude project name, the Claude project kit (instructions text) and the active work claims.",
-  { account_id: z.string().describe("Brand id from list_brands") },
-  async (args) => ok(await rpc("get_brand", args))
-);
-
-server.tool(
-  "update_brand_settings",
-  "Change a client's workspace settings. Omitted fields stay as they are. slug is refused once client setup has run (it names the workspace folder). dropbox_client_path follows the Dropbox connection and workspace_folder follows the slug, so neither is set here.",
-  {
-    account_id: z.string().describe("Brand id from list_brands"),
-    client_status: z.enum(["active", "archived", "internal"]).optional(),
-    slug: z.string().optional().describe("Lowercase letters, digits and hyphens"),
-    kb_workspace_id: z.string().nullable().optional().describe("Kennisbank workspace id (list_kb_workspaces) to link as the second brain"),
-    raw_footage_paths: z.array(z.string()).optional().describe("Dropbox paths, e.g. /CLIENTS/Active/Dr. Kegel/01_video/01_raw footage"),
-    claude_project_name: z.string().optional(),
-  },
-  async (args) => ok(await rpc("update_brand_settings", args))
-);
-
-server.tool(
-  "run_client_setup",
-  "Run client setup for a brand: slug, second brain (an \"Agentic workspace\" page plus Client Feedback and Basic Rules folders in its \"Exposed to MCP\" section), the agentic workspace folder + CLIENT.md settings block, and (once the brand has connected Dropbox) the linked Dropbox client folder. It already runs by itself when a brand is created and when it connects Dropbox; run it again to fill gaps. Only creates what's missing; running it twice changes nothing. Skipped for clients that aren't active. dry_run: true returns the plan without changing anything. Returns a report per step (created / linked / updated / already there / failed + reason).",
-  {
-    account_id: z.string().describe("Brand id from list_brands"),
-    dry_run: z.boolean().optional(),
-  },
-  async (args) => ok(await rpc("run_client_setup", args))
-);
-
-server.tool(
-  "list_kb_folders",
-  "The folders in a Kennisbank workspace's \"Exposed to MCP\" section, the only part of a second brain the MCP can see (id, name, parent_id, path; parent_id null = directly in the section). Use a folder id as folder_id in create_kb_doc.",
-  { workspace_id: z.string().describe("Workspace id from list_kb_workspaces or get_brand") },
-  async (args) => ok(await rpc("list_kb_folders", args))
-);
-
-server.tool(
-  "create_kb_folder",
-  "Create a folder in a Kennisbank workspace's \"Exposed to MCP\" section (at its top level, or inside parent_id). Returns the folder id.",
-  {
-    workspace_id: z.string(),
-    name: z.string(),
-    parent_id: z.string().optional().describe("Parent folder id from list_kb_folders"),
-  },
-  async (args) => ok(await rpc("create_kb_folder", args))
-);
-
-// ── Work claims ───────────────────────────────────────────────────────────────
-// Several editors work on one client at once, never on the same piece. Claim
-// before you write files; the database decides who's first (Dropbox is too slow
-// for lock files). Claiming again while you hold it renews it.
-
-server.tool(
-  "claim_work",
-  "Claim a piece of work before writing files for it. kind: concept (ref = concept id; prep / edit / revise / re-render one concept; 6 h), inventory (the brand's inventory run; 6 h), brand_shared (files several concepts of the brand use: logos, shared media, shared code; 15 min), house_rules (the shared house rules or style spec, agency-wide; 15 min). Returns {ok: true, claim_id, expires_at} or {ok: false, held_by, since, expires_at} when someone else holds it: then don't write, ask or wait. A concept claim warns when you're not its editor and sets you as editor when it has none.",
-  {
-    account_id: z.string().describe("Brand id from list_brands (house_rules: any brand of the agency, or the agency)"),
-    kind: z.enum(["concept", "inventory", "brand_shared", "house_rules"]),
-    ref: z.string().optional().describe("Concept id, for kind concept"),
-    note: z.string().optional().describe("What you're doing, e.g. \"render v2 of the 9:16\""),
-  },
-  async (args) => ok(await rpc("claim_work", args))
-);
-
-server.tool(
-  "renew_claim",
-  "Extend a claim you hold (long renders, long inventory runs). Returns the new expires_at. Fails when it already expired or was released: claim again.",
-  { claim_id: z.string() },
-  async (args) => ok(await rpc("renew_claim", args))
-);
-
-server.tool(
-  "release_work",
-  "Release a claim as soon as you're done writing, so the next editor can start.",
-  { claim_id: z.string() },
-  async (args) => ok(await rpc("release_work", args))
-);
-
-server.tool(
-  "list_claims",
-  "Active claims: who is working on what right now, since when, until when. With a brand's account_id: that brand plus the agency-wide house_rules claim; empty: every brand.",
-  { account_id: z.string().optional() },
-  async (args) => ok(await rpc("list_claims", args))
-);
-
-// ── Deliverables ──────────────────────────────────────────────────────────────
-// Never guess a file name: LOTUX generates it (the brand's naming convention)
-// and moves the "Concept <code>" folder between stage folders. Versions stay
-// with you: <base_name>.mp4, then <base_name>_v2.mp4, _v3 …; move the previous
-// version into archive_folder. _var<N> is a variation (its own concept), not a version.
-
-server.tool(
-  "get_deliverable",
-  "The file name and folder for one deliverable: base_name (exactly the name LOTUX generates for that hook and language, without extension or version), extension (mp4 for video), folder (the concept's current stage folder in Dropbox, /CLIENTS/Active/<Brand>/01_video/02_deliverables/<stage>/Concept <code>) and archive_folder (folder + /Archive). Name the concept by concept_id, or account_id + code (\"8\" or \"c8\"); variation 2 = the concept's _Var2.",
-  {
-    concept_id: z.string().optional(),
-    account_id: z.string().optional().describe("Brand id, with code"),
-    code: z.string().optional().describe("Concept code, e.g. 8 or c8"),
-    hook: z.string().describe("h1, h2, h3 … (h for a single hook, \"Hook 2\" works too), b1 for the body-only export"),
-    language: z.string().optional().describe("English / en … (default: the concept's base language)"),
-    variation: z.number().int().optional().describe("2 for the concept's _Var2"),
-    kind: z.enum(["video", "static", "carousel"]).optional().describe("Default video"),
-  },
-  async (args) => ok(await rpc("get_deliverable", args))
-);
-
-server.tool(
-  "list_deliverables",
-  "Every deliverable name of a concept: base_name per hook and language, for the concept and for each of its variations, each with its folder and archive_folder.",
-  {
-    concept_id: z.string().optional(),
-    account_id: z.string().optional().describe("Brand id, with code"),
-    code: z.string().optional(),
-  },
-  async (args) => ok(await rpc("list_deliverables", args))
-);
-
-server.tool(
-  "list_entities",
-  "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 }))
-);
-
-server.tool(
-  "list_concepts",
-  "List a brand's existing concepts (id, code like '109', title, stage). Use this to find the id of a concept the user names before editing it.",
-  { account_id: z.string().describe("Brand id from list_brands") },
-  async ({ account_id }) => ok(await rpc("list_concepts", { account_id }))
-);
-
-server.tool(
-  "get_concept",
-  "Read the full state of one concept by id: fields, linked products/personas/angles/use-cases, scripts (markdown per language + shotlist), and linked copy. Use to confirm what was written.",
-  { concept_id: z.string() },
-  async ({ concept_id }) => ok(await rpc("get_concept", { concept_id }))
-);
-
-server.tool(
-  "list_options",
-  "Valid values for a concept's fields: buckets, sub_buckets, funnel_stages, messaging_frameworks, variants, formats (per-brand), countries, languages. Call before set_concept_fields so you use real keys (e.g. funnel 'tof', not 'top of funnel').",
-  { account_id: z.string().describe("Brand id from list_brands") },
-  async ({ account_id }) => ok(await rpc("list_options", { account_id }))
-);
-
-server.tool(
-  "list_copy",
-  "List a brand's existing copy items (returns ids for link_copy). Optionally filter by type (adcopy/headline/description) or a text query.",
-  {
-    account_id: z.string().describe("Brand id from list_brands"),
-    type: z.enum(["adcopy", "headline", "description"]).optional(),
-    query: z.string().optional(),
-  },
-  async (args) => ok(await rpc("list_copy", args))
-);
-
-server.tool(
-  "list_members",
-  "List the agency team members (id + name) assignable to a concept's roles. Use the ids with set_concept_fields (strategist_id, copy_checker_id, editor_id, media_buyer_id, final_check_id).",
-  { account_id: z.string().describe("Brand id from list_brands") },
-  async ({ account_id }) => ok(await rpc("list_members", { account_id }))
-);
-
-// ── Concept ────────────────────────────────────────────────────────────────────
-
-server.tool(
-  "create_concept",
-  "Create a new concept in the brand's first (Idea) stage, optionally linking products/personas/angles/offers/use-cases (a concept needs ≥1 product, persona, angle and offer before it can enter Copy check). Returns { id, script_id } — the concept id plus the id of its pre-seeded script (starter template). Write the script with save_script(script_id, body); do NOT add_script for the first script. A human moves the concept through the copy-check gate later in the app.",
-  {
-    account_id: z.string().describe("Brand id from list_brands"),
-    title: z.string(),
-    bucket: z
-      .string()
-      .optional()
-      .describe("Main bucket, e.g. video / static / carousel (the brand's bucket key). Defaults to video."),
-    funnel_stage: z.string().optional(),
-    format: z.string().optional(),
-    product_ids: z.array(z.string()).optional(),
-    persona_ids: z.array(z.string()).optional(),
-    angle_ids: z.array(z.string()).optional(),
-    use_case_ids: z.array(z.string()).optional(),
-    offer_ids: z.array(z.string()).optional().describe("Offer ids from list_entities (offers)"),
-  },
-  async (args) => ok(await rpc("create_concept", args))
-);
-
-server.tool(
-  "set_concept_fields",
-  "Update fields on an existing concept — including renaming it via title. Any omitted field is left unchanged; the id arrays, when given, replace the full set of links. Assign team roles by passing a person id from list_members into strategist_id / copy_checker_id / editor_id / media_buyer_id / final_check_id.",
-  {
-    concept_id: z.string(),
-    title: z.string().optional().describe("Rename the concept (blank is ignored — title is required)"),
-    funnel_stage: z.string().optional(),
-    format: z.string().optional(),
-    messaging_framework: z.string().optional(),
-    variant: z.string().optional(),
-    country: z.string().optional(),
-    promotion: z.string().optional(),
-    brief: z.string().optional().describe("Concept brief (markdown)"),
-    base_language: z.string().optional(),
-    sub_buckets: z.array(z.string()).optional(),
-    bucket: z.string().optional().describe("Main bucket option key (see list_options.fields)"),
-    fields: z
-      .record(z.union([z.string(), z.array(z.string()), z.null()]))
-      .optional()
-      .describe("Brand-defined concept fields by key → option key(s); see list_options.fields"),
-    product_ids: z.array(z.string()).optional(),
-    persona_ids: z.array(z.string()).optional(),
-    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"),
-    editor_id: z.string().optional().describe("Member id from list_members"),
-    media_buyer_id: z.string().optional().describe("Member id from list_members"),
-    final_check_id: z.string().optional().describe("Member id from list_members"),
-  },
-  // 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) ────────────────────────────────────────────────
-
-const SCRIPT_BODY_DOC =
-  "Markdown. Use labelled lines: `- **Hook:** …` (or `- **Hook 1:** …`, `- **Hook 2:** …` for several hooks), `- **1:** …`, `- **2:** …` for body lines, `- **CTA:** …` for the close. Hook ad-names are derived from the Hook lines. Free text (headings, paragraphs) is fine around them.";
-
-server.tool(
-  "save_script",
-  "Write a concept script: the markdown body for one language and/or the shotlist and/or a rename. Any omitted part is left unchanged. script_id comes from create_concept (script_id) or get_concept (scripts[].id). language defaults to the concept's base language; pass a translation language (full-written, e.g. Dutch) to write that language's version — a new language is added automatically. Returns the full script.",
-  {
-    script_id: z.string(),
-    language: z.string().optional().describe("Full-written language name, e.g. English / Dutch. Defaults to the base language."),
-    body: z.string().optional().describe(SCRIPT_BODY_DOC),
-    shotlist: z.array(z.string()).optional().describe("Ordered list of shots / b-roll (one line each). Replaces the whole list."),
-    name: z.string().optional().describe("Rename the script"),
-  },
-  async (args) => ok(await rpc("save_script", args))
-);
-
-server.tool(
-  "add_script",
-  "Add another script to a concept (every concept already has one — use save_script on it first). Returns the new script (starter template in the base language).",
-  { concept_id: z.string(), name: z.string().optional() },
-  async (args) => ok(await rpc("add_script", args))
-);
-
-server.tool(
-  "delete_script",
-  "Delete a script (all its language versions + shotlist). Irreversible.",
-  { script_id: z.string() },
-  async ({ script_id }) => ok(await rpc("delete_script", { script_id }))
-);
-
-server.tool(
-  "remove_script_language",
-  "Remove one translation language from a script. The base language cannot be removed.",
-  { script_id: z.string(), language: z.string() },
-  async (args) => ok(await rpc("remove_script_language", args))
-);
-
-// ── Beat compat (older prompts / scripts) ───────────────────────────────────
-
-server.tool(
-  "set_beats",
-  "Compatibility — prefer save_script. Sends an ordered beat list (Hook / Body / CTA lines + optional visual notes) and stores it as the concept's script document: lines become `- **Hook:**` / `- **1:**` / `- **CTA:**` markdown, visual notes become the shotlist. Replaces the whole script text for that language (default: the base language). Returns script_id + synthetic beat_ids ('<script_id>#<index>') for set_beat_translations.",
-  {
-    concept_id: z.string(),
-    beats: z.array(
-      z.object({
-        beat_type: z.enum(["hook", "body", "cta"]).optional(),
-        text: z.string().optional().describe("Spoken line"),
-        visual_note: z.string().optional().describe("What to show — lands in the shotlist"),
-      })
-    ),
-    language: z.string().optional().describe("Full-written language, defaults to the concept's base language"),
-  },
-  async (args) => ok(await rpc("set_beats", args))
-);
-
-server.tool(
-  "set_beat_translations",
-  "Compatibility — prefer save_script with a language. Writes one language's translated lines onto the concept's script: items are matched to the base script's lines by beat_id ('<script_id>#<index>' from set_beats) or by array order; a missing/empty text keeps the base line. Labels (Hook / 1 / CTA) are preserved.",
-  {
-    concept_id: z.string(),
-    language: z.string().describe("Full-written language, e.g. Dutch"),
-    items: z.array(
-      z.object({
-        beat_id: z.string().optional(),
-        text: z.string().optional(),
-        visual_note: z.string().optional().describe("Ignored — shotlists are language-independent"),
-      })
-    ),
-  },
-  async (args) => ok(await rpc("set_beat_translations", args))
-);
-
-server.tool(
-  "delete_concept",
-  "Delete an entire concept by id. Removes its scripts, entity links and copy links. Irreversible — confirm the id via list_concepts / get_concept first.",
-  { concept_id: z.string() },
-  async ({ concept_id }) => ok(await rpc("delete_concept", { concept_id }))
-);
-
-server.tool(
-  "set_base_language",
-  "Set the concept's base script language, e.g. English. Existing base-language script texts are re-labelled to the new language.",
-  { concept_id: z.string(), language: z.string() },
-  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.",
-  { concept_id: z.string(), copy_item_id: z.string() },
-  async (args) => ok(await rpc("link_copy", args))
-);
-
-server.tool(
-  "unlink_copy",
-  "Unlink a copy item from a concept. The copy stays in the brand library; only the link is removed.",
-  { concept_id: z.string(), copy_item_id: z.string() },
-  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.",
-  {
-    base_copy_id: z.string().describe("The existing copy to add a translation to"),
-    language: z.string().describe("Full-written name, e.g. Dutch"),
-    text: z.string().describe("The translated copy text"),
-    concept_id: z.string().optional().describe("Optional — also link the new variant to this concept"),
-  },
-  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(
-  "create_entity",
-  "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"]),
-    name: z.string(),
-    description: z.string().optional(),
-    extras: z.record(z.any()).optional().describe("Typed fields keyed by column name (see list_entities output shape)"),
-  },
-  async (args) => ok(await rpc("create_entity", args))
-);
-
-server.tool(
-  "update_entity",
-  "Update a brand-DB entity by id. Omitted fields are left unchanged; a blank name is ignored (name is required). Use extras to patch typed fields.",
-  {
-    entity_id: z.string(),
-    kind: z.enum(["products", "personas", "angles", "use_cases", "offers"]),
-    name: z.string().optional(),
-    description: z.string().optional(),
-    extras: z.record(z.any()).optional(),
-  },
-  async (args) => ok(await rpc("update_entity", args))
-);
-
-server.tool(
-  "delete_entity",
-  "Delete a brand-DB entity (product / persona / use_case / angle / offer) by id. Its links to concepts are removed with it. Irreversible — confirm the id via list_entities first.",
-  {
-    entity_id: z.string(),
-    kind: z.enum(["products", "personas", "angles", "use_cases", "offers"]),
-  },
-  async (args) => ok(await rpc("delete_entity", args))
-);
-
-// ── Kennisbank (knowledge base) ─────────────────────────────────────────────────
-
-server.tool(
-  "list_kb_workspaces",
-  "List the Kennisbank (knowledge base) workspaces you can access — markdown docs the team and AI share. Returns id, name, visibility. Use a workspace id with list_kb_docs / create_kb_doc. Only each workspace's \"Exposed to MCP\" section is visible to the MCP; the rest is the team's own notes.",
-  {},
-  async () => ok(await rpc("list_kb_workspaces"))
-);
-
-server.tool(
-  "list_kb_docs",
-  "List the pages in a Kennisbank workspace's \"Exposed to MCP\" section (id, title, folder path inside the section; \"\" = its top level). Pages outside the section are not listed. Use a doc id with get_kb_doc.",
-  { workspace_id: z.string().describe("Workspace id from list_kb_workspaces") },
-  async ({ workspace_id }) => ok(await rpc("list_kb_docs", { workspace_id }))
-);
-
-server.tool(
-  "get_kb_doc",
-  "Read one Kennisbank page's full markdown content by id. Only pages in the \"Exposed to MCP\" section can be read.",
-  { doc_id: z.string() },
-  async ({ doc_id }) => ok(await rpc("get_kb_doc", { doc_id }))
-);
-
-server.tool(
-  "create_kb_doc",
-  "Create a new markdown page in a Kennisbank workspace's \"Exposed to MCP\" section. Returns the new doc id. content is markdown; folder_id is optional (top of the section if omitted) and must be a folder from list_kb_folders.",
-  {
-    workspace_id: z.string().describe("Workspace id from list_kb_workspaces"),
-    title: z.string(),
-    content: z.string().optional().describe("Markdown body"),
-    folder_id: z.string().optional(),
-  },
-  async (args) => ok(await rpc("create_kb_doc", args))
-);
-
-server.tool(
-  "update_kb_doc",
-  "Update a Kennisbank page's title and/or markdown content (pages in the \"Exposed to MCP\" section only). Omitted fields are left unchanged.",
-  {
-    doc_id: z.string(),
-    title: z.string().optional(),
-    content: z.string().optional().describe("Markdown body (replaces the page content)"),
-  },
-  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 five; revisions,
-// approved, to_launch, live, testing, scaling, turned_off and archived are a human's call.
-const STATUSES = ["scripting", "production", "ready_for_post", "post_production", "to_review", "revisions", "approved", "to_launch", "live", "testing", "scaling", "turned_off", "archived"];
-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 =
-// 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(),
-  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,
-};
-// 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"),
-  ad_format: z.enum(["video", "static"]).optional().describe('VSL + Follower ads: its Dropbox folder (Video/ or Static/). Left out = "static" when the title says static, else video'),
-  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(),
-  klaviyo_message_id: z.string().optional().describe("Email cards: the Klaviyo flow message id this card became (after the flow is built)"),
-};
-
-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"),
-    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))
-);
-
-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. 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),
-    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(),
-    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"),
-    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, ready_for_post, post_production or to_review (to_review hands it to a human). Revisions, approved, to_launch, live, testing, scaling, turned_off and archived 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))
-);
-
-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))
-);
-
-// ---------------------------------------------------------------------------
-// HR (agency only): the team and the role templates (Responsibilities).
-// Needs HR access in LOTUX. Pay, contracts, documents, deleting people and
-// invites stay in the app on purpose.
-// ---------------------------------------------------------------------------
-
-const kpiShape = z.object({
-  label: z.string(),
-  target: z.string().nullable().optional(),
-  source: z.string().nullable().optional(),
-});
-
-server.tool(
-  "list_team",
-  "Everyone at the agency in HR: name, job role, lead, is_lead, status (onboarding / active / left), employment, start/end date, LOTUX login yes/no. Archived and left people only with include_archived. No pay.",
-  { include_archived: z.boolean().optional(), account_id: z.string().optional().describe("Agency id; omit for your own agency") },
-  async (args) => ok(await rpc("list_team", args))
-);
-
-server.tool(
-  "get_team_member",
-  "One person in HR: role, lead, who they lead, contact fields, their own KPIs (else the role's apply), access checklist and their last 20 notes. No pay.",
-  { member: z.string().describe("Person id or (part of) their name"), account_id: z.string().optional() },
-  async (args) => ok(await rpc("get_team_member", args))
-);
-
-server.tool(
-  "update_team_member",
-  "Change a person in HR. Only the fields you send change. role and lead take a name or id (null clears). archived true hides them from HR lists, the lead picker and payroll (data kept); false restores. kpis replaces their own KPI list ([] = use the role's KPIs). Can't change pay, delete people or send invites — do that in the app.",
-  {
-    member: z.string().describe("Person id or name"),
-    name: z.string().optional(),
-    role: z.string().nullable().optional().describe("Job role name or id (list_job_roles)"),
-    lead: z.string().nullable().optional().describe("Lead's name or id"),
-    is_lead: z.boolean().optional(),
-    status: z.enum(["onboarding", "active", "left"]).optional(),
-    employment: z.enum(["employee", "freelance"]).nullable().optional(),
-    start_date: z.string().nullable().optional().describe("YYYY-MM-DD"),
-    end_date: z.string().nullable().optional().describe("YYYY-MM-DD"),
-    lotux_email: z.string().nullable().optional(),
-    personal_email: z.string().nullable().optional(),
-    phone: z.string().nullable().optional(),
-    archived: z.boolean().optional(),
-    kpis: z.array(kpiShape).optional(),
-    account_id: z.string().optional(),
-  },
-  async (args) => ok(await rpc("update_team_member", args))
-);
-
-server.tool(
-  "list_job_roles",
-  "The role templates in HR → Responsibilities: id, name, one-line summary and how many people have the role.",
-  { account_id: z.string().optional() },
-  async (args) => ok(await rpc("list_job_roles", args))
-);
-
-server.tool(
-  "get_job_role",
-  "One role template in full: title, one-liner, what they obsess over, who they work with, what failure looks like, what they're not responsible for, responsibilities, KPIs, capacity, the LOTUX columns they own, and who has the role.",
-  { role: z.string().describe("Role id or exact name"), account_id: z.string().optional() },
-  async (args) => ok(await rpc("get_job_role", args))
-);
-
-const roleFields = {
-  role_label: z.string().nullable().optional(),
-  title: z.string().nullable().optional(),
-  one_line: z.string().nullable().optional(),
-  obsess_over: z.string().nullable().optional(),
-  works_with: z.string().nullable().optional(),
-  failure_looks_like: z.string().nullable().optional(),
-  not_responsible_for: z.string().nullable().optional(),
-  kpi_headline: z.string().nullable().optional(),
-  kpi_detail: z.string().nullable().optional(),
-  capacity_count: z.number().int().nonnegative().nullable().optional(),
-  capacity_unit: z.enum(["clients", "accounts", "brands"]).nullable().optional(),
-  software_columns: z.array(z.string()).optional().describe("LOTUX columns this role owns"),
-  responsibilities: z.array(z.string()).optional().describe("Replaces the whole list, in order"),
-  kpis: z.array(kpiShape).optional().describe("Replaces the whole list, in order"),
-};
-
-server.tool(
-  "update_job_role",
-  "Change a role template (HR → Responsibilities). Only the fields you send change; responsibilities and kpis replace the whole list, so send the full list. new_name renames the role.",
-  {
-    role: z.string().describe("Role id or exact name"),
-    new_name: z.string().optional(),
-    ...roleFields,
-    account_id: z.string().optional(),
-  },
-  async (args) => ok(await rpc("update_job_role", args))
-);
-
-server.tool(
-  "create_job_role",
-  "Create a role template (starts with the standard Start here flow) and fill it in one go. An existing role with the same name is returned (and updated with the fields you send) instead of a duplicate.",
-  { name: z.string(), ...roleFields, account_id: z.string().optional() },
-  async (args) => ok(await rpc("create_job_role", args))
-);
-
-// ── SOPs (Brain → SOPs) ────────────────────────────────────────────────────
-// Claude reads SOPs and SUGGESTS changes; a person approves them in LOTUX.
-// There is deliberately no tool to approve, edit or publish an SOP.
-
-const sopStep = z.object({
-  title: z.string(),
-  detail: z.string().optional(),
-  sub: z.array(z.string()).optional().describe("Sub-points"),
-  when: z.string().optional().describe('Timing chip, e.g. "Day 0, 60 min"'),
-});
-const sopContent = {
-  summary: z.string().optional().describe("One line, shown on the card"),
-  purpose: z.string().optional(),
-  scope: z.string().optional().describe('"At a glance": lines like "When: …" / "Trigger: …"'),
-  materials: z.array(z.string()).optional().describe("Before you start"),
-  steps: z.array(sopStep).optional().describe("The FULL ordered list of steps. Who does a step is kept from the step at the same position."),
-  done_when: z.string().optional(),
-  troubleshooting: z.array(z.object({ risk: z.string(), fix: z.string() })).optional().describe("Watch out"),
-  tools: z.array(z.string()).optional(),
-  video_url: z.string().nullable().optional().describe("Walkthrough link (http/https)"),
-};
-
-server.tool(
-  "list_sops",
-  "The SOPs in LOTUX (Brain → SOPs): code, title, phase, status, owner, number of steps and open suggestions. Archived ones are left out unless you ask for status archived.",
-  {
-    phase: z.string().optional().describe("Phase key, e.g. lead, sell, contract, shoot, launch, run"),
-    status: z.enum(["draft", "review", "published", "archived"]).optional(),
-    search: z.string().optional(),
-    account_id: z.string().optional().describe("Omit for the agency"),
-  },
-  async (args) => ok(await rpc("list_sops", args))
-);
-
-server.tool(
-  "get_sop",
-  "One SOP in full: purpose, at a glance, before you start, steps (with who does them), done when, watch out, tools, open suggestions and the changelog.",
-  { sop: z.string().describe("SOP id, code (e.g. OC1) or title"), account_id: z.string().optional() },
-  async (args) => ok(await rpc("get_sop", args))
-);
-
-server.tool(
-  "suggest_sop_change",
-  "Suggest a change to an SOP. Nothing changes until the SOP owner or an editor approves it in LOTUX; the changelog then shows you (via Claude) as the author. Send only the fields you change; lists (steps, materials, troubleshooting, tools) replace the whole list. One open suggestion per person per SOP: a new one replaces your earlier one.",
-  {
-    sop: z.string().describe("SOP id, code or title"),
-    changes: z.object(sopContent).extend({ title: z.string().optional() }),
-    reason: z.string().describe("Why this change is needed (the approver reads it)"),
-    account_id: z.string().optional(),
-  },
-  async (args) => ok(await rpc("suggest_sop_change", args))
-);
-
-server.tool(
-  "create_sop_draft",
-  "Create a new SOP as a DRAFT (needs Brain edit rights). It is not live: a person sets owner and category and publishes it in LOTUX. The changelog logs it as created by you (via Claude). An existing title is refused: suggest a change to that SOP instead.",
-  {
-    title: z.string(),
-    phase: z.string().optional().describe("Board column: lead, sell, contract, team_onboard, client_onboard, preprod, shoot, production, launch, run, retain, offboard, always, team"),
-    ...sopContent,
-    account_id: z.string().optional(),
-  },
-  async (args) => ok(await rpc("create_sop_draft", args))
-);
+const server = new McpServer(SERVER_INFO);
+registerTools(server, rpc);
 
 async function main() {
   const transport = new StdioServerTransport();