@charisol/plexo-mcp 1.0.9 → 1.0.11

package/src/index.ts

@@ -8,6 +8,10 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 import { PlexoClient } from "./client/plexoClient.js";
 import { BLOG_TOOL_DEFS, BLOG_TOOL_NAMES, handleBlogToolCall } from "./blogTools.js";
+import { COMMERCE_TOOL_DEFS, COMMERCE_TOOL_NAMES, handleCommerceToolCall } from "./commerceTools.js";
+import { LMS_TOOL_DEFS, LMS_TOOL_NAMES, handleLmsToolCall } from "./lmsTools.js";
+import { DONATION_TOOL_DEFS, DONATION_TOOL_NAMES, handleDonationToolCall } from "./donationTools.js";
+import { WP_MIGRATION_TOOL_DEFS, WP_MIGRATION_TOOL_NAMES, handleWpMigrationToolCall } from "./wpMigrationTools.js";
 
 const server = new Server(
   {
@@ -29,55 +33,78 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         name: "publish_landing_page",
         description: `Creates, compiles, and publishes a landing page to Plexo in one atomic step. Returns the published live URL and editable visual builder URL.
 
-IMPORTANT INSTRUCTION FOR AI CLIENTS:
+DESIGN QUALITY — read this before writing designJson. Followed correctly it is what separates a premium, bespoke-looking result from a generic AI template; the worked example below demonstrates every rule.
+- Palette: choose one small, deliberate system before writing any row — a near-black/navy/charcoal "ink" plus an off-white/cream "paper" (never pure #000000/#ffffff), one brand accent color used sparingly for CTAs/highlights only, and 2-3 muted grays derived from the ink color for secondary text. Reuse these exact hex values everywhere. Default to this kind of restrained, brand-appropriate palette — NOT a generic dark background with a purple/blue accent — unless the user's prompt clearly calls for that look.
+- Typography: at most three font families — one serif or otherwise distinctive display font for headings (line-height 1.0-1.25, fontWeight 500-600, never 800+), one clean sans-serif for body copy and buttons (paragraphs at line-height 1.6-1.75), and optionally one monospace/condensed font in uppercase with letterSpacing "0.14em"-"0.18em" at a small fontSize (11-13px) reserved only for short eyebrow labels above a heading. Give headings/paragraphs a "maxWidth" (roughly 480-780px) so text never stretches edge-to-edge.
+- Section shell: every section is two layers, using the column's optional 'nestedRows' array (see schema below) — an OUTER row carries the section's full-bleed backgroundColor to the viewport edge with horizontal padding of either "0" or a fluid "clamp(20px, 6vw, 56px)" (never a fixed px value), containing one "100%"-width column whose 'nestedRows' holds an INNER row that caps actual content at maxWidth ~1200-1440px. Alternate background colors between sections (ink, paper, a warm neutral, a soft accent tint) for rhythm instead of leaving every section the same color.
+- Restraint: borderRadius near 0 by default (an editorial, premium feel) — reserve a rounded pill (~100px) only for tags/badges, small radii (2-10px) only for buttons/cards/inputs. Use boxShadow rarely and only as a soft, large, low-opacity shadow tinted with the ink color (never plain black) — most elements should have none.
+- Layout variety: vary column-width splits across sections (an asymmetric ~55/45 hero, a 33.33/33.33/33.33 feature grid, alternating ~60/40 image-and-text rows) instead of repeating the same centered block or identical grid everywhere. Buttons: understated solid-accent fill or a text link with a colored underline/arrow, fontWeight 600, padding ~"14px 26px", sharp-to-small corner radius, specific action copy ("Book a Consultation →") not generic "Click Here". Images: descriptive specific "alt" text, an intentional width/maxWidth so nothing stretches full-bleed by accident.
+
+STRUCTURAL RULES:
 The designJson argument MUST be a fully hydrated layout tree containing body style and rows array. There is no shorthand format —
 do NOT send rows shaped like { "type": "products", "content": { "items": [...] } }. That will be REJECTED with a validation error.
-Every row MUST already contain a 'columns' array with percentage widths ('100%', '50%', '33.33%'), and each column MUST contain an
-'elements' array with fully-styled component objects ('heading', 'paragraph', 'button', 'card', 'image', 'menu', 'social', 'divider',
-'spacer', 'form_container'). For any repeated-item section (products, features, testimonials, pricing tiers, etc.) YOU must expand
-each item into its own column with real elements — one column per item — rather than passing a list for the server to interpret.
-
-EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
+Every row MUST already contain a 'columns' array with percentage widths ('100%', '50%', '33.33%'), and each column MUST contain either
+an 'elements' array of fully-styled component objects ('heading', 'paragraph', 'button', 'card', 'image', 'menu', 'social', 'divider',
+'spacer', 'form_container') and/or a 'nestedRows' array (same shape as a top-level row — id/style/columns — used for the outer/inner
+full-bleed section shell described above; a column may have nestedRows, elements, or both). For any repeated-item section (products,
+features, testimonials, pricing tiers, etc.) YOU must expand each item into its own column with real elements — one column per item —
+rather than passing a list for the server to interpret.
+
+EXAMPLE VALID designJson PAYLOAD (full-bleed hero with an asymmetric 55/45 split, plus a full-bleed 3-up feature row) — note the
+restrained ink/paper/terracotta palette, the serif/sans/mono type system, near-zero border radius, and the outer/inner row shell:
 {
   "body": {
-    "style": { "backgroundColor": "#08090f", "color": "#f0f2ff", "fontFamily": "Inter, sans-serif", "htmlTitle": "Bulum SaaS Platform" },
+    "style": { "backgroundColor": "#FAF7F1", "color": "#1B2430", "fontFamily": "'Inter', sans-serif", "htmlTitle": "Norrland Coffee Roasters" },
     "rows": [
       {
-        "id": "row-hero",
-        "style": { "paddingTop": "80px", "paddingBottom": "80px" },
+        "id": "row-hero-outer",
+        "style": { "backgroundColor": "#1B2430", "padding": "0 clamp(24px, 6vw, 64px)" },
         "columns": [
-          {
-            "id": "col-hero",
-            "width": "100%",
-            "elements": [
-              { "type": "heading", "style": { "fontSize": "48px", "fontWeight": "800", "textAlign": "center", "color": "#ffffff" }, "attributes": { "text": "Build & Scale Faster" } },
-              { "type": "paragraph", "style": { "fontSize": "18px", "color": "#94a3b8", "textAlign": "center" }, "attributes": { "text": "The ultimate platform for modern digital teams." } },
-              { "type": "button", "style": { "textAlign": "center", "backgroundColor": "#8b5cf6", "color": "#ffffff", "borderRadius": "12px", "paddingTop": "14px", "paddingBottom": "14px", "paddingLeft": "28px", "paddingRight": "28px" }, "attributes": { "text": "Start Free Trial", "href": "#signup" } }
-            ]
-          }
+          { "id": "col-hero-outer", "width": "100%", "elements": [], "nestedRows": [
+            {
+              "id": "row-hero-inner",
+              "style": { "maxWidth": "1200px", "margin": "0 auto" },
+              "columns": [
+                { "id": "col-hero-text", "width": "55%", "styles": { "padding": "96px 32px 96px 0" }, "elements": [
+                  { "id": "el-eyebrow", "type": "text", "style": { "fontFamily": "'IBM Plex Mono', monospace", "fontSize": "12px", "letterSpacing": "0.16em", "textTransform": "uppercase", "color": "#C4623B" }, "attributes": { "text": "Small-Batch Roastery" } },
+                  { "id": "el-heading", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "48px", "lineHeight": "1.1", "color": "#FAF7F1", "maxWidth": "560px", "margin": "16px 0 0" }, "attributes": { "text": "Coffee, Roasted With Intention" } },
+                  { "id": "el-sub", "type": "paragraph", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "17px", "lineHeight": "1.7", "color": "#B7BEC9", "maxWidth": "480px", "margin": "20px 0 0" }, "attributes": { "text": "Single-origin beans sourced direct from growers, roasted weekly in small batches for a cup that actually tastes like where it came from." } },
+                  { "id": "el-cta", "type": "button", "style": { "backgroundColor": "#C4623B", "color": "#FAF7F1", "border": "none", "borderRadius": "2px", "fontFamily": "'Inter', sans-serif", "fontWeight": "600", "fontSize": "15px", "padding": "14px 26px", "margin": "28px 0 0" }, "attributes": { "text": "Shop This Week's Roast →", "href": "/shop" } }
+                ] },
+                { "id": "col-hero-image", "width": "45%", "elements": [
+                  { "id": "el-hero-img", "type": "image", "style": { "width": "100%", "borderRadius": "4px", "boxShadow": "0 18px 34px -14px rgba(27,36,48,0.45)" }, "attributes": { "src": "https://...", "alt": "Roaster pouring fresh-roasted beans into a cooling tray" } }
+                ] }
+              ]
+            }
+          ] }
         ]
       },
       {
-        "id": "row-products",
-        "style": { "paddingTop": "60px", "paddingBottom": "60px" },
+        "id": "row-features-outer",
+        "style": { "backgroundColor": "#FAF7F1", "padding": "0 clamp(24px, 6vw, 64px)" },
         "columns": [
-          { "id": "col-product-1", "width": "33.33%", "elements": [
-            { "type": "image", "style": { "width": "100%", "borderRadius": "12px" }, "attributes": { "src": "https://...", "alt": "Urban Runner" } },
-            { "type": "heading", "style": { "fontSize": "20px", "marginTop": "12px" }, "attributes": { "text": "Urban Runner" } },
-            { "type": "paragraph", "style": { "fontSize": "14px", "color": "#94a3b8" }, "attributes": { "text": "Lightweight sneakers for daily adventures" } },
-            { "type": "paragraph", "style": { "fontSize": "16px", "fontWeight": "700", "color": "#8b5cf6" }, "attributes": { "text": "$89" } }
-          ] },
-          { "id": "col-product-2", "width": "33.33%", "elements": [
-            { "type": "image", "style": { "width": "100%", "borderRadius": "12px" }, "attributes": { "src": "https://...", "alt": "Classic Court" } },
-            { "type": "heading", "style": { "fontSize": "20px", "marginTop": "12px" }, "attributes": { "text": "Classic Court" } },
-            { "type": "paragraph", "style": { "fontSize": "14px", "color": "#94a3b8" }, "attributes": { "text": "Timeless style with modern comfort" } },
-            { "type": "paragraph", "style": { "fontSize": "16px", "fontWeight": "700", "color": "#8b5cf6" }, "attributes": { "text": "$79" } }
-          ] },
-          { "id": "col-product-3", "width": "33.33%", "elements": [
-            { "type": "image", "style": { "width": "100%", "borderRadius": "12px" }, "attributes": { "src": "https://...", "alt": "Street Flex" } },
-            { "type": "heading", "style": { "fontSize": "20px", "marginTop": "12px" }, "attributes": { "text": "Street Flex" } },
-            { "type": "paragraph", "style": { "fontSize": "14px", "color": "#94a3b8" }, "attributes": { "text": "Flexible performance footwear" } },
-            { "type": "paragraph", "style": { "fontSize": "16px", "fontWeight": "700", "color": "#8b5cf6" }, "attributes": { "text": "$99" } }
+          { "id": "col-features-outer", "width": "100%", "elements": [], "nestedRows": [
+            {
+              "id": "row-features-inner",
+              "style": { "maxWidth": "1200px", "margin": "0 auto", "padding": "80px 0" },
+              "columns": [
+                { "id": "col-feature-1", "width": "33.33%", "elements": [
+                  { "id": "el-icon-1", "type": "icon", "style": { "color": "#C4623B" }, "attributes": { "iconName": "leaf", "iconSize": 30 } },
+                  { "id": "el-h-1", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "22px", "color": "#1B2430", "margin": "16px 0 0" }, "attributes": { "text": "Direct Trade" } },
+                  { "id": "el-p-1", "type": "paragraph", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "15px", "lineHeight": "1.65", "color": "#5B6472", "margin": "8px 0 0" }, "attributes": { "text": "Every farm relationship is ours, not a broker's." } }
+                ] },
+                { "id": "col-feature-2", "width": "33.33%", "elements": [
+                  { "id": "el-icon-2", "type": "icon", "style": { "color": "#C4623B" }, "attributes": { "iconName": "flame", "iconSize": 30 } },
+                  { "id": "el-h-2", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "22px", "color": "#1B2430", "margin": "16px 0 0" }, "attributes": { "text": "Roasted Weekly" } },
+                  { "id": "el-p-2", "type": "paragraph", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "15px", "lineHeight": "1.65", "color": "#5B6472", "margin": "8px 0 0" }, "attributes": { "text": "Never more than seven days off the roaster." } }
+                ] },
+                { "id": "col-feature-3", "width": "33.33%", "elements": [
+                  { "id": "el-icon-3", "type": "icon", "style": { "color": "#C4623B" }, "attributes": { "iconName": "truck", "iconSize": 30 } },
+                  { "id": "el-h-3", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "22px", "color": "#1B2430", "margin": "16px 0 0" }, "attributes": { "text": "Shipped Fresh" } },
+                  { "id": "el-p-3", "type": "paragraph", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "15px", "lineHeight": "1.65", "color": "#5B6472", "margin": "8px 0 0" }, "attributes": { "text": "Out the door within 24 hours of roasting." } }
+                ] }
+              ]
+            }
           ] }
         ]
       }
@@ -131,6 +158,7 @@ EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
                                 width: { type: "string", description: "Percentage width (e.g. '100%', '50%', '33.33%')." },
                                 elements: {
                                   type: "array",
+                                  description: "This column's own content elements. May be empty ([]) when the column instead uses 'nestedRows' below (the full-bleed section-shell pattern) — a column may have elements, nestedRows, or both.",
                                   items: {
                                     type: "object",
                                     required: ["id", "type", "style", "attributes"],
@@ -144,6 +172,15 @@ EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
                                     },
                                   },
                                 },
+                                nestedRows: {
+                                  type: "array",
+                                  description: "OPTIONAL. Nested row(s) inside this column, each the SAME shape as a top-level row (id/style/columns). This is how you build a full-bleed section: the outer row/column carries the background color edge-to-edge, and a nestedRow here caps content at a readable maxWidth. Use this instead of putting a 'maxWidth' directly on the outer row.",
+                                  items: {
+                                    type: "object",
+                                    required: ["id", "style", "columns"],
+                                    description: "Same shape as a top-level row: { id, style, columns: [{ id, width, elements, nestedRows? }] } — nesting may repeat if genuinely needed, but one level (outer band + inner capped row) covers nearly every section.",
+                                  },
+                                },
                               },
                             },
                           },
@@ -513,6 +550,23 @@ To edit a page's CONTENT (designJson), use update_template with the same templat
           required: ["templateId"],
         },
       },
+      {
+        name: "delete_template",
+        description: "Permanently deletes any landing page or email template by templateId or template name (e.g. 'buzm'). Same underlying operation as delete_landing_page_page. Confirm with user before calling as this action cannot be undone.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            templateId: {
+              type: "string",
+              description: "ID of the template or page to delete (UUID, or exact/partial template name like 'buzm').",
+            },
+            name: {
+              type: "string",
+              description: "Optional template name or search phrase if templateId is unknown (e.g. 'buzm').",
+            },
+          },
+        },
+      },
       {
         name: "delete_landing_page_page",
         description: "Deletes a page. If it has sub-pages nested under it, they're deleted too (cascade) — the response reports how many. Deleting a site's home page deletes the whole site, including every page nested under it and its published domain link — this can't be undone, confirm with the user first.",
@@ -596,6 +650,10 @@ To edit a page's CONTENT (designJson), use update_template with the same templat
         },
       },
       ...BLOG_TOOL_DEFS,
+      ...COMMERCE_TOOL_DEFS,
+      ...LMS_TOOL_DEFS,
+      ...DONATION_TOOL_DEFS,
+      ...WP_MIGRATION_TOOL_DEFS,
     ],
   };
 });
@@ -751,8 +809,26 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      case "delete_template":
       case "delete_landing_page_page": {
-        const result = await client.deleteLandingPagePage((args as any)?.templateId);
+        const rawInput = ((args as any)?.templateId || (args as any)?.name || "").trim();
+        if (!rawInput) throw new Error("templateId or template name is required.");
+
+        // Same UUID-or-name resolution as the server's own delete_template/
+        // delete_landing_page_page handler — try an exact id match first, then fall back to
+        // a case-insensitive name search across this account's templates.
+        let resolvedId = rawInput;
+        const { templates } = await client.listTemplates();
+        const byId = (templates || []).find((t: any) => t.id === rawInput);
+        if (!byId) {
+          const needle = rawInput.toLowerCase();
+          const matches = (templates || []).filter((t: any) => t.name?.toLowerCase().includes(needle));
+          matches.sort((a: any, b: any) => (b.updatedAt ?? "").localeCompare(a.updatedAt ?? ""));
+          if (!matches[0]) throw new Error(`No template found matching "${rawInput}".`);
+          resolvedId = matches[0].id;
+        }
+
+        const result = await client.deleteLandingPagePage(resolvedId);
         return {
           content: [
             {
@@ -861,6 +937,37 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             ],
           };
         }
+        if (COMMERCE_TOOL_NAMES.has(name)) {
+          const result = await handleCommerceToolCall(name, (args as any) || {}, client);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+              },
+            ],
+          };
+        }
+        if (LMS_TOOL_NAMES.has(name)) {
+          const result = await handleLmsToolCall(name, (args as any) || {}, client);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+              },
+            ],
+          };
+        }
+        for (const [names, handler] of [
+          [DONATION_TOOL_NAMES, handleDonationToolCall],
+          [WP_MIGRATION_TOOL_NAMES, handleWpMigrationToolCall],
+        ] as const) {
+          if (names.has(name)) {
+            const result = await handler(name, (args as any) || {}, client);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+          }
+        }
         throw new Error(`Unknown tool: ${name}`);
       }
     }

package/src/lmsTools.ts

@@ -0,0 +1,262 @@
+import { PlexoClient } from "./client/plexoClient.js";
+
+export const LMS_TOOL_DEFS = [
+  {
+    name: "create_funnel",
+    description: "Attaches Funnel/LMS capability to an existing root landing page (see create_landing_page / list_landing_pages for how to get one), seeding a single Welcome page. Gated by the organization's funnel slot allowance (get_funnel_addon_slots shows current usage) — fails with the slot summary if none is available.",
+    inputSchema: {
+      type: "object",
+      properties: { templateId: { type: "string", description: "An existing root landing page's template id to turn into a funnel." } },
+      required: ["templateId"],
+    },
+  },
+  {
+    name: "get_funnel",
+    description: "Fetches a funnel's settings: enabled state, signup mode (FREE/PAID), signup product, and welcome-page options.",
+    inputSchema: {
+      type: "object",
+      properties: { templateId: { type: "string", description: "The funnel's home page template id." } },
+      required: ["templateId"],
+    },
+  },
+  {
+    name: "update_funnel",
+    description: "Updates a funnel's settings. Only the fields provided are changed. Switching signupMode to PAID requires signupProductId (a DIGITAL Commerce product) to already be set or provided here.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        enabled: { type: "boolean" },
+        signupMode: { type: "string", enum: ["FREE", "PAID"] },
+        signupProductId: { type: "string", description: "A DIGITAL Commerce product id (see create_commerce_product). Pass an empty string to clear it." },
+        requireName: { type: "boolean" },
+        collectPhone: { type: "boolean" },
+        welcomeRedirectPath: { type: "string", description: "Pass an empty string to clear it." },
+      },
+      required: ["templateId"],
+    },
+  },
+  {
+    name: "delete_funnel",
+    description: "Soft-deletes a funnel (enabled:false — hidden from visitors). Pages, enrollments, and progress are kept, so re-enabling later restores everything as-is.",
+    inputSchema: {
+      type: "object",
+      properties: { templateId: { type: "string", description: "The funnel's home page template id." } },
+      required: ["templateId"],
+    },
+  },
+  {
+    name: "list_funnel_pages",
+    description: "Lists a funnel's pages in their display order.",
+    inputSchema: {
+      type: "object",
+      properties: { templateId: { type: "string", description: "The funnel's home page template id." } },
+      required: ["templateId"],
+    },
+  },
+  {
+    name: "create_funnel_page",
+    description: "Appends a new page to a funnel. Defaults to kind VIDEO and unlocks after the current last page — use update_funnel_page to customize unlockRules afterward.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        title: { type: "string", description: "Defaults to \"Page N\"." },
+        kind: { type: "string", enum: ["WELCOME", "VIDEO", "DOCUMENT", "IMAGE"], description: "Defaults to VIDEO." },
+      },
+      required: ["templateId"],
+    },
+  },
+  {
+    name: "update_funnel_page",
+    description: "Updates a funnel page's content and/or unlock rules. Only the fields provided are changed. unlockRules shape: { mode: \"ALL\", conditions: [...] } where each condition is one of PREREQUISITE_PAGES ({type,pageIds}), TIME_DRIP_RELATIVE ({type,days}), TIME_DRIP_FIXED_DATE ({type,date}), MANUAL_APPROVAL ({type}) — satisfied via approve_funnel_enrollment_page.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        pageId: { type: "string" },
+        title: { type: "string" },
+        kind: { type: "string", enum: ["WELCOME", "VIDEO", "DOCUMENT", "IMAGE"] },
+        contentMode: { type: "string", enum: ["SIMPLE", "RAW_HTML", "ADVANCED"], description: "SIMPLE/RAW_HTML both write to bodyHtml; ADVANCED is a full-builder page and isn't settable from here." },
+        bodyHtml: { type: "string", description: "Sanitized server-side. For a WELCOME page this renders as plain text, not markup." },
+        youtubeVideoId: { type: "string", description: "Empty string clears it." },
+        assetUrl: { type: "string", description: "Already-uploaded file URL (this tool can't accept raw bytes). Empty string clears it." },
+        assetFileName: { type: "string" },
+        assetMimeType: { type: "string" },
+        assetSizeBytes: { type: "number" },
+        unlockRules: { type: "object", description: "See this tool's description for the shape." },
+        visible: { type: "boolean" },
+      },
+      required: ["templateId", "pageId"],
+    },
+  },
+  {
+    name: "delete_funnel_page",
+    description: "Deletes a funnel page and closes the resulting order gap in the remaining pages.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        pageId: { type: "string" },
+      },
+      required: ["templateId", "pageId"],
+    },
+  },
+  {
+    name: "reorder_funnel_pages",
+    description: "Reorders a funnel's pages. orderedPageIds must contain exactly this funnel's current page ids, in the new order.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        orderedPageIds: { type: "array", items: { type: "string" } },
+      },
+      required: ["templateId", "orderedPageIds"],
+    },
+  },
+  {
+    name: "list_funnel_enrollments",
+    description: "Lists a funnel's learner enrollments, most recently enrolled first.",
+    inputSchema: {
+      type: "object",
+      properties: { templateId: { type: "string", description: "The funnel's home page template id." } },
+      required: ["templateId"],
+    },
+  },
+  {
+    name: "get_funnel_enrollment",
+    description: "Fetches one learner's enrollment plus their per-page progress.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        email: { type: "string" },
+      },
+      required: ["templateId", "email"],
+    },
+  },
+  {
+    name: "approve_funnel_enrollment_page",
+    description: "Marks one page as manually approved for one learner — the way a MANUAL_APPROVAL unlock condition gets satisfied (see update_funnel_page's unlockRules description). Reversible: calling it again just re-stamps the approval.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        email: { type: "string" },
+        pageId: { type: "string" },
+      },
+      required: ["templateId", "email", "pageId"],
+    },
+  },
+  {
+    name: "set_funnel_enrollment_status",
+    description: "Revokes or reactivates a learner's enrollment. Revoked takes effect immediately on their next page load (no session to separately invalidate).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        email: { type: "string" },
+        status: { type: "string", enum: ["ACTIVE", "REVOKED"] },
+      },
+      required: ["templateId", "email", "status"],
+    },
+  },
+  {
+    name: "resend_funnel_magic_link",
+    description: "Re-sends the passwordless login email to an ACTIVE learner. Rate-limited to once per 60 seconds per learner.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The funnel's home page template id." },
+        email: { type: "string" },
+      },
+      required: ["templateId", "email"],
+    },
+  },
+  {
+    name: "get_funnel_addon_slots",
+    description: "Reports the organization's funnel slot usage (plan-included + purchased addon slots vs. funnels currently using one) and any active addon-slot subscriptions. Org-scoped, not per-site.",
+    inputSchema: { type: "object", properties: {} },
+  },
+];
+
+export const LMS_TOOL_NAMES = new Set(LMS_TOOL_DEFS.map((t) => t.name));
+
+export async function handleLmsToolCall(name: string, args: any, client: PlexoClient): Promise<any> {
+  const templateId = typeof args?.templateId === "string" ? args.templateId : "";
+
+  switch (name) {
+    case "create_funnel": {
+      if (!templateId) throw new Error("templateId is required.");
+      const result = await client.createFunnel(templateId);
+      return { success: true, funnel: result.funnel };
+    }
+
+    case "get_funnel":
+      return await client.getFunnel(templateId);
+
+    case "update_funnel": {
+      const { templateId: _t, ...payload } = args;
+      const result = await client.updateFunnel(templateId, payload);
+      return { success: true, funnel: result.funnel };
+    }
+
+    case "delete_funnel":
+      await client.deleteFunnel(templateId);
+      return { success: true };
+
+    case "list_funnel_pages":
+      return await client.listFunnelPages(templateId);
+
+    case "create_funnel_page": {
+      const result = await client.createFunnelPage(templateId, { title: args.title, kind: args.kind });
+      return { success: true, page: result.page };
+    }
+
+    case "update_funnel_page": {
+      if (!args.pageId) throw new Error("pageId is required.");
+      const { templateId: _t, pageId, ...payload } = args;
+      const result = await client.updateFunnelPage(templateId, pageId, payload);
+      return { success: true, page: result.page };
+    }
+
+    case "delete_funnel_page":
+      if (!args.pageId) throw new Error("pageId is required.");
+      await client.deleteFunnelPage(templateId, args.pageId);
+      return { success: true, deletedPageId: args.pageId };
+
+    case "reorder_funnel_pages": {
+      if (!Array.isArray(args.orderedPageIds) || args.orderedPageIds.length === 0) throw new Error("orderedPageIds is required.");
+      return await client.reorderFunnelPages(templateId, args.orderedPageIds);
+    }
+
+    case "list_funnel_enrollments":
+      return await client.listFunnelEnrollments(templateId);
+
+    case "get_funnel_enrollment":
+      if (!args.email) throw new Error("email is required.");
+      return await client.getFunnelEnrollment(templateId, args.email);
+
+    case "approve_funnel_enrollment_page": {
+      if (!args.email || !args.pageId) throw new Error("email and pageId are required.");
+      const result = await client.approveFunnelEnrollmentPage(templateId, args.email, args.pageId);
+      return { success: true, progress: result.progress };
+    }
+
+    case "set_funnel_enrollment_status": {
+      if (!args.email || !args.status) throw new Error("email and status are required.");
+      const result = await client.setFunnelEnrollmentStatus(templateId, args.email, args.status);
+      return { success: true, enrollment: result.enrollment };
+    }
+
+    case "resend_funnel_magic_link":
+      if (!args.email) throw new Error("email is required.");
+      return await client.resendFunnelMagicLink(templateId, args.email);
+
+    case "get_funnel_addon_slots":
+      return await client.getFunnelAddonSlots();
+
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}