bricks-mcp-server 0.7.0 → 0.9.0

package/dist/index.js

@@ -33,8 +33,15 @@ 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.7.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "bricks-mcp-server", version: "0.9.0" }, { capabilities: { tools: {} } });
 const tools = [
+    {
+        name: "bricks_start_here",
+        description: "CALL THIS FIRST, once per session, before any other bricks_* tool. Returns everything needed to work on this site safely: site identity, capabilities (dry-run state, ACF, query filters), the content model (post types + taxonomies + ACF fields), a design-system summary, existing templates, and the working rules that prevent the classic Bricks failure modes (write conflicts, wrong template fields, un-indexed filters, clobbered global classes).",
+        inputSchema: { type: "object", properties: {}, additionalProperties: false },
+        schema: z.object({}),
+        handler: async () => wpRequest("/start-here"),
+    },
     {
         name: "bricks_ping",
         description: "Verify the WordPress connection and report which site you're connected to (wp_url + site that answered), Bricks + WP version.",
@@ -140,6 +147,14 @@ const tools = [
                     type: "object",
                     description: "Taxonomy terms, e.g. { \"categoria_noticia\": [\"Difusión\"] }.",
                 },
+                acf: {
+                    type: "object",
+                    description: "ACF fields by name, e.g. { \"anio\": \"2024\" }. Uses ACF update_field so {acf_*} dynamic tags render.",
+                },
+                meta: {
+                    type: "object",
+                    description: "Raw post meta by key (for non-ACF custom fields).",
+                },
                 content: { type: "array", description: "Bricks elements array" },
                 header: { type: "array" },
                 footer: { type: "array" },
@@ -158,6 +173,8 @@ const tools = [
             date: z.string().optional(),
             featured_media: z.number().int().nonnegative().optional(),
             terms: z.record(z.any()).optional(),
+            acf: z.record(z.any()).optional(),
+            meta: z.record(z.any()).optional(),
             content: z.array(z.any()).optional(),
             header: z.array(z.any()).optional(),
             footer: z.array(z.any()).optional(),
@@ -201,6 +218,14 @@ const tools = [
                     type: "object",
                     description: "Taxonomy terms, e.g. { \"categoria_noticia\": [\"Difusión\"] }.",
                 },
+                acf: {
+                    type: "object",
+                    description: "ACF fields by name, e.g. { \"anio\": \"2024\", \"autores\": \"Rojas, H.\" }. Uses ACF update_field so {acf_*} dynamic tags render.",
+                },
+                meta: {
+                    type: "object",
+                    description: "Raw post meta by key (for non-ACF custom fields).",
+                },
                 content: { type: "array", description: "Bricks elements array (for Bricks-designed pages)" },
                 settings: { type: "object" },
             },
@@ -217,6 +242,8 @@ const tools = [
             date: z.string().optional(),
             featured_media: z.number().int().positive().optional(),
             terms: z.record(z.any()).optional(),
+            acf: z.record(z.any()).optional(),
+            meta: z.record(z.any()).optional(),
             content: z.array(z.any()).optional(),
             settings: z.record(z.any()).optional(),
         }),
@@ -338,11 +365,33 @@ const tools = [
         handler: async () => wpRequest("/theme-styles"),
     },
 ];
+// MCP tool annotations (readOnlyHint / destructiveHint / idempotentHint) so
+// clients can calibrate approval prompts. "Destructive" here means the write
+// overwrites or removes existing data (even though the plugin snapshots first);
+// additive creates are non-destructive.
+const TOOL_ANNOTATIONS = {
+    bricks_start_here: { readOnlyHint: true },
+    bricks_ping: { readOnlyHint: true },
+    bricks_get_schema: { readOnlyHint: true },
+    bricks_list_pages: { readOnlyHint: true },
+    bricks_get_page: { readOnlyHint: true },
+    bricks_list_templates: { readOnlyHint: true },
+    bricks_get_global_classes: { readOnlyHint: true },
+    bricks_get_theme_styles: { readOnlyHint: true },
+    bricks_list_media: { readOnlyHint: true },
+    bricks_create_page: { readOnlyHint: false, destructiveHint: false },
+    bricks_create_template: { readOnlyHint: false, destructiveHint: false },
+    bricks_reindex_query_filters: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
+    bricks_update_page: { readOnlyHint: false, destructiveHint: true },
+    bricks_update_global_classes: { readOnlyHint: false, destructiveHint: true },
+    bricks_delete_page: { readOnlyHint: false, destructiveHint: true },
+};
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: tools.map(({ name, description, inputSchema }) => ({
         name,
         description,
         inputSchema,
+        annotations: TOOL_ANNOTATIONS[name],
     })),
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bricks-mcp-server",
-  "version": "0.7.0",
+  "version": "0.9.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": {