@charisol/plexo-mcp 1.0.7 → 1.0.8

package/src/client/plexoClient.ts

@@ -355,4 +355,134 @@ export class PlexoClient {
 
     return data;
   }
+
+  /** Fetches a single template's full details, including designJson — used by the blog
+   * layout tools to read back a layout template's current content (there's no other
+   * templateId-scoped GET in the public API; list endpoints only return metadata). */
+  async getTemplate(templateId: string): Promise<any> {
+    this.checkAuth();
+    const res = await fetch(`${this.baseUrl}/api/v1/templates/${encodeURIComponent(templateId)}`, {
+      method: "GET",
+      headers: this.getHeaders(),
+    });
+
+    const data = (await res.json()) as any;
+    if (!res.ok) {
+      throw new Error(data?.error || `Failed to fetch template (Status ${res.status})`);
+    }
+
+    return data;
+  }
+
+  /** Shared request helper for every /api/blog/{templateId}/... route below — these are
+   * the same admin endpoints the Plexo dashboard's own blog UI calls, and (like every
+   * other route in this client) accept the same Bearer/x-api-key auth as the rest of the
+   * public API (see resolveUser/resolveBlogAdminSite server-side). */
+  private async blogFetch(method: string, templateId: string, path: string, body?: unknown): Promise<any> {
+    this.checkAuth();
+    const res = await fetch(`${this.baseUrl}/api/blog/${encodeURIComponent(templateId)}${path}`, {
+      method,
+      headers: this.getHeaders(),
+      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+    });
+
+    const data = (await res.json().catch(() => ({}))) as any;
+    if (!res.ok) {
+      throw new Error(data?.error || `Blog request failed (Status ${res.status})`);
+    }
+    return data;
+  }
+
+  /** Idempotent — returns the existing layout template id if one's already attached to
+   * this kind rather than creating a duplicate. Pair with updateTemplate() to set its
+   * designJson (see blogTools.ts's designBlogLayout). */
+  async ensureBlogLayout(templateId: string, kind: "post" | "listing"): Promise<any> {
+    return this.blogFetch("POST", templateId, `/layout/${kind}`);
+  }
+
+  /** Detaches the layout (reverts to the default theme) without deleting the underlying Template row. */
+  async resetBlogLayout(templateId: string, kind: "post" | "listing"): Promise<any> {
+    return this.blogFetch("DELETE", templateId, `/layout/${kind}`);
+  }
+
+  async getBlogSite(templateId: string): Promise<any> {
+    return this.blogFetch("GET", templateId, "/site");
+  }
+
+  async updateBlogSite(templateId: string, patch: Record<string, any>): Promise<any> {
+    return this.blogFetch("PATCH", templateId, "/site", patch);
+  }
+
+  async listBlogPosts(templateId: string, params: { status?: string; search?: string; categoryId?: string } = {}): Promise<any> {
+    const query = new URLSearchParams();
+    if (params.status) query.set("status", params.status);
+    if (params.search) query.set("search", params.search);
+    if (params.categoryId) query.set("categoryId", params.categoryId);
+    const qs = query.toString();
+    return this.blogFetch("GET", templateId, `/posts${qs ? `?${qs}` : ""}`);
+  }
+
+  async getBlogPost(templateId: string, postId: string): Promise<any> {
+    return this.blogFetch("GET", templateId, `/posts/${encodeURIComponent(postId)}`);
+  }
+
+  async createBlogPost(templateId: string, payload: Record<string, any>): Promise<any> {
+    return this.blogFetch("POST", templateId, "/posts", payload);
+  }
+
+  async updateBlogPost(templateId: string, postId: string, payload: Record<string, any>): Promise<any> {
+    return this.blogFetch("PATCH", templateId, `/posts/${encodeURIComponent(postId)}`, payload);
+  }
+
+  async deleteBlogPost(templateId: string, postId: string): Promise<any> {
+    return this.blogFetch("DELETE", templateId, `/posts/${encodeURIComponent(postId)}`);
+  }
+
+  async listBlogCategories(templateId: string): Promise<any> {
+    return this.blogFetch("GET", templateId, "/categories");
+  }
+
+  async createBlogCategory(templateId: string, payload: { name: string; description?: string; parentId?: string | null }): Promise<any> {
+    return this.blogFetch("POST", templateId, "/categories", payload);
+  }
+
+  async deleteBlogCategory(templateId: string, categoryId: string): Promise<any> {
+    return this.blogFetch("DELETE", templateId, `/categories/${encodeURIComponent(categoryId)}`);
+  }
+
+  async listBlogTags(templateId: string): Promise<any> {
+    return this.blogFetch("GET", templateId, "/tags");
+  }
+
+  async createBlogTag(templateId: string, name: string): Promise<any> {
+    return this.blogFetch("POST", templateId, "/tags", { name });
+  }
+
+  async deleteBlogTag(templateId: string, tagId: string): Promise<any> {
+    return this.blogFetch("DELETE", templateId, `/tags/${encodeURIComponent(tagId)}`);
+  }
+
+  async listBlogAuthors(templateId: string): Promise<any> {
+    return this.blogFetch("GET", templateId, "/authors");
+  }
+
+  async createBlogAuthor(templateId: string, payload: { name: string; bio?: string; avatarUrl?: string }): Promise<any> {
+    return this.blogFetch("POST", templateId, "/authors", payload);
+  }
+
+  async deleteBlogAuthor(templateId: string, authorId: string): Promise<any> {
+    return this.blogFetch("DELETE", templateId, `/authors/${encodeURIComponent(authorId)}`);
+  }
+
+  async listBlogComments(templateId: string, status?: string): Promise<any> {
+    return this.blogFetch("GET", templateId, `/comments${status ? `?status=${encodeURIComponent(status)}` : ""}`);
+  }
+
+  async moderateBlogComment(templateId: string, commentId: string, status: string): Promise<any> {
+    return this.blogFetch("PATCH", templateId, `/comments/${encodeURIComponent(commentId)}`, { status });
+  }
+
+  async deleteBlogComment(templateId: string, commentId: string): Promise<any> {
+    return this.blogFetch("DELETE", templateId, `/comments/${encodeURIComponent(commentId)}`);
+  }
 }

package/src/index.ts

@@ -7,6 +7,7 @@ import {
   ListToolsRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
 import { PlexoClient } from "./client/plexoClient.js";
+import { BLOG_TOOL_DEFS, BLOG_TOOL_NAMES, handleBlogToolCall } from "./blogTools.js";
 
 const server = new Server(
   {
@@ -136,7 +137,7 @@ EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
                                     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"],
+                                        enum: ["heading", "paragraph", "text", "button", "card", "image", "menu", "social", "divider", "spacer", "form_container", "input", "textarea", "select", "carousel", "html", "icon", "table", "timer", "video", "accordion", "blog_title", "blog_content", "blog_featured_image", "blog_date", "blog_author", "blog_categories", "blog_comments", "blog_post_list"],
                                       },
                                       style: { type: "object" },
                                       attributes: { type: "object", description: "Component attributes (text, href, src, title, description, links, fields). For type 'html', raw markup goes under 'htmlContent' — NOT 'text'." },
@@ -228,7 +229,7 @@ Uses the SAME fully-hydrated layout schema as publish_landing_page — designJso
                                     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"],
+                                        enum: ["heading", "paragraph", "text", "button", "card", "image", "menu", "social", "divider", "spacer", "form_container", "input", "textarea", "select", "carousel", "html", "icon", "table", "timer", "video", "accordion", "blog_title", "blog_content", "blog_featured_image", "blog_date", "blog_author", "blog_categories", "blog_comments", "blog_post_list"],
                                       },
                                       style: { type: "object" },
                                       attributes: {
@@ -503,6 +504,7 @@ To edit a page's CONTENT (designJson), use update_template with the same templat
           },
         },
       },
+      ...BLOG_TOOL_DEFS,
     ],
   };
 });
@@ -720,8 +722,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
-      default:
+      default: {
+        if (BLOG_TOOL_NAMES.has(name)) {
+          const result = await handleBlogToolCall(name, (args as any) || {}, client);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+              },
+            ],
+          };
+        }
         throw new Error(`Unknown tool: ${name}`);
+      }
     }
   } catch (error) {
     return {