brewpage-mcp 1.13.0 → 1.13.1

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.13.0
+npx -y brewpage-mcp@1.13.1
 ```
 
 Requires Node.js 20 or newer. This starts the stdio server for an MCP client.
@@ -33,7 +33,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.13.0"]
+      "args": ["-y", "brewpage-mcp@1.13.1"]
     }
   }
 }
@@ -44,7 +44,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.13.0
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.13.1
 ```
 
 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).
@@ -58,7 +58,7 @@ Open **Settings > MCP** and add:
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.13.0"]
+      "args": ["-y", "brewpage-mcp@1.13.1"]
     }
   }
 }
@@ -72,7 +72,7 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.13.0"]
+    "args": ["-y", "brewpage-mcp@1.13.1"]
   }
 }
 ```
@@ -80,7 +80,7 @@ Open the Cline MCP settings panel and add:
 ### Global Install
 
 ```bash
-npm install -g brewpage-mcp@1.13.0
+npm install -g brewpage-mcp@1.13.1
 brewpage-mcp
 ```
 
@@ -491,6 +491,10 @@ Every publish response includes an **owner token** -- the only credential that a
 
 ## Changelog
 
+## 1.13.1 -- 2026-10-25
+
+- Old publications (created before the new link format): update tools say they answer `409 OLD_PUBLICATION_READ_ONLY`; that failure adds a hint to publish the content anew and give the user the new URL and owner token.
+
 ## 1.13.0 -- 2026-10-25
 
 - Identifying `User-Agent: brewpage-mcp/1.13.0` on every BrewPage call.

package/dist/index.js

@@ -3,10 +3,10 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 const BASE_URL = process.env.BREWPAGE_URL || "https://brewpage.app";
-const USER_AGENT = "brewpage-mcp/1.13.0";
+const USER_AGENT = "brewpage-mcp/1.13.1";
 const server = new McpServer({
     name: "brewpage-mcp",
-    version: "1.13.0",
+    version: "1.13.1",
 });
 const OWNER_TOKEN_SHAPE = /^[A-Za-z0-9]{32}$/;
 const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
@@ -25,6 +25,8 @@ const CREATE_OWNER_TOKEN_DESCRIPTION = `Optional. Default: ${OWNER_TOKEN_ENV}, e
 const OWNER_TOKEN_DESCRIPTION = `Owner token from create. Default: ${OWNER_TOKEN_ENV}.`;
 const SECRETS = "Secrets allowed; likely ones are flagged in notices. For a secret: private namespace + password.";
 const MANAGE_URL_TEXT = "Returns manageUrl (private): give it to the user privately; never publish it.";
+const OLD_READ_ONLY_CODE = "OLD_PUBLICATION_READ_ONLY";
+const OLD_READ_ONLY_TEXT = ` Old publications (created before the new link format) answer 409 ${OLD_READ_ONLY_CODE}.`;
 /** Notice codes the agent must relay to the user. */
 const WARNING_CODES = new Set(["secret-detected", "manage-link-disabled"]);
 /** MCP type name -> REST path segment. */
@@ -42,13 +44,19 @@ function maskToken(token) {
 function textResult(text, isError = false) {
     return isError ? { content: [{ type: "text", text }], isError: true } : { content: [{ type: "text", text }] };
 }
-/** Owner-tool failure: the server answer verbatim plus a hint for a plain wrong-token 403. */
+/** Owner-tool failure: the server answer verbatim plus a hint for a plain wrong-token 403 or a frozen old publication. */
 function ownerFailure(operation, status, data, fromEnv) {
     const lines = [`Failed to ${operation} (${status}): ${JSON.stringify(data)}`];
     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 === 409 && code === OLD_READ_ONLY_CODE) {
+        lines.push("Read-only old publication: cannot be updated. Publish the content anew with the matching " +
+            "publish tool in the same namespace; give the user the NEW URL and owner token. The old URL keeps its old content " +
+            "until it expires. Ignore republishUrl (browser-only)." +
+            (operation === "set KV" ? " For KV, read all keys with get_kv and publish them together with publish_kv." : ""));
+    }
     return textResult(lines.join("\n"), true);
 }
 /** Every BrewPage call identifies the client; source-file downloads use plain fetch. */
@@ -563,7 +571,7 @@ server.tool("publish_site", "Publish an HTML site to BrewPage. Single-page: pass
         content: [{ type: "text", text: lines.join("\n") }],
     };
 });
-server.tool("republish_site", "Republish (full-replace) an existing multi-file BrewPage site in place at the SAME URL/ID. Requires owner token. The uploaded bundle becomes the complete new file set — files absent from it are removed, new files added, matching files overwritten. Single-page: pass `entryContent`. Multi-page: pass `files` (array of `{path, content}`). Optional `entry` overrides the default `index.html`. Republishing preserves existing expiry. " + SITE_LIMITS_TEXT, {
+server.tool("republish_site", "Republish (full-replace) an existing multi-file BrewPage site in place at the SAME URL/ID. Requires owner token. The uploaded bundle becomes the complete new file set — files absent from it are removed, new files added, matching files overwritten. Single-page: pass `entryContent`. Multi-page: pass `files` (array of `{path, content}`). Optional `entry` overrides the default `index.html`. Republishing preserves existing expiry." + OLD_READ_ONLY_TEXT + " " + SITE_LIMITS_TEXT, {
     namespace: z.string().describe("Site namespace"),
     id: z.string().describe("Site ID"),
     ownerToken: z.string().optional().describe(OWNER_TOKEN_DESCRIPTION),
@@ -656,7 +664,7 @@ server.tool("republish_site", "Republish (full-replace) an existing multi-file B
     };
 });
 server.tool("update_html", "Update an existing BrewPage HTML/Markdown page. Requires owner token. Returns the updated page metadata. " +
-    "The link and delivery mode never change on update; an advisory deliveryModeReason and delivery notice are included when the new content uses browser features that may not work fully on a BrewPage link.", {
+    "The link and delivery mode never change on update; an advisory deliveryModeReason and delivery notice are included when the new content uses browser features that may not work fully on a BrewPage link." + OLD_READ_ONLY_TEXT, {
     namespace: z.string().describe("Page namespace"),
     id: z.string().describe("Page ID"),
     content: z.string().describe("New HTML or Markdown content"),
@@ -786,7 +794,7 @@ server.tool("get_json", "Fetch a published BrewPage JSON document by namespace a
         ],
     };
 });
-server.tool("update_json", "Update an existing BrewPage JSON document. Requires owner token. Accepts a JSON object, array, or a JSON-encoded string.", {
+server.tool("update_json", "Update an existing BrewPage JSON document. Requires owner token. Accepts a JSON object, array, or a JSON-encoded string." + OLD_READ_ONLY_TEXT, {
     namespace: z.string().describe("Document namespace"),
     id: z.string().describe("Document ID"),
     json: z
@@ -879,7 +887,7 @@ server.tool("publish_kv", "Publish a key/value entry to BrewPage. Creates a KV s
         ],
     };
 });
-server.tool("set_kv", "Set or update a key in an existing BrewPage KV store. Requires owner token. The key name `hosting` is reserved.", {
+server.tool("set_kv", "Set or update a key in an existing BrewPage KV store. Requires owner token. The key name `hosting` is reserved." + OLD_READ_ONLY_TEXT, {
     namespace: z.string().describe("KV store namespace"),
     id: z.string().describe("KV store ID"),
     key: z.string().describe("Key to set"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brewpage-mcp",
-  "version": "1.13.0",
+  "version": "1.13.1",
   "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",