brewpage-mcp 1.16.2 → 1.16.4

package/README.md

@@ -17,7 +17,7 @@ Choosing a host? See how BrewPage compares with GitHub Pages, Netlify Drop, Tiin
 ## Quick Start
 
 ```bash
-npx -y brewpage-mcp@1.16.2
+npx -y brewpage-mcp@1.16.4
 ```
 
 Requires Node.js 20 or newer. This starts the stdio server for an MCP client.
@@ -50,7 +50,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.16.2"]
+      "args": ["-y", "brewpage-mcp@1.16.4"]
     }
   }
 }
@@ -61,7 +61,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 Register a project-scoped stdio server:
 
 ```bash
-claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.16.2
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.16.4
 ```
 
 This writes `.mcp.json` in the project root. Use `--scope user` for user-scoped registration. See the [official Claude Code MCP guide](https://code.claude.com/docs/en/mcp).
@@ -75,7 +75,7 @@ Open **Settings > MCP** and add:
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.16.2"]
+      "args": ["-y", "brewpage-mcp@1.16.4"]
     }
   }
 }
@@ -89,7 +89,7 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.16.2"]
+    "args": ["-y", "brewpage-mcp@1.16.4"]
   }
 }
 ```
@@ -97,7 +97,7 @@ Open the Cline MCP settings panel and add:
 ### Global Install
 
 ```bash
-npm install -g brewpage-mcp@1.16.2
+npm install -g brewpage-mcp@1.16.4
 brewpage-mcp
 ```
 
@@ -530,6 +530,14 @@ Every publish response includes an **owner token** -- the only credential that a
 
 ## Changelog
 
+## 1.16.4 -- 2026-10-30
+
+- Owner update tools (`update_html`, `republish_site`, `update_json`, `set_kv`) answer a 404 with the server body plus which publish tool makes a new copy; `delete_resource` relays the 404 unchanged.
+
+## 1.16.3 -- 2026-10-30
+
+- Create `ownerToken` description: the token from the first create keeps publications under one owner; the owner-token banner adds that it goes as `ownerToken` on later publishes and updates; `publish_site` says static HTML, CSS and JS (incl. built bundles) run in the browser, PHP and other server code never run. Gemini context: save `ownerToken` privately, never in chat.
+
 ## 1.16.2 -- 2026-10-30
 
 - `ttlDays` description names the 90-day cap with an owner token in a profile.

package/dist/tools.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/server";
 export declare const DEFAULT_BASE_URL = "https://brewpage.app";
-export declare const USER_AGENT = "brewpage-mcp/1.16.2";
+export declare const USER_AGENT = "brewpage-mcp/1.16.4";
 export declare const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
 export interface ServerOptions {
     /** BrewPage origin for API calls; default https://brewpage.app. */

package/dist/tools.js

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/server";
 import { z } from "zod";
 export const DEFAULT_BASE_URL = "https://brewpage.app";
-export const USER_AGENT = "brewpage-mcp/1.16.2";
+export const USER_AGENT = "brewpage-mcp/1.16.4";
 export const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
 const READ_ONLY = { readOnlyHint: true };
 const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true };
@@ -13,7 +13,7 @@ function toolMeta(title, hints) {
 /** Env default exists only in the local (stdio) server; remote /mcp takes ownerToken per call. */
 const ENV_DEFAULT = `env ${OWNER_TOKEN_ENV} (local server only)`;
 const NO_OWNER_TOKEN = `No owner token: pass ownerToken (local server: or set ${OWNER_TOKEN_ENV}).`;
-const CREATE_OWNER_TOKEN_DESCRIPTION = `Optional. Default: ${ENV_DEFAULT}, else a new token per create.`;
+const CREATE_OWNER_TOKEN_DESCRIPTION = `Optional; the ownerToken from your first create keeps publications under one owner. Default: ${ENV_DEFAULT}, else a new token per create.`;
 const OWNER_TOKEN_DESCRIPTION = `Owner token from create. Default: ${ENV_DEFAULT}.`;
 /** Backend guard checks create and update content alike. */
 const NO_PUBLIC_CREDENTIALS = "BrewPage tokens and manage links must never be in public content.";
@@ -59,13 +59,20 @@ function retryAfterText(status, headers) {
     const after = status === 503 ? headers?.get("retry-after") : null;
     return after ? ` Retry-After: ${after}.` : "";
 }
-/** Owner-tool failure: the server answer verbatim plus a hint for a plain wrong-token 403 or a frozen old publication. */
+/** Create tool for each content update: a 404 update means the row is gone, so the agent publishes anew. */
+const PUBLISH_TOOL_FOR = {
+    "update HTML": "publish_html", "republish site": "publish_site", "update JSON": "publish_json", "set KV": "publish_kv",
+};
+/** Owner-tool failure: the server answer verbatim plus a hint for a wrong-token 403, a missing row or a frozen old publication. */
 function ownerFailure(operation, status, data, fromEnv, headers) {
     const lines = [`Failed to ${operation} (${status}): ${JSON.stringify(data)}${retryAfterText(status, headers)}`];
     const code = data?.code;
     if (status === 403 && (code === undefined || code === "OWNER_AUTHORIZATION_FAILED")) {
         lines.push(`Wrong owner token for this publication. Use ownerToken from create.${fromEnv ? ` Sent: ${OWNER_TOKEN_ENV}.` : ""}`);
     }
+    if (status === 404 && PUBLISH_TOOL_FOR[operation]) {
+        lines.push(`Use the ${PUBLISH_TOOL_FOR[operation]} tool to publish a new copy.`);
+    }
     if (status === 409 && code === OLD_READ_ONLY_CODE) {
         const { createUrl, republishUrl } = data;
         lines.push("Read-only old publication: cannot be updated. " +
@@ -209,7 +216,7 @@ export function createServer(options = {}) {
     const apiFetch = options.fetch ?? fetch;
     const server = new McpServer({
         name: "brewpage-mcp",
-        version: "1.16.2",
+        version: "1.16.4",
     });
     /** Caller argument first, then the configured default; `fromEnv` marks the configured one. */
     function ownerTokenFor(argument) {
@@ -240,7 +247,7 @@ export function createServer(options = {}) {
             `OWNER TOKEN: ${shown}`,
             `===================================`,
             ``,
-            `IMPORTANT: Save your owner token! You need it to ${purpose}. It cannot be recovered if lost.`,
+            `IMPORTANT: Save your owner token! You need it to ${purpose}. It cannot be recovered if lost. Pass it as ownerToken on later publishes and updates.`,
             ...(token !== sent && token !== defaultOwnerToken ? [SIGN_IN_HINT] : []),
         ];
     }
@@ -538,7 +545,8 @@ export function createServer(options = {}) {
     });
     server.registerTool("publish_site", {
         ...toolMeta("Publish site", ADDITIVE),
-        description: "Publish an HTML site to BrewPage. Single-page: `entryContent`. Multi-page: `files` (array of `{path, content}`). Optional `entry` overrides default `index.html`. Returns its primary share link and owner token. " + SITE_LIMITS_TEXT +
+        description: "Publish an HTML site to BrewPage. Single-page: `entryContent`. Multi-page: `files` (array of `{path, content}`). Optional `entry` overrides default `index.html`. Returns its primary share link and owner token. " +
+            "Static sites: HTML, CSS and JS (incl. built React/Vue/TypeScript bundles) run in the browser; PHP and other server code never run. " + SITE_LIMITS_TEXT +
             " " + MANAGE_URL_TEXT + " " + SECRETS,
         inputSchema: {
             deliveryMode: DELIVERY_MODE_SCHEMA,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brewpage-mcp",
-  "version": "1.16.2",
+  "version": "1.16.4",
   "mcpName": "io.github.kochetkov-ma/brewpage-mcp",
   "description": "MCP server for BrewPage — publish and manage HTML, sites, KV, JSON and files from AI assistants",
   "type": "module",