@charisol/plexo-mcp 1.0.3 → 1.0.4

package/dist/client/plexoClient.js

@@ -99,6 +99,22 @@ class PlexoClient {
         }
         return data;
     }
+    async getStrataTokens(projectId) {
+        this.checkAuth();
+        const url = new URL(`${this.baseUrl}/api/v1/strata/tokens`);
+        if (projectId) {
+            url.searchParams.set("projectId", projectId);
+        }
+        const res = await fetch(url.toString(), {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        const data = (await res.json());
+        if (!res.ok) {
+            throw new Error(data?.error || `Failed to fetch Strata tokens (Status ${res.status})`);
+        }
+        return data;
+    }
     async listTemplates() {
         this.checkAuth();
         const res = await fetch(`${this.baseUrl}/api/templates`, {

package/dist/index.js

@@ -167,7 +167,7 @@ EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
                 name: "create_email_template",
                 description: `Creates and saves a responsive HTML email template for newsletters or promotional campaigns.
 
-Uses the SAME fully-hydrated layout schema as publish_landing_page — designJson MUST be { "body": { "style": {...}, "rows": [{ "id", "style", "columns": [{ "id", "width", "elements": [{ "id", "type", "style", "attributes" }] }] }] } }. There is no shorthand row format; rows without a 'columns' array are rejected. See publish_landing_page's description for a full worked example. Email templates are saved but never published to a domain.`,
+Uses the SAME fully-hydrated layout schema as publish_landing_page — designJson MUST be { "body": { "style": {...}, "rows": [{ "id", "style", "columns": [{ "id", "width", "elements": [{ "id", "type", "style", "attributes" }] }] }] } }. There is no shorthand row format; rows without a 'columns' array are rejected. Text content for heading/paragraph/text/button elements MUST be under attributes.text (NOT attributes.content) — a "content" key is silently ignored by the editor and renders as empty/placeholder text. See publish_landing_page's description for a full worked example. Email templates are saved but never published to a domain.`,
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -178,6 +178,74 @@ Uses the SAME fully-hydrated layout schema as publish_landing_page — designJso
                         designJson: {
                             type: "object",
                             description: "Plexo layout schema object (same shape as publish_landing_page's designJson) containing body style and a fully hydrated rows array with columns and elements.",
+                            required: ["body"],
+                            properties: {
+                                body: {
+                                    type: "object",
+                                    required: ["style", "rows"],
+                                    properties: {
+                                        style: {
+                                            type: "object",
+                                            description: "Global CSS style and page metadata.",
+                                            required: ["backgroundColor", "color", "fontFamily", "htmlTitle"],
+                                            properties: {
+                                                backgroundColor: { type: "string", description: "Background color of the email in hex format (e.g. '#F4F2F8')." },
+                                                color: { type: "string", description: "Default text color of the email in hex format." },
+                                                fontFamily: { type: "string", description: "Font family of the email text (e.g. 'Arial, Helvetica, sans-serif')." },
+                                                htmlTitle: { type: "string", description: "The HTML title of the email (matches the subject/brand name)." },
+                                            },
+                                        },
+                                        rows: {
+                                            type: "array",
+                                            description: "Array of row objects. Every row MUST already have a 'columns' array — there is no shorthand row type; rows without 'columns' are rejected.",
+                                            items: {
+                                                type: "object",
+                                                required: ["id", "style", "columns"],
+                                                properties: {
+                                                    id: { type: "string" },
+                                                    style: { type: "object" },
+                                                    columns: {
+                                                        type: "array",
+                                                        description: "Required. One entry per column.",
+                                                        items: {
+                                                            type: "object",
+                                                            required: ["id", "width", "elements"],
+                                                            properties: {
+                                                                id: { type: "string" },
+                                                                width: { type: "string", description: "Percentage width (e.g. '100%', '50%', '33.33%')." },
+                                                                elements: {
+                                                                    type: "array",
+                                                                    items: {
+                                                                        type: "object",
+                                                                        required: ["id", "type", "style", "attributes"],
+                                                                        properties: {
+                                                                            type: {
+                                                                                type: "string",
+                                                                                enum: ["heading", "paragraph", "text", "button", "card", "image", "menu", "social", "divider", "spacer", "form_container", "input", "textarea", "select", "carousel", "html", "icon", "table", "timer", "video"],
+                                                                            },
+                                                                            style: { type: "object" },
+                                                                            attributes: {
+                                                                                type: "object",
+                                                                                description: "Component attributes. IMPORTANT: text content for 'heading'/'paragraph'/'text'/'button' elements goes under the key 'text' (NOT 'content'). Images use 'src'/'alt'. Buttons/links use 'href'.",
+                                                                                properties: {
+                                                                                    text: { type: "string", description: "Visible text for heading/paragraph/text/button elements." },
+                                                                                    href: { type: "string", description: "Link URL for button/card elements." },
+                                                                                    src: { type: "string", description: "Image URL for image elements." },
+                                                                                    alt: { type: "string", description: "Alt text for image elements." },
+                                                                                },
+                                                                            },
+                                                                        },
+                                                                    },
+                                                                },
+                                                            },
+                                                        },
+                                                    },
+                                                },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
                         },
                         compiledHtml: {
                             type: "string",
@@ -187,6 +255,23 @@ Uses the SAME fully-hydrated layout schema as publish_landing_page — designJso
                     required: ["designJson"],
                 },
             },
+            {
+                name: "get_strata_tokens",
+                description: `Checks whether the account has a Strata design-system project connected and, if so, fetches its design tokens (colors, typography, spacing, etc).
+
+Call this BEFORE publish_landing_page or create_email_template whenever the user wants their brand/Strata colors and styles used. Call with no arguments first to check the currently connected project. If the result has "connected": false, ask the user for their Strata project id (found in their Strata project's snapshot/share URL) and call this tool again with that projectId — it connects the account to that project (remembered for future calls) and fetches its tokens in the same call.
+
+Map the returned tokens into designJson style fields: color-type tokens into backgroundColor/color/borderColor, spacing-type tokens into padding/margin values, and any font-related tokens into fontFamily/fontSize. Prefer tokens whose "name" hints at their role (e.g. a name containing "primary", "background", "text", "accent").`,
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        projectId: {
+                            type: "string",
+                            description: "Optional. The user's Strata project id to connect (or switch to). Omit to check/use the previously connected project, if any.",
+                        },
+                    },
+                },
+            },
             {
                 name: "update_template",
                 description: `Edits an existing landing page or email template in place, under the same template ID. Recompiles and re-saves the HTML from the new designJson — the editable URL stays the same, and for a published landing page the live URL and domain are unchanged too (this does not publish/unpublish or change the domain; call publish_landing_page again with a domain for that).
@@ -300,6 +385,17 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "get_strata_tokens": {
+                const result = await client.getStrataTokens(args?.projectId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
             case "update_template": {
                 const result = await client.updateTemplate(args);
                 return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@charisol/plexo-mcp",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Model Context Protocol (MCP) Server for Plexo - Landing page generation, email templates, publishing, and analytics.",
   "main": "dist/index.js",
   "bin": {

package/src/client/plexoClient.ts

@@ -136,6 +136,26 @@ export class PlexoClient {
     return data;
   }
 
+  async getStrataTokens(projectId?: string): Promise<any> {
+    this.checkAuth();
+    const url = new URL(`${this.baseUrl}/api/v1/strata/tokens`);
+    if (projectId) {
+      url.searchParams.set("projectId", projectId);
+    }
+
+    const res = await fetch(url.toString(), {
+      method: "GET",
+      headers: this.getHeaders(),
+    });
+
+    const data = (await res.json()) as any;
+    if (!res.ok) {
+      throw new Error(data?.error || `Failed to fetch Strata tokens (Status ${res.status})`);
+    }
+
+    return data;
+  }
+
   async listTemplates(): Promise<any> {
     this.checkAuth();
     const res = await fetch(`${this.baseUrl}/api/templates`, {

package/src/index.ts

@@ -174,7 +174,7 @@ EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
         name: "create_email_template",
         description: `Creates and saves a responsive HTML email template for newsletters or promotional campaigns.
 
-Uses the SAME fully-hydrated layout schema as publish_landing_page — designJson MUST be { "body": { "style": {...}, "rows": [{ "id", "style", "columns": [{ "id", "width", "elements": [{ "id", "type", "style", "attributes" }] }] }] } }. There is no shorthand row format; rows without a 'columns' array are rejected. See publish_landing_page's description for a full worked example. Email templates are saved but never published to a domain.`,
+Uses the SAME fully-hydrated layout schema as publish_landing_page — designJson MUST be { "body": { "style": {...}, "rows": [{ "id", "style", "columns": [{ "id", "width", "elements": [{ "id", "type", "style", "attributes" }] }] }] } }. There is no shorthand row format; rows without a 'columns' array are rejected. Text content for heading/paragraph/text/button elements MUST be under attributes.text (NOT attributes.content) — a "content" key is silently ignored by the editor and renders as empty/placeholder text. See publish_landing_page's description for a full worked example. Email templates are saved but never published to a domain.`,
         inputSchema: {
           type: "object",
           properties: {
@@ -185,6 +185,74 @@ Uses the SAME fully-hydrated layout schema as publish_landing_page — designJso
             designJson: {
               type: "object",
               description: "Plexo layout schema object (same shape as publish_landing_page's designJson) containing body style and a fully hydrated rows array with columns and elements.",
+              required: ["body"],
+              properties: {
+                body: {
+                  type: "object",
+                  required: ["style", "rows"],
+                  properties: {
+                    style: {
+                      type: "object",
+                      description: "Global CSS style and page metadata.",
+                      required: ["backgroundColor", "color", "fontFamily", "htmlTitle"],
+                      properties: {
+                        backgroundColor: { type: "string", description: "Background color of the email in hex format (e.g. '#F4F2F8')." },
+                        color: { type: "string", description: "Default text color of the email in hex format." },
+                        fontFamily: { type: "string", description: "Font family of the email text (e.g. 'Arial, Helvetica, sans-serif')." },
+                        htmlTitle: { type: "string", description: "The HTML title of the email (matches the subject/brand name)." },
+                      },
+                    },
+                    rows: {
+                      type: "array",
+                      description: "Array of row objects. Every row MUST already have a 'columns' array — there is no shorthand row type; rows without 'columns' are rejected.",
+                      items: {
+                        type: "object",
+                        required: ["id", "style", "columns"],
+                        properties: {
+                          id: { type: "string" },
+                          style: { type: "object" },
+                          columns: {
+                            type: "array",
+                            description: "Required. One entry per column.",
+                            items: {
+                              type: "object",
+                              required: ["id", "width", "elements"],
+                              properties: {
+                                id: { type: "string" },
+                                width: { type: "string", description: "Percentage width (e.g. '100%', '50%', '33.33%')." },
+                                elements: {
+                                  type: "array",
+                                  items: {
+                                    type: "object",
+                                    required: ["id", "type", "style", "attributes"],
+                                    properties: {
+                                      type: {
+                                        type: "string",
+                                        enum: ["heading", "paragraph", "text", "button", "card", "image", "menu", "social", "divider", "spacer", "form_container", "input", "textarea", "select", "carousel", "html", "icon", "table", "timer", "video"],
+                                      },
+                                      style: { type: "object" },
+                                      attributes: {
+                                        type: "object",
+                                        description: "Component attributes. IMPORTANT: text content for 'heading'/'paragraph'/'text'/'button' elements goes under the key 'text' (NOT 'content'). Images use 'src'/'alt'. Buttons/links use 'href'.",
+                                        properties: {
+                                          text: { type: "string", description: "Visible text for heading/paragraph/text/button elements." },
+                                          href: { type: "string", description: "Link URL for button/card elements." },
+                                          src: { type: "string", description: "Image URL for image elements." },
+                                          alt: { type: "string", description: "Alt text for image elements." },
+                                        },
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                  },
+                },
+              },
             },
             compiledHtml: {
               type: "string",
@@ -194,6 +262,23 @@ Uses the SAME fully-hydrated layout schema as publish_landing_page — designJso
           required: ["designJson"],
         },
       },
+      {
+        name: "get_strata_tokens",
+        description: `Checks whether the account has a Strata design-system project connected and, if so, fetches its design tokens (colors, typography, spacing, etc).
+
+Call this BEFORE publish_landing_page or create_email_template whenever the user wants their brand/Strata colors and styles used. Call with no arguments first to check the currently connected project. If the result has "connected": false, ask the user for their Strata project id (found in their Strata project's snapshot/share URL) and call this tool again with that projectId — it connects the account to that project (remembered for future calls) and fetches its tokens in the same call.
+
+Map the returned tokens into designJson style fields: color-type tokens into backgroundColor/color/borderColor, spacing-type tokens into padding/margin values, and any font-related tokens into fontFamily/fontSize. Prefer tokens whose "name" hints at their role (e.g. a name containing "primary", "background", "text", "accent").`,
+        inputSchema: {
+          type: "object",
+          properties: {
+            projectId: {
+              type: "string",
+              description: "Optional. The user's Strata project id to connect (or switch to). Omit to check/use the previously connected project, if any.",
+            },
+          },
+        },
+      },
       {
         name: "update_template",
         description: `Edits an existing landing page or email template in place, under the same template ID. Recompiles and re-saves the HTML from the new designJson — the editable URL stays the same, and for a published landing page the live URL and domain are unchanged too (this does not publish/unpublish or change the domain; call publish_landing_page again with a domain for that).
@@ -311,6 +396,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      case "get_strata_tokens": {
+        const result = await client.getStrataTokens((args as any)?.projectId);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
       case "update_template": {
         const result = await client.updateTemplate(args as any);
         return {