@charisol/plexo-mcp 1.0.10 → 1.0.11

package/README.md

@@ -16,6 +16,9 @@ Connect **Claude Desktop**, **Claude Web**, **ChatGPT**, **Cursor**, **Windsurf*
 - 📊 **`get_analytics`**: Fetches total page views, unique visitor counts, and daily timelines.
 - 👤 **`get_user_profile`**: Checks subscription plan, AI credit balance, and domain usage limits.
 - 🗑️ **`delete_published_domain`**: Unlinks or deletes published domains.
+- 📝 **Blog, Commerce and Funnels**: full parity with the Plexo dashboard — posts, products, orders, refunds, bank transfers, discounts, delivery, customers and funnel pages.
+- 💚 **Donations**: `list_donations`, `create_donation_campaign`, `update_donation_campaign`, `cancel_monthly_donation`, `adopt_monthly_donors` — one-time and monthly giving with receipts and a donor self-service cancel link.
+- 🔁 **Move from WordPress**: `preview_wordpress_migration`, `start_wordpress_migration`, `get_wordpress_migration` (call repeatedly — each call advances the move), `connect_wordpress_migrator_plugin`, `import_wordpress_private_data`, `get_domain_switch_plan`, `verify_domain_switch` — copies a whole WordPress site (pages, posts, media, theme, forms, donations, SEO, same URLs) and guides the domain switch safely.
 
 ---
 
@@ -69,3 +72,5 @@ If `PLEXO_API_KEY` is omitted, the tool cleanly prompts:
 - *"Generate a modern tech SaaS landing page for an AI CRM called Acme and publish it using Plexo to subdomain acme-crm"*
 - *"Show me my page view analytics for the last 7 days"*
 - *"List all my email templates"*
+- *"Move my WordPress site example.org to Plexo"*
+- *"Add a donation form with $25, $50 and $100 options and monthly giving to my homepage"*

package/dist/blogTools.js

@@ -3,26 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BLOG_TOOL_NAMES = exports.BLOG_TOOL_DEFS = void 0;
 exports.handleBlogToolCall = handleBlogToolCall;
 const BLOG_LAYOUT_EXAMPLE = `
+DESIGN QUALITY applies here exactly as in publish_landing_page's description: pick one small ink/paper/accent palette and a serif-heading + sans-body (+ optional uppercase-mono eyebrow) type system, keep borderRadius near 0, use boxShadow sparingly, and give blog_content a constrained maxWidth (~680-760px) so long-form reading stays comfortable — do not default to generic #ffffff/Inter/fontWeight-800.
+
 EXAMPLE — a single-post layout with a hero image, title, meta line, and content:
 {
   "body": {
-    "style": { "backgroundColor": "#ffffff", "color": "#1e293b", "fontFamily": "Inter, sans-serif", "htmlTitle": "Blog Post" },
+    "style": { "backgroundColor": "#FAF7F1", "color": "#1B2430", "fontFamily": "'Inter', sans-serif", "htmlTitle": "Blog Post" },
     "rows": [
       { "id": "row-hero", "style": { "paddingTop": "0px" }, "columns": [
         { "id": "col-hero", "width": "100%", "elements": [
           { "id": "el-featured", "type": "blog_featured_image", "style": { "width": "100%", "maxHeight": "420px", "objectFit": "cover" }, "attributes": {} }
         ] }
       ] },
-      { "id": "row-meta", "style": { "paddingTop": "32px", "paddingBottom": "8px" }, "columns": [
+      { "id": "row-meta", "style": { "paddingTop": "40px", "paddingBottom": "8px", "maxWidth": "760px", "margin": "0 auto" }, "columns": [
         { "id": "col-title", "width": "100%", "elements": [
-          { "id": "el-title", "type": "blog_title", "style": { "fontSize": "40px", "fontWeight": "800" }, "attributes": {} },
-          { "id": "el-authordate", "type": "blog_author", "style": { "fontSize": "14px", "color": "#64748b", "display": "inline-block", "marginRight": "12px" }, "attributes": {} },
-          { "id": "el-date", "type": "blog_date", "style": { "fontSize": "14px", "color": "#64748b", "display": "inline-block" }, "attributes": {} }
+          { "id": "el-title", "type": "blog_title", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "40px", "lineHeight": "1.15" }, "attributes": {} },
+          { "id": "el-authordate", "type": "blog_author", "style": { "fontFamily": "'IBM Plex Mono', monospace", "fontSize": "12px", "letterSpacing": "0.1em", "textTransform": "uppercase", "color": "#5B6472", "display": "inline-block", "marginRight": "12px", "marginTop": "16px" }, "attributes": {} },
+          { "id": "el-date", "type": "blog_date", "style": { "fontFamily": "'IBM Plex Mono', monospace", "fontSize": "12px", "letterSpacing": "0.1em", "textTransform": "uppercase", "color": "#5B6472", "display": "inline-block" }, "attributes": {} }
         ] }
       ] },
-      { "id": "row-body", "style": { "paddingTop": "24px", "paddingBottom": "48px" }, "columns": [
+      { "id": "row-body", "style": { "paddingTop": "24px", "paddingBottom": "48px", "maxWidth": "760px", "margin": "0 auto" }, "columns": [
         { "id": "col-body", "width": "100%", "elements": [
-          { "id": "el-content", "type": "blog_content", "style": { "fontSize": "17px", "lineHeight": "1.7" }, "attributes": {} },
+          { "id": "el-content", "type": "blog_content", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "17px", "lineHeight": "1.75", "color": "#1B2430" }, "attributes": {} },
           { "id": "el-comments", "type": "blog_comments", "style": { "marginTop": "48px" }, "attributes": {} }
         ] }
       ] }
@@ -33,14 +35,15 @@ EXAMPLE — a single-post layout with a hero image, title, meta line, and conten
 EXAMPLE — a listing layout with a 3-column post grid:
 {
   "body": {
-    "style": { "backgroundColor": "#ffffff", "color": "#1e293b", "fontFamily": "Inter, sans-serif", "htmlTitle": "Blog" },
+    "style": { "backgroundColor": "#FAF7F1", "color": "#1B2430", "fontFamily": "'Inter', sans-serif", "htmlTitle": "Blog" },
     "rows": [
-      { "id": "row-heading", "style": { "paddingTop": "48px", "paddingBottom": "16px" }, "columns": [
+      { "id": "row-heading", "style": { "paddingTop": "56px", "paddingBottom": "16px" }, "columns": [
         { "id": "col-heading", "width": "100%", "elements": [
-          { "id": "el-heading", "type": "heading", "style": { "fontSize": "36px", "fontWeight": "800", "textAlign": "center" }, "attributes": { "text": "Latest Posts" } }
+          { "id": "el-eyebrow", "type": "text", "style": { "fontFamily": "'IBM Plex Mono', monospace", "fontSize": "12px", "letterSpacing": "0.16em", "textTransform": "uppercase", "color": "#C4623B", "textAlign": "center" }, "attributes": { "text": "Journal" } },
+          { "id": "el-heading", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "36px", "textAlign": "center", "margin": "8px 0 0" }, "attributes": { "text": "Latest Posts" } }
         ] }
       ] },
-      { "id": "row-list", "style": { "paddingBottom": "48px" }, "columns": [
+      { "id": "row-list", "style": { "paddingBottom": "56px" }, "columns": [
         { "id": "col-list", "width": "100%", "elements": [
           { "id": "el-postlist", "type": "blog_post_list", "style": { "gridColumns": "3" }, "attributes": {} }
         ] }

package/dist/client/plexoClient.js

@@ -643,5 +643,81 @@ class PlexoClient {
             throw new Error(data?.error || `Failed to fetch funnel addon slots (Status ${res.status})`);
         return data;
     }
+    /** Shared request helper for routes outside the blog/commerce/LMS families (WordPress migration, donations). */
+    async apiFetch(method, path, body, label = "Request") {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: this.getHeaders(),
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data?.error || `${label} failed (Status ${res.status})`);
+        return data;
+    }
+    get appBaseUrl() {
+        return this.baseUrl;
+    }
+    // ── Commerce: bank transfers ────────────────────────────────────────────────
+    async resolveBankTransferOrder(templateId, orderId, action, reason) {
+        return this.commerceFetch("POST", templateId, `/orders/${encodeURIComponent(orderId)}/bank-transfer`, { action, ...(reason ? { reason } : {}) });
+    }
+    // ── Donations (/api/v1/commerce/{templateId}/donations) ─────────────────────
+    async listDonations(templateId) {
+        return this.commerceFetch("GET", templateId, "/donations");
+    }
+    async createDonationCampaign(templateId, payload) {
+        return this.commerceFetch("POST", templateId, "/donations", payload);
+    }
+    async updateDonationCampaign(templateId, campaignId, payload) {
+        return this.commerceFetch("PATCH", templateId, `/donations/${encodeURIComponent(campaignId)}`, payload);
+    }
+    async cancelMonthlyDonation(templateId, subscriptionId) {
+        return this.commerceFetch("DELETE", templateId, `/donations/subscriptions/${encodeURIComponent(subscriptionId)}`);
+    }
+    async adoptMonthlyDonors(templateId, campaignId) {
+        return this.commerceFetch("POST", templateId, "/donations/adopt-monthly-donors", { campaignId });
+    }
+    // ── WordPress migration (/api/v1/wp-migration) ──────────────────────────────
+    async previewWordPressMigration(sourceUrl) {
+        return this.apiFetch("POST", "/api/v1/wp-migration/detect", { sourceUrl }, "WordPress check");
+    }
+    async startWordPressMigration(params) {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/wp-migration`, { method: "POST", headers: this.getHeaders(), body: JSON.stringify(params) });
+        const data = (await res.json().catch(() => ({})));
+        // Recoverable outcomes (needs AUP consent, already running) are returned, not thrown, so the assistant can act on them.
+        if (!res.ok && !data?.requiresAupAcceptance && !data?.existing)
+            throw new Error(data?.error || `Migration start failed (Status ${res.status})`);
+        return { ok: res.ok, ...data };
+    }
+    async listWordPressMigrations() {
+        return this.apiFetch("GET", "/api/v1/wp-migration", undefined, "Migration list");
+    }
+    migrationPath(templateId, jobId) {
+        return `/api/v1/wp-migration/${encodeURIComponent(templateId)}/${encodeURIComponent(jobId)}`;
+    }
+    async getWordPressMigration(templateId, jobId) {
+        return this.apiFetch("GET", this.migrationPath(templateId, jobId), undefined, "Migration status");
+    }
+    async stepWordPressMigration(templateId, jobId) {
+        return this.apiFetch("POST", `${this.migrationPath(templateId, jobId)}/step`, undefined, "Migration step");
+    }
+    async getMigratorConnector(templateId, jobId, check = false) {
+        return this.apiFetch("GET", `${this.migrationPath(templateId, jobId)}/connector${check ? "?check=1" : ""}`, undefined, "Plugin connection");
+    }
+    async createMigratorConnector(templateId, jobId) {
+        return this.apiFetch("POST", `${this.migrationPath(templateId, jobId)}/connector`, undefined, "Plugin connection");
+    }
+    async importMigratorData(templateId, jobId) {
+        return this.apiFetch("POST", `${this.migrationPath(templateId, jobId)}/connector/import`, undefined, "Private data import");
+    }
+    async getDomainSwitchPlan(templateId, jobId) {
+        return this.apiFetch("GET", `${this.migrationPath(templateId, jobId)}/cutover`, undefined, "Domain switch plan");
+    }
+    async verifyDomainSwitch(templateId, jobId) {
+        return this.apiFetch("POST", `${this.migrationPath(templateId, jobId)}/cutover/verify`, undefined, "Domain check");
+    }
 }
 exports.PlexoClient = PlexoClient;

package/dist/commerceTools.js

@@ -310,6 +310,20 @@ exports.COMMERCE_TOOL_DEFS = [
             required: ["templateId", "deliveryMethodId"],
         },
     },
+    {
+        name: "resolve_bank_transfer_order",
+        description: "Confirms or rejects a bank-transfer order that's waiting for payment (status PENDING, paymentMethod BANK_TRANSFER). action \"confirm\" marks it PAID and runs the normal paid flow (customer confirmation email, digital delivery, booking confirmed) — only use it once the site owner says the money has actually arrived in their account. action \"reject\" cancels it, releases its stock/booking slot, and emails the customer (optional reason is included).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The site's home page template id." },
+                orderId: { type: "string" },
+                action: { type: "string", enum: ["confirm", "reject"] },
+                reason: { type: "string", description: "Optional note to the customer when rejecting." },
+            },
+            required: ["templateId", "orderId", "action"],
+        },
+    },
     {
         name: "list_commerce_discounts",
         description: "Lists a site's discount codes, most recently created first.",
@@ -364,7 +378,7 @@ exports.COMMERCE_TOOL_DEFS = [
     },
     {
         name: "list_commerce_customers",
-        description: "Lists this site's customers directly from its Paystack account (the merchant account that actually processed their payments) — requires Paystack to be configured on this site.",
+        description: "Lists everyone who's completed a paid order with this site, aggregated from its own orders (works for Stripe or Paystack, however the customer paid).",
         inputSchema: {
             type: "object",
             properties: {
@@ -471,6 +485,15 @@ async function handleCommerceToolCall(name, args, client) {
                 throw new Error("deliveryMethodId is required.");
             await client.deleteCommerceDeliveryMethod(templateId, args.deliveryMethodId);
             return { success: true, deletedDeliveryMethodId: args.deliveryMethodId };
+        case "resolve_bank_transfer_order": {
+            const orderId = typeof args.orderId === "string" ? args.orderId.trim() : "";
+            if (!orderId)
+                throw new Error("orderId is required.");
+            if (args.action !== "confirm" && args.action !== "reject")
+                throw new Error('action must be "confirm" or "reject".');
+            const result = await client.resolveBankTransferOrder(templateId, orderId, args.action, typeof args.reason === "string" ? args.reason : undefined);
+            return { success: true, order: result.order };
+        }
         case "list_commerce_discounts":
             return await client.listCommerceDiscounts(templateId);
         case "create_commerce_discount": {

package/dist/donationTools.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DONATION_TOOL_NAMES = exports.DONATION_TOOL_DEFS = void 0;
+exports.handleDonationToolCall = handleDonationToolCall;
+// Plexo Donations — same tools, same descriptions as the live connector in plexo-web
+// (lib/mcp/donationTools.ts), executed through plexo-web's REST API. Amounts are in the
+// smallest currency unit, like every other Commerce tool.
+const CAMPAIGN_FIELDS = {
+    name: { type: "string", description: "What donors are giving to, e.g. 'Support our mission'." },
+    description: { type: "string", description: "Optional one-line description shown on the form." },
+    presetAmounts: {
+        type: "array",
+        description: "Suggested amounts in the smallest currency unit, optionally named — e.g. [{\"amountMinor\":2500,\"label\":\"Bronze\"},{\"amountMinor\":5000}].",
+        items: { type: "object", properties: { amountMinor: { type: "number" }, label: { type: "string" } }, required: ["amountMinor"] },
+    },
+    defaultPresetIndex: { type: "number", description: "Which suggested amount is pre-selected (0-based)." },
+    allowCustomAmount: { type: "boolean", description: "Let donors type their own amount (default true)." },
+    minAmountMinor: { type: "number", description: "Smallest custom amount, smallest currency unit (default 100)." },
+    allowMonthly: { type: "boolean", description: "Offer monthly giving (default true; needs Stripe or Paystack connected)." },
+    defaultFrequency: { type: "string", enum: ["ONCE", "MONTHLY"], description: "Which frequency is pre-selected." },
+    goalAmountMinor: { type: ["number", "null"], description: "Optional fundraising goal — shows a progress bar." },
+    thankYouMessage: { type: "string", description: "Shown after donating and in the receipt email." },
+    buttonLabel: { type: "string", description: "Donate button text (default 'Donate')." },
+};
+exports.DONATION_TOOL_DEFS = [
+    {
+        name: "list_donations",
+        description: "Shows a site's donations: totals (raised, donors, monthly donors), every donation form (campaign) with its amounts and progress, monthly donors, and recent gifts. Also says whether payments are connected yet (paymentsReady) — if not, tell the owner to connect Stripe/Paystack or add bank details in Commerce → Settings → Payments.",
+        inputSchema: { type: "object", properties: { templateId: { type: "string", description: "The site's home page id (see list_landing_pages)." } }, required: ["templateId"] },
+    },
+    {
+        name: "create_donation_campaign",
+        description: "Creates a donation form (campaign) for a site — one-time and optional monthly giving — and switches on everything donations need (no shop is created). Returns the campaign id and the embed snippet `<div data-plexo-donation=\"<id>\"></div>`: add that HTML to any page (e.g. via update_landing_page_page or a raw HTML page) to show a working donate form styled to the site.",
+        inputSchema: { type: "object", properties: { templateId: { type: "string", description: "The site's home page id." }, ...CAMPAIGN_FIELDS }, required: ["templateId", "name", "presetAmounts"] },
+    },
+    {
+        name: "update_donation_campaign",
+        description: "Edits a donation campaign. Only the fields you pass change. Pass active:false to turn a form off (gifts history is kept).",
+        inputSchema: {
+            type: "object",
+            properties: { templateId: { type: "string" }, campaignId: { type: "string" }, active: { type: "boolean" }, ...CAMPAIGN_FIELDS },
+            required: ["templateId", "campaignId"],
+        },
+    },
+    {
+        name: "cancel_monthly_donation",
+        description: "Stops one donor's monthly gift (at Stripe/Paystack too) — they won't be charged again. Only do this when the owner asks; confirm the donor first using list_donations.",
+        inputSchema: { type: "object", properties: { templateId: { type: "string" }, subscriptionId: { type: "string", description: "From list_donations' monthlyDonors[].id." } }, required: ["templateId", "subscriptionId"] },
+    },
+    {
+        name: "adopt_monthly_donors",
+        description: "Brings monthly donors over from a previous website: finds active monthly gifts on the site's connected Stripe/Paystack account that Plexo doesn't know yet and records them under a campaign, so every future charge is receipted and counted. Donors don't have to do anything. Requires the SAME payment account the old site used to be connected.",
+        inputSchema: { type: "object", properties: { templateId: { type: "string" }, campaignId: { type: "string" } }, required: ["templateId", "campaignId"] },
+    },
+];
+exports.DONATION_TOOL_NAMES = new Set(exports.DONATION_TOOL_DEFS.map((t) => t.name));
+async function handleDonationToolCall(name, args, client) {
+    const templateId = typeof args?.templateId === "string" ? args.templateId.trim() : "";
+    if (!templateId)
+        throw new Error("templateId is required — pass the site's home page id (see list_landing_pages).");
+    const { templateId: _t, campaignId, subscriptionId, ...fields } = args ?? {};
+    switch (name) {
+        case "list_donations":
+            return await client.listDonations(templateId);
+        case "create_donation_campaign": {
+            const { campaign } = await client.createDonationCampaign(templateId, fields);
+            const overview = await client.listDonations(templateId);
+            return {
+                campaign,
+                embedHtml: `<div data-plexo-donation="${campaign.id}"></div>`,
+                paymentsReady: overview.paymentsReady,
+                next: overview.paymentsReady
+                    ? "Add embedHtml to the page where donors should give."
+                    : "Add embedHtml to a page, and ask the owner to connect Stripe/Paystack (or add bank details) in Commerce → Settings → Payments — the form shows 'being set up' until then.",
+            };
+        }
+        case "update_donation_campaign": {
+            if (!campaignId)
+                throw new Error("campaignId is required — use list_donations for ids.");
+            const { campaign } = await client.updateDonationCampaign(templateId, String(campaignId), fields);
+            return { updated: true, campaign };
+        }
+        case "cancel_monthly_donation":
+            if (!subscriptionId)
+                throw new Error("subscriptionId is required — use list_donations' monthlyDonors[].id.");
+            return await client.cancelMonthlyDonation(templateId, String(subscriptionId));
+        case "adopt_monthly_donors":
+            if (!campaignId)
+                throw new Error("campaignId is required — use list_donations for ids.");
+            return await client.adoptMonthlyDonors(templateId, String(campaignId));
+    }
+    throw new Error(`Unknown tool: ${name}`);
+}

package/dist/index.js

@@ -8,6 +8,8 @@ const plexoClient_js_1 = require("./client/plexoClient.js");
 const blogTools_js_1 = require("./blogTools.js");
 const commerceTools_js_1 = require("./commerceTools.js");
 const lmsTools_js_1 = require("./lmsTools.js");
+const donationTools_js_1 = require("./donationTools.js");
+const wpMigrationTools_js_1 = require("./wpMigrationTools.js");
 const server = new index_js_1.Server({
     name: "plexo-mcp",
     version: "1.0.0",
@@ -24,55 +26,78 @@ server.setRequestHandler(types_js_1.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.
+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 (hero row, plus a 3-item product grid row):
+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." } }
+                ] }
+              ]
+            }
           ] }
         ]
       }
@@ -126,6 +151,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"],
@@ -139,6 +165,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.",
+                                                                    },
+                                                                },
                                                             },
                                                         },
                                                     },
@@ -610,6 +645,8 @@ To edit a page's CONTENT (designJson), use update_template with the same templat
             ...blogTools_js_1.BLOG_TOOL_DEFS,
             ...commerceTools_js_1.COMMERCE_TOOL_DEFS,
             ...lmsTools_js_1.LMS_TOOL_DEFS,
+            ...donationTools_js_1.DONATION_TOOL_DEFS,
+            ...wpMigrationTools_js_1.WP_MIGRATION_TOOL_DEFS,
         ],
     };
 });
@@ -886,6 +923,15 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         ],
                     };
                 }
+                for (const [names, handler] of [
+                    [donationTools_js_1.DONATION_TOOL_NAMES, donationTools_js_1.handleDonationToolCall],
+                    [wpMigrationTools_js_1.WP_MIGRATION_TOOL_NAMES, wpMigrationTools_js_1.handleWpMigrationToolCall],
+                ]) {
+                    if (names.has(name)) {
+                        const result = await handler(name, args || {}, client);
+                        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                    }
+                }
                 throw new Error(`Unknown tool: ${name}`);
             }
         }