bricks-mcp-server 0.8.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.8.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.",
@@ -358,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.8.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": {