brewpage-mcp 1.23.0 → 1.23.1

package/README.md

@@ -38,7 +38,7 @@ Claude Code: `claude mcp add --transport http brewpage --scope user https://brew
 For clients that only start local servers; the same tools as the server URL.
 
 ```bash
-npx -y brewpage-mcp@1.23.0
+npx -y brewpage-mcp@1.23.1
 ```
 
 Requires Node.js 20 or newer. This starts the stdio server for an MCP client.
@@ -63,7 +63,7 @@ Local fallback (stdio, needs Node.js; the same tools): add to `~/Library/Applica
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.23.0"]
+      "args": ["-y", "brewpage-mcp@1.23.1"]
     }
   }
 }
@@ -86,7 +86,7 @@ Custom servers follow your ChatGPT plan and workspace settings.
 The remote command above is the default. Local fallback: register a project-scoped stdio server:
 
 ```bash
-claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.23.0
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.23.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).
@@ -110,7 +110,7 @@ Local fallback (stdio, needs Node.js; the same tools): open **Settings > MCP** a
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.23.0"]
+      "args": ["-y", "brewpage-mcp@1.23.1"]
     }
   }
 }
@@ -124,7 +124,7 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.23.0"]
+    "args": ["-y", "brewpage-mcp@1.23.1"]
   }
 }
 ```
@@ -769,6 +769,10 @@ Every publish response includes an **owner token** -- the only credential that a
 
 ## Changelog
 
+## 1.23.1 -- 2026-11-15
+
+- Page data guide (`get_guide` topic `page-data`) regenerated from BrewPage's Browser SDK text: the totals example uses `onStats`, which shows the totals now and again right after the page's own saves (`stats()` can lag a save by up to 30 s). Thirty-two tools. Contract 2.36.0. `User-Agent: brewpage-mcp/1.23.1`.
+
 ## 1.23.0 -- 2026-11-14
 
 - Page data guide (`get_guide` topic `page-data`) regenerated from BrewPage's new Browser SDK text: build, try locally, publish. It adds the local preview (a page opened from disk or localhost keeps entries in that browser and sends nothing: `s.local`, `?bp-local=owner`, `?bp-local=off`; the same file works unchanged once published with `state`) and the owner view (`s.role`, `s.onRole`, `list({all: true})`, `removeById`, error `not_owner`). Custom domains: 400 `DOMAIN_NOT_REGISTERED` and the notice `domain-not-registered` name the next step (buy the domain from a registrar first, or check its spelling); the `NOT_ELIGIBLE` reasons `EXPIRED` and `MODE` name the server's next step; the `DOMAIN_TAKEN` and `CHECK_PAUSED` problem texts follow the site. `ttlDays` states the contract. Thirty-two tools. Contract 2.36.0. `User-Agent: brewpage-mcp/1.23.0`.

package/dist/guides/page-data.js

@@ -14,7 +14,7 @@ export const PAGE_DATA_GUIDE = [
     "    const v = s.col(\"votes\");",
     "    await v.set(\"me\", {choice: \"a\"}); // key A-Za-z0-9_.-, no leading _, <=128; \"me\" = one per visitor",
     "    await v.get(\"me\"); // value or null; remove(key) -> true if it existed",
-    "    await v.stats({countBy: \"choice\"}); // {count, by: {a, b, other}}",
+    "    v.onStats({countBy: \"choice\"}, show); // show({count, by}) now + after own saves; stats() lags <=30 s",
     "  }",
     "  start();",
     "  bp.storage.ready.then(() => bp.storage.setItem(\"k\", \"v\")); // localStorage-like, synced; works where s is null",
@@ -33,7 +33,7 @@ export const PAGE_DATA_GUIDE = [
     "5) Publish: POST https://brewpage.app/api/html, Content-Type: application/json, body {\"content\":\"<html>...\",\"state\":{...}}; sites: multipart field \"state\".",
     "  Raw HTML body cannot carry state (or PATCH /api/{ns}/{id}/state later). Own address https://<label>.brewpage.app (or custom domain).",
     "  Give the user the page link (`link`) and the management link (`manageUrl`, private; Data tab shows entries).",
-    "  On the published link: one save works and shows in the Data tab; each list behaves as declared.",
+    "  On the published link: one save shows in the Data tab; lists behave as declared.",
     "6) Errors: e.code: rate_limited (e.retryAfter), quota, too_large, value_refused, mode_forbidden, not_owner, challenge_cancelled,",
     "  challenge_failed, challenge_unavailable, not_found, invalid_argument, network, unavailable, error.",
     "  Own CSP: allow https://challenges.cloudflare.com (script-src, frame-src).",

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.23.0";
+export declare const USER_AGENT = "brewpage-mcp/1.23.1";
 export declare const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
 /** Server instructions of the handshake: one paragraph per line; the first stands alone within 512 chars. */
 export declare const SERVER_INSTRUCTIONS: string;

package/dist/tools.js

@@ -3,7 +3,7 @@ import { z } from "zod";
 import { DOMAIN_PROBLEMS, DOMAIN_STATUSES } from "./guides/custom-domain.js";
 import { PAGE_DATA_CALLS, PAGE_DATA_GUIDE } from "./guides/page-data.js";
 export const DEFAULT_BASE_URL = "https://brewpage.app";
-export const USER_AGENT = "brewpage-mcp/1.23.0";
+export const USER_AGENT = "brewpage-mcp/1.23.1";
 export const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
 /** Server instructions of the handshake: one paragraph per line; the first stands alone within 512 chars. */
 export const SERVER_INSTRUCTIONS = [
@@ -599,7 +599,7 @@ export function createServer(options = {}) {
     const apiFetch = options.fetch ?? fetch;
     const server = new McpServer({
         name: "brewpage-mcp",
-        version: "1.23.0",
+        version: "1.23.1",
     }, { instructions: SERVER_INSTRUCTIONS });
     /** Caller argument first, then the configured default; `fromEnv` marks the configured one. */
     function ownerTokenFor(argument) {

package/package.json

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