brewpage-mcp 1.16.5 → 1.16.7

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.5
+npx -y brewpage-mcp@1.16.7
 ```
 
 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.5"]
+      "args": ["-y", "brewpage-mcp@1.16.7"]
     }
   }
 }
@@ -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.5
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.16.7
 ```
 
 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.5"]
+      "args": ["-y", "brewpage-mcp@1.16.7"]
     }
   }
 }
@@ -89,7 +89,7 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.16.5"]
+    "args": ["-y", "brewpage-mcp@1.16.7"]
   }
 }
 ```
@@ -97,7 +97,7 @@ Open the Cline MCP settings panel and add:
 ### Global Install
 
 ```bash
-npm install -g brewpage-mcp@1.16.5
+npm install -g brewpage-mcp@1.16.7
 brewpage-mcp
 ```
 
@@ -530,6 +530,14 @@ Every publish response includes an **owner token** -- the only credential that a
 
 ## Changelog
 
+## 1.16.7 -- 2026-11-01
+
+- Owner tools answer a 404 `WRONG_RESOURCE_TYPE` (this id lives under another type) with the server body plus the `resourceUrl` to repeat the write at, instead of the publish-anew hint. Contract 2.8.58.
+
+## 1.16.6 -- 2026-10-31
+
+- `publish_html`, `publish_file` and `publish_site` descriptions lead with `namespace=public` to be found (gallery + Google, Bing & AI search; omitted: private); the `namespace` input names what to publish publicly (docs, guides, demos, portfolios, reports, landing pages) and the generated `priv-*` default; the private result line says how to be found. Shorter texts, no new facts.
+
 ## 1.16.5 -- 2026-10-30
 
 - `update_html` takes optional `tags` (sent as `?tags=a,b`); `update_html` and `republish_site` tags replace the stored tags, `[]` clears them, omitted keeps them. A 429 on any write prints the server's `Retry-After` beside the verbatim body (`retryAfterSeconds`).

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.5";
+export declare const USER_AGENT = "brewpage-mcp/1.16.7";
 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.5";
+export const USER_AGENT = "brewpage-mcp/1.16.7";
 export const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
 const READ_ONLY = { readOnlyHint: true };
 const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true };
@@ -21,6 +21,7 @@ const SECRETS = "Secrets allowed; likely ones are flagged in notices. Private na
     NO_PUBLIC_CREDENTIALS;
 const MANAGE_URL_TEXT = "Returns manageUrl, a private management link (grants control; not for public sharing).";
 const OLD_READ_ONLY_CODE = "OLD_PUBLICATION_READ_ONLY";
+const WRONG_TYPE_CODE = "WRONG_RESOURCE_TYPE";
 const OLD_READ_ONLY_TEXT = ` Old publications (made before 5 October 2026) are read-only: 409 ${OLD_READ_ONLY_CODE} with createUrl to publish anew.`;
 /** Notice codes the agent must relay to the user. */
 const WARNING_CODES = new Set(["secret-detected"]);
@@ -63,14 +64,18 @@ function retryAfterText(status, headers) {
 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. */
+/** Owner-tool failure: server answer verbatim plus a hint for wrong-token 403, wrong-type or missing row, 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]) {
+    const resourceUrl = data?.resourceUrl;
+    if (status === 404 && code === WRONG_TYPE_CODE && typeof resourceUrl === "string") {
+        lines.push(`Wrong type for this id: repeat the write at resourceUrl (${resourceUrl}).`);
+    }
+    else 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) {
@@ -99,17 +104,19 @@ function resolveNamespace(namespace) {
     return namespace && namespace.length > 0 ? namespace : defaultPrivateNamespace();
 }
 const UNLISTED_NOTICE = "Private: not listed. Anyone with the link can open it.";
-const LISTABLE_HINT = " Use namespace public to list it in the gallery and sitemap.";
+const LISTABLE_HINT = " To be found, send namespace=public: gallery + Google, Bing & AI search.";
 const PROTECTED_UNLISTED_NOTICE = "Password: link + password. Not listed.";
-const PUBLIC_NAMESPACE_LEAD = "namespace=public: listed in the public gallery and the sitemap, so Google, Bing and AI search can find and index it " +
-    "and people can discover it. Suits anything meant to be found or shared: docs, guides, demos, portfolios, reports, landing pages. ";
+const PUBLIC_NAMESPACE_LEAD = "Send namespace=public for anything meant to be found or shared (docs, guides, demos, portfolios, reports, landing pages): " +
+    "listed in the public gallery and sitemap, so Google, Bing and AI search index it and people discover it. ";
 const PUBLIC_NAMESPACE_TAIL = " Anyone can find and read a public page, so it is unsuitable for secrets, tokens or personal data. " +
-    "Omit (default): private. Unlisted and not indexed; anyone who has the link can still open it. ";
+    "Omit (default): private, a generated priv-* namespace; unlisted, not indexed; the link still opens it. ";
+/** Tool-description lead for listable publish tools. */
+const PUBLIC_HINT = "Send namespace=public to be found: gallery + Google, Bing & AI search. Omitted: private. ";
 const NAMESPACE_FORMAT = "Lowercase only: 1-32 of a-z, 0-9, hyphen.";
 /** `namespace` for publish_html and publish_file. */
 const NAMESPACE_DESCRIPTION = PUBLIC_NAMESPACE_LEAD +
-    "Public pages are served right on the brewpage.app domain, which gives them the strongest reach in search; " +
-    "a page whose code needs its own origin (cookies, storage) gets its own subdomain automatically." +
+    "Public pages are served on the brewpage.app domain itself, for the strongest search reach; " +
+    "code that needs its own origin (cookies, storage) gets its own subdomain automatically." +
     PUBLIC_NAMESPACE_TAIL + NAMESPACE_FORMAT;
 const SITE_NAMESPACE_DESCRIPTION = PUBLIC_NAMESPACE_LEAD + "A site always gets its own subdomain." +
     PUBLIC_NAMESPACE_TAIL + NAMESPACE_FORMAT;
@@ -123,9 +130,9 @@ const DELIVERY_MODE_SCHEMA = z.enum(["path", "subdomain"]).optional().describe("
     "Everything else in any namespace (Markdown, code/text, files, JSON, KV, public HTML) defaults to path (Promotion); public HTML may automatically choose subdomain for browser features. " +
     "When creation returns an existing publication, it keeps its actual mode and URL.");
 /** Site upload rules shared by publish_site and republish_site; current values come from get_limits. */
-const SITE_LIMITS_TEXT = "Default limits (current values: GET /api/limits): a request is at most 25 MiB; a site at most 200 files, 5 MiB per file and 20 MiB in total; " +
-    "each path at most 380 characters. System files (.DS_Store, __MACOSX/ and similar) are skipped and never count; files with an unsupported extension " +
-    "or a too-long path are skipped and listed in notices. Entry: `entry`, else root index.html, else the shallowest HTML file. " +
+const SITE_LIMITS_TEXT = "Default limits (current: GET /api/limits): request 25 MiB; site 200 files, 5 MiB per file, 20 MiB total; " +
+    "path 380 characters. System files (.DS_Store, __MACOSX/ and similar) are skipped and never count; files with an unsupported extension " +
+    "or too-long path are skipped and listed in notices. Entry: `entry`, else root index.html, else the shallowest HTML file. " +
     "Errors: 400 = a site limit exceeded (the message names it), invalid path, no HTML file, or a PDF/Office file unreadable " +
     "or password-protected; 413 = request over 25 MiB, too many files and form fields, or a file name/path too long; " +
     "422 = no servable file left; 503 = busy, retry after Retry-After seconds.";
@@ -216,7 +223,7 @@ export function createServer(options = {}) {
     const apiFetch = options.fetch ?? fetch;
     const server = new McpServer({
         name: "brewpage-mcp",
-        version: "1.16.5",
+        version: "1.16.7",
     });
     /** Caller argument first, then the configured default; `fromEnv` marks the configured one. */
     function ownerTokenFor(argument) {
@@ -291,9 +298,10 @@ export function createServer(options = {}) {
     }
     server.registerTool("publish_html", {
         ...toolMeta("Publish HTML, Markdown, code or JSON page", ADDITIVE),
-        description: "Publish HTML, Markdown, code or JSON content to BrewPage (max 5 MiB); format omitted -> the server detects it. Returns its primary share link and owner token. Supports password protection, custom TTL, optional filename, and an opt-in top toolbar (showTopBar). " +
-            "When deliveryMode is omitted for a `public` page, the server may publish it on its own subdomain if the page needs browser features a BrewPage link does not provide; " +
-            "the result then includes deliveryModeReason and a delivery notice. Markdown raw HTML is allowlisted: scripts, styles, event handlers, forms and embeds are removed. " +
+        description: "Publish HTML, Markdown, code or JSON to BrewPage (max 5 MiB). " + PUBLIC_HINT +
+            "Format omitted -> server detects it. Returns its primary share link and owner token. Optional password, TTL, filename, top toolbar (showTopBar). " +
+            "A `public` page without deliveryMode may get its own subdomain if it needs browser features a BrewPage link lacks; " +
+            "the result then has deliveryModeReason and a delivery notice. Markdown raw HTML is allowlisted: scripts, styles, event handlers, forms, embeds removed. " +
             MANAGE_URL_TEXT + " " + SECRETS,
         inputSchema: {
             content: z.string().describe("HTML, Markdown, code or JSON to publish"),
@@ -362,7 +370,7 @@ export function createServer(options = {}) {
     });
     server.registerTool("publish_file", {
         ...toolMeta("Publish file from URL", ADDITIVE),
-        description: "Upload a file to BrewPage via URL. Max 5 MiB, video 20 MiB. Returns its primary share link and owner token. Does not expose password or TTL inputs. " +
+        description: "Upload a file from a URL. " + PUBLIC_HINT + "Max 5 MiB, video 20 MiB; no password or TTL. Returns its primary share link and owner token. " +
             MANAGE_URL_TEXT + " " + SECRETS,
         inputSchema: {
             url: z.string().url().describe("URL of the file to upload"),
@@ -545,8 +553,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. " +
-            "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 +
+        description: "Publish an HTML site to BrewPage. " + PUBLIC_HINT + "Single-page: `entryContent`. Multi-page: `files` (`{path, content}` array). Optional `entry` overrides `index.html`. Returns its primary share link and owner token. " +
+            "Static only: HTML, CSS, JS (incl. built React/Vue bundles) run in the browser; server code (PHP etc.) never runs. " + 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.5",
+  "version": "1.16.7",
   "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",