@charisol/plexo-mcp 1.0.10 → 1.0.11

package/src/index.ts

@@ -10,6 +10,8 @@ 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(
   {
@@ -31,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." } }
+                ] }
+              ]
+            }
           ] }
         ]
       }
@@ -133,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"],
@@ -146,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.",
+                                  },
+                                },
                               },
                             },
                           },
@@ -617,6 +652,8 @@ 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,
     ],
   };
 });
@@ -922,6 +959,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             ],
           };
         }
+        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/wpMigrationTools.ts

@@ -0,0 +1,198 @@
+import { PlexoClient } from "./client/plexoClient.js";
+
+// WordPress → Plexo migration — same tools, same descriptions as the live connector in
+// plexo-web (lib/mcp/wpMigrationTools.ts), executed through plexo-web's REST API.
+// get_wordpress_migration advances the migration one step per call, like the dashboard.
+
+export const WP_MIGRATION_TOOL_DEFS = [
+  {
+    name: "preview_wordpress_migration",
+    description: `Checks a WordPress website and previews what moving it to Plexo would involve — WITHOUT changing anything. Finds WordPress even when it's installed in a subfolder or behind a splash/landing page, and returns page/post/media counts, the theme, and what will happen to each plugin (replaced by a Plexo feature, carried over as-is, needs attention, or not needed). Call this first and show the owner the plugin outcomes — especially anything marked NEEDS_ATTENTION (e.g. payment/donation plugins) — before calling start_wordpress_migration.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "The site's public address, e.g. 'example.org' or 'https://example.org/blog'. Any page on the site works." },
+      },
+      required: ["url"],
+    },
+  },
+  {
+    name: "start_wordpress_migration",
+    description: `Starts moving a WordPress site to a NEW Plexo site (never overwrites an existing one). Copies every page exactly as it looks (theme, Elementor and other page-builder designs, fonts, animations), every blog post into Plexo Blog, the whole media library, and every SEO tag — keeping every web address identical so search rankings and links survive. Forms (Forminator, Contact Form 7, WPForms, Elementor) are reconnected to Plexo Forms. The WordPress site itself is not changed.
+
+Requires the owner's explicit confirmation that they own the site (ownershipConfirmed: true) — ask them, never assume. If their account hasn't accepted Plexo's Acceptable Use Policy yet, the call fails with requiresAupAcceptance; ask them to read /legal/acceptable-use and retry with acceptAcceptableUsePolicy: true only if they agree.
+
+Returns templateId + jobId. Then call get_wordpress_migration repeatedly (each call advances the migration) until phase is COMPLETED.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "The site's public address (same as preview_wordpress_migration)." },
+        ownershipConfirmed: { type: "boolean", description: "true only if the owner confirmed they own the site or have permission to move it." },
+        acceptAcceptableUsePolicy: { type: "boolean", description: "true only if the owner agreed to Plexo's Acceptable Use Policy (needed once per account)." },
+      },
+      required: ["url", "ownershipConfirmed"],
+    },
+  },
+  {
+    name: "get_wordpress_migration",
+    description: `Advances a WordPress migration by one step and returns its progress — call it repeatedly until phase is COMPLETED (or PAUSED_ERROR, in which case calling again retries from where it stopped). When COMPLETED, returns the report: what was copied, SEO comparison, what happened to each plugin, and a cutover checklist. Items with status "blocked" (e.g. connecting payments for a donation form) must be done before the owner points their domain at Plexo; tell the owner about them plainly. Omit jobId to get the organization's most recent migration.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        templateId: { type: "string", description: "The Plexo site id returned by start_wordpress_migration." },
+        jobId: { type: "string", description: "The migration id returned by start_wordpress_migration." },
+      },
+    },
+  },
+  {
+    name: "connect_wordpress_migrator_plugin",
+    description: `Starts copying what WordPress keeps private (past form entries and applications, donation history, drafts, redirect rules, the team list) for a finished migration. Returns a download link for the read-only "Plexo Migrator" WordPress plugin and a connection code. Tell the owner: install and activate the plugin (Plugins → Add New → Upload Plugin), then paste the code in WordPress under Tools → Plexo Migrator. Then call import_wordpress_private_data.`,
+    inputSchema: { type: "object", properties: { templateId: { type: "string" }, jobId: { type: "string" } }, required: ["templateId", "jobId"] },
+  },
+  {
+    name: "import_wordpress_private_data",
+    description: `Checks the Plexo Migrator plugin connection and copies the next batch of private data. Call repeatedly until stage is "done". If it returns an error message, relay it to the owner (it says exactly what to do, e.g. "paste the code in Tools → Plexo Migrator"). When done, the result lists the team found on WordPress — offer to invite them.`,
+    inputSchema: { type: "object", properties: { templateId: { type: "string" }, jobId: { type: "string" } }, required: ["templateId", "jobId"] },
+  },
+  {
+    name: "get_domain_switch_plan",
+    description: `For a finished migration: reads the old domain's live DNS and returns exactly how to point it at Plexo — who hosts the DNS (and whether cancelling the WordPress hosting would delete it), the email provider, records to KEEP unchanged (email, verification), records to ADD for Plexo, step-by-step instructions and a zone file. Connect the domain first with publish_existing_landing_page (CUSTOM, both apex and www) so the certificate records are included. Always relay the warnings to the owner.`,
+    inputSchema: { type: "object", properties: { templateId: { type: "string" }, jobId: { type: "string" } }, required: ["templateId", "jobId"] },
+  },
+  {
+    name: "verify_domain_switch",
+    description: `Checks on the real domain that Plexo now serves every migrated URL, email records are intact, DNS no longer depends on the old host, and nothing in the migration is blocking. Only tell the owner it's safe to cancel WordPress hosting when safeToCancelWordPress is true. Call get_domain_switch_plan first.`,
+    inputSchema: { type: "object", properties: { templateId: { type: "string" }, jobId: { type: "string" } }, required: ["templateId", "jobId"] },
+  },
+];
+
+export const WP_MIGRATION_TOOL_NAMES = new Set(WP_MIGRATION_TOOL_DEFS.map((t) => t.name));
+
+const TERMINAL = new Set(["COMPLETED", "FAILED", "CANCELLED"]);
+
+function ids(args: any): { templateId: string; jobId: string } {
+  const templateId = typeof args?.templateId === "string" ? args.templateId.trim() : "";
+  const jobId = typeof args?.jobId === "string" ? args.jobId.trim() : "";
+  if (!templateId || !jobId) throw new Error("templateId and jobId are required (from start_wordpress_migration).");
+  return { templateId, jobId };
+}
+
+function summarizeReport(report: any) {
+  return {
+    readyForCutover: report.readyForCutover,
+    checklist: report.checklist,
+    summary: report.summary,
+    seo: report.seo,
+    plugins: (report.plugins ?? []).map((p: any) => ({ name: p.name, outcome: p.outcome, explanation: p.explanation })),
+    formsReconnected: (report.forms ?? []).map((f: any) => ({ page: f.page, name: f.name, fields: f.fields })),
+    brokenLinks: (report.brokenLinks ?? []).slice(0, 20),
+    failedFiles: (report.failedFiles ?? []).slice(0, 20),
+  };
+}
+
+export async function handleWpMigrationToolCall(name: string, args: any, client: PlexoClient): Promise<any> {
+  const base = client.appBaseUrl;
+  switch (name) {
+    case "preview_wordpress_migration": {
+      if (typeof args?.url !== "string" || !args.url.trim()) throw new Error("url is required.");
+      const result = await client.previewWordPressMigration(args.url);
+      return { preview: result.preview };
+    }
+
+    case "start_wordpress_migration": {
+      const result = await client.startWordPressMigration({
+        sourceUrl: String(args?.url ?? ""),
+        ownershipAttested: args?.ownershipConfirmed === true,
+        acceptAup: args?.acceptAcceptableUsePolicy === true ? true : undefined,
+      });
+      if (!result.ok) return { started: false, error: result.error, requiresAupAcceptance: result.requiresAupAcceptance ?? false, existingMigration: result.existing ?? null };
+      return {
+        started: true,
+        templateId: result.templateId,
+        jobId: result.jobId,
+        dashboardUrl: `${base}/dashboard/migrate/wordpress?site=${result.templateId}&job=${result.jobId}`,
+        next: "Call get_wordpress_migration with this templateId and jobId until phase is COMPLETED.",
+      };
+    }
+
+    case "get_wordpress_migration": {
+      let templateId = typeof args?.templateId === "string" ? args.templateId : "";
+      let jobId = typeof args?.jobId === "string" ? args.jobId : "";
+      if (!templateId || !jobId) {
+        const { migrations } = await client.listWordPressMigrations();
+        if (!migrations?.length) return { found: false, message: "No WordPress migrations yet — start one with start_wordpress_migration." };
+        templateId = migrations[0].templateId;
+        jobId = migrations[0].id;
+      }
+      const before = await client.getWordPressMigration(templateId, jobId);
+      if (!TERMINAL.has(before.job.phase)) await client.stepWordPressMigration(templateId, jobId);
+      const { job, domains } = await client.getWordPressMigration(templateId, jobId);
+      const dashboardUrl = `${base}/dashboard/migrate/wordpress?site=${templateId}&job=${jobId}`;
+      if (job.phase === "COMPLETED" && job.report) {
+        return {
+          phase: job.phase,
+          templateId,
+          jobId,
+          dashboardUrl,
+          publishedDomains: (domains ?? []).map((d: any) => d.domain),
+          report: summarizeReport(job.report),
+          next: "Use get_domain_switch_plan to move the owner's domain; keep WordPress running until verify_domain_switch says it's safe.",
+        };
+      }
+      return {
+        phase: job.phase,
+        templateId,
+        jobId,
+        dashboardUrl,
+        counts: job.counts ?? null,
+        lastError: job.phase === "PAUSED_ERROR" ? (job.errors ?? []).slice(-1)[0] : undefined,
+        next: job.phase === "PAUSED_ERROR" ? "Call get_wordpress_migration again to retry from where it stopped." : "Call get_wordpress_migration again to continue.",
+      };
+    }
+
+    case "get_domain_switch_plan": {
+      const { templateId, jobId } = ids(args);
+      const result = await client.getDomainSwitchPlan(templateId, jobId);
+      return { ...result.plan, connectedDomains: (result.connected ?? []).map((d: any) => d.domain) };
+    }
+
+    case "verify_domain_switch": {
+      const { templateId, jobId } = ids(args);
+      return (await client.verifyDomainSwitch(templateId, jobId)).verification;
+    }
+
+    case "connect_wordpress_migrator_plugin": {
+      const { templateId, jobId } = ids(args);
+      const current = await client.getMigratorConnector(templateId, jobId);
+      const code = current.connector?.code ?? (await client.createMigratorConnector(templateId, jobId)).connector.code;
+      return {
+        pluginDownloadUrl: `${base}/api/v1/wp-migration/plugin`,
+        connectionCode: code,
+        steps: [
+          "Download the plugin (sign in to Plexo in the browser first) and install it: Plugins → Add New → Upload Plugin, then Activate.",
+          "In WordPress, go to Tools → Plexo Migrator and paste the connection code.",
+          "Then call import_wordpress_private_data.",
+        ],
+      };
+    }
+
+    case "import_wordpress_private_data": {
+      const { templateId, jobId } = ids(args);
+      let { connector } = await client.getMigratorConnector(templateId, jobId);
+      if (connector?.status !== "CONNECTED") {
+        connector = (await client.getMigratorConnector(templateId, jobId, true)).connector;
+        if (connector?.status !== "CONNECTED") return { connected: false, message: connector?.error ?? "Call connect_wordpress_migrator_plugin first." };
+      }
+      const { extras } = await client.importMigratorData(templateId, jobId);
+      return {
+        connected: true,
+        stage: extras.stage,
+        counts: extras.counts,
+        team: extras.stage === "done" ? extras.team : undefined,
+        error: extras.error,
+        next: extras.stage === "done" ? "Done. Offer to invite the team (admins as admin, others as editor of this site)." : "Call import_wordpress_private_data again to continue.",
+      };
+    }
+  }
+  throw new Error(`Unknown tool: ${name}`);
+}