bricks-mcp-server 0.13.0 → 0.14.0

package/dist/contracts.js

@@ -12,6 +12,13 @@ export const globalClassOperationsSchema = z.object({ expected_hash: z.string().
 export const manageTemplateSchema = z.object({ id: z.number().int().positive(), action: z.enum(["get", "update", "clone", "delete"]), expected_modified: z.string().optional(), title: z.string().optional(), status: z.enum(["draft", "publish", "private"]).optional(), type: z.string().optional(), content: z.array(z.any()).optional(), settings: z.record(z.any()).optional(), conditions: z.array(z.any()).optional(), force: z.boolean().optional() }).superRefine((v, ctx) => { if (v.action === "update" && !v.expected_modified)
     ctx.addIssue({ code: z.ZodIssueCode.custom, message: "expected_modified is required for update" }); });
 export const previewUrlSchema = z.object({ id: z.number().int().positive(), ttl: z.number().int().min(60).max(900).optional() });
+export const dynamicDataSchema = z.object({ post_id: z.number().int().positive(), user_id: z.number().int().positive().optional(), context: z.enum(["text", "link", "image", "media"]).optional(), items: z.array(z.string().min(1).max(20000)).min(1).max(50) });
+export const revisionsSchema = z.object({ post_id: z.number().int().positive(), action: z.enum(["list", "compare", "restore"]), from: z.union([z.number().int().positive(), z.literal("current")]).optional(), to: z.union([z.number().int().positive(), z.literal("current")]).optional(), revision_id: z.number().int().positive().optional(), expected_modified: z.string().optional() }).superRefine((v, ctx) => { if (v.action === "compare" && (v.from === undefined || v.to === undefined))
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "from and to are required" }); if (v.action === "restore" && (!v.revision_id || !v.expected_modified))
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "revision_id and expected_modified are required" }); });
+export const customCssSchema = z.object({ action: z.enum(["get", "update"]), scope: z.enum(["global", "post"]), post_id: z.number().int().positive().optional(), css: z.string().max(204800).optional(), expected_hash: z.string().length(64).optional() }).superRefine((v, ctx) => { if (v.scope === "post" && !v.post_id)
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "post_id is required" }); if (v.action === "update" && (v.css === undefined || !v.expected_hash))
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "css and expected_hash are required" }); });
 export function buildToolRequest(name, args) {
     if (name === "bricks_update_page") {
         const parsed = updatePageSchema.parse(args);
@@ -48,6 +55,19 @@ export function buildToolRequest(name, args) {
         const parsed = previewUrlSchema.parse(args);
         return { path: `/preview/${parsed.id}`, method: "GET", query: parsed.ttl ? { ttl: String(parsed.ttl) } : undefined };
     }
+    if (name === "bricks_resolve_dynamic_data")
+        return { path: "/dynamic-data/resolve", method: "POST", body: dynamicDataSchema.parse(args) };
+    if (name === "bricks_manage_revisions") {
+        const parsed = revisionsSchema.parse(args);
+        const { post_id, action, ...body } = parsed;
+        return action === "list" ? { path: `/revisions/${post_id}`, method: "GET" } : { path: `/revisions/${post_id}/${action}`, method: "POST", body };
+    }
+    if (name === "bricks_manage_custom_css") {
+        const parsed = customCssSchema.parse(args);
+        const { action, scope, post_id, ...body } = parsed;
+        const query = { scope, ...(post_id ? { post_id: String(post_id) } : {}) };
+        return action === "get" ? { path: "/custom-css", method: "GET", query } : { path: "/custom-css", method: "PUT", query, body };
+    }
     if (name === "bricks_upload_media")
         return { path: "/media", method: "POST", body: uploadMediaSchema.parse(args) };
     if (name === "bricks_find_media_usage")

package/dist/index.js

@@ -33,7 +33,7 @@ if (subcommand === "doctor" || subcommand === "diagnose") {
 if (process.env.WP_URL) {
     console.error(`[bricks-mcp] target WP_URL=${process.env.WP_URL} WP_USER=${process.env.WP_USER ?? "?"}`);
 }
-const server = new Server({ name: "bricks-mcp-server", version: "0.13.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "bricks-mcp-server", version: "0.14.0" }, { capabilities: { tools: {} } });
 const tools = [
     {
         name: "bricks_start_here",
@@ -400,6 +400,42 @@ const tools = [
         schema: z.object({ id: z.number().int().positive(), ttl: z.number().int().min(60).max(900).optional() }),
         handler: async (args) => wpRequest(`/preview/${args.id}`, { query: args.ttl ? { ttl: String(args.ttl) } : undefined }),
     }, {
+        name: "bricks_resolve_dynamic_data",
+        description: "Preview 1–50 Bricks dynamic-data strings against an explicit post and optional user context. Uses Bricks' public renderer and blocks remote {echo} execution.",
+        inputSchema: { type: "object", properties: { post_id: { type: "number" }, user_id: { type: "number" }, context: { type: "string", enum: ["text", "link", "image", "media"] }, items: { type: "array", items: { type: "string" }, minItems: 1, maxItems: 50 } }, required: ["post_id", "items"], additionalProperties: false },
+        schema: z.object({ post_id: z.number().int().positive(), user_id: z.number().int().positive().optional(), context: z.enum(["text", "link", "image", "media"]).optional(), items: z.array(z.string().min(1).max(20000)).min(1).max(50) }),
+        handler: async (args) => wpRequest("/dynamic-data/resolve", { method: "POST", body: args }),
+    },
+    {
+        name: "bricks_manage_revisions",
+        description: "List, compare, or restore Bricks-aware WordPress revisions. Restore requires expected_modified, honors dry-run, and creates an undo revision first.",
+        inputSchema: { type: "object", properties: { post_id: { type: "number" }, action: { type: "string", enum: ["list", "compare", "restore"] }, from: { type: ["number", "string"] }, to: { type: ["number", "string"] }, revision_id: { type: "number" }, expected_modified: { type: "string" } }, required: ["post_id", "action"], additionalProperties: false },
+        schema: z.object({ post_id: z.number().int().positive(), action: z.enum(["list", "compare", "restore"]), from: z.union([z.number().int().positive(), z.literal("current")]).optional(), to: z.union([z.number().int().positive(), z.literal("current")]).optional(), revision_id: z.number().int().positive().optional(), expected_modified: z.string().optional() }).superRefine((v, ctx) => { if (v.action === "compare" && (v.from === undefined || v.to === undefined))
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: "from and to are required for compare" }); if (v.action === "restore" && (!v.revision_id || !v.expected_modified))
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: "revision_id and expected_modified are required for restore" }); }),
+        handler: async (args) => { const { post_id, action, ...body } = args; if (action === "list")
+            return wpRequest(`/revisions/${post_id}`); return wpRequest(`/revisions/${post_id}/${action}`, { method: "POST", body }); },
+    },
+    {
+        name: "bricks_manage_custom_css",
+        description: "Read or update global/post Bricks Custom CSS. Update requires the current hash, honors dry-run, snapshots the previous value, and regenerates assets.",
+        inputSchema: { type: "object", properties: { action: { type: "string", enum: ["get", "update"] }, scope: { type: "string", enum: ["global", "post"] }, post_id: { type: "number" }, css: { type: "string" }, expected_hash: { type: "string" } }, required: ["action", "scope"], additionalProperties: false },
+        schema: z.object({ action: z.enum(["get", "update"]), scope: z.enum(["global", "post"]), post_id: z.number().int().positive().optional(), css: z.string().max(204800).optional(), expected_hash: z.string().length(64).optional() }).superRefine((v, ctx) => { if (v.scope === "post" && !v.post_id)
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: "post_id is required for post scope" }); if (v.action === "update" && (v.css === undefined || !v.expected_hash))
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: "css and expected_hash are required for update" }); }),
+        handler: async (args) => { const { action, scope, post_id, ...body } = args; const query = { scope: String(scope), ...(post_id ? { post_id: String(post_id) } : {}) }; return action === "get" ? wpRequest("/custom-css", { query }) : wpRequest("/custom-css", { method: "PUT", query, body }); },
+    },
+    {
+        name: "bricks_manage_integrations",
+        description: "Inspect/create WooCommerce Bricks templates or inspect/test the configured signed outbound webhook.",
+        inputSchema: { type: "object", properties: { integration: { type: "string", enum: ["woocommerce", "webhook"] }, action: { type: "string", enum: ["status", "types", "list", "create", "test"] }, type: { type: "string" }, title: { type: "string" }, status: { type: "string" }, content: { type: "array" }, settings: { type: "object" }, conditions: { type: "array" } }, required: ["integration", "action"], additionalProperties: false },
+        schema: z.object({ integration: z.enum(["woocommerce", "webhook"]), action: z.enum(["status", "types", "list", "create", "test"]), type: z.string().optional(), title: z.string().optional(), status: z.enum(["draft", "publish", "private"]).optional(), content: z.array(z.any()).optional(), settings: z.record(z.any()).optional(), conditions: z.array(z.any()).optional() }).superRefine((v, ctx) => { if (v.integration === "webhook" && !["status", "test"].includes(v.action))
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: "webhook supports status or test" }); if (v.integration === "woocommerce" && v.action === "create" && (!v.type || !v.title))
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: "type and title are required for create" }); }),
+        handler: async (args) => { const { integration, ...body } = args; if (integration === "webhook")
+            return body.action === "status" ? wpRequest("/webhooks") : wpRequest("/webhooks", { method: "POST", body }); return body.action === "status" ? wpRequest("/woocommerce/templates") : wpRequest("/woocommerce/templates", { method: "POST", body }); },
+    },
+    {
         name: "bricks_get_global_classes",
         description: "Read Bricks global classes and their categories — useful before editing pages so styling stays consistent.",
         inputSchema: { type: "object", properties: {}, additionalProperties: false },
@@ -449,6 +485,10 @@ const TOOL_ANNOTATIONS = {
     bricks_get_global_classes: { readOnlyHint: true },
     bricks_get_theme_styles: { readOnlyHint: true },
     bricks_get_design_context: { readOnlyHint: true },
+    bricks_resolve_dynamic_data: { readOnlyHint: true },
+    bricks_manage_revisions: { readOnlyHint: false, destructiveHint: true },
+    bricks_manage_custom_css: { readOnlyHint: false, destructiveHint: true },
+    bricks_manage_integrations: { readOnlyHint: false, destructiveHint: false },
     bricks_get_element: { readOnlyHint: true },
     bricks_apply_element_operations: { readOnlyHint: false, destructiveHint: true },
     bricks_list_media: { readOnlyHint: true },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bricks-mcp-server",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Provider-agnostic MCP server that exposes Bricks Builder pages, templates, global classes and theme styles as tools. Works with any MCP-compatible client (Claude Code, Codex CLI, etc.).",
   "type": "module",
   "bin": {