brewpage-mcp 1.15.4 → 1.15.5

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.15.4
+npx -y brewpage-mcp@1.15.5
 ```
 
 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.15.4"]
+      "args": ["-y", "brewpage-mcp@1.15.5"]
     }
   }
 }
@@ -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.15.4
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.15.5
 ```
 
 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.15.4"]
+      "args": ["-y", "brewpage-mcp@1.15.5"]
     }
   }
 }
@@ -89,7 +89,7 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.15.4"]
+    "args": ["-y", "brewpage-mcp@1.15.5"]
   }
 }
 ```
@@ -97,7 +97,7 @@ Open the Cline MCP settings panel and add:
 ### Global Install
 
 ```bash
-npm install -g brewpage-mcp@1.15.4
+npm install -g brewpage-mcp@1.15.5
 brewpage-mcp
 ```
 
@@ -442,7 +442,7 @@ get_stats()
 
 ### `get_limits`
 
-Read the current upload limits from `GET /api/limits` (no auth; with `BREWPAGE_OWNER_TOKEN` also `reach` and `ownerMaxTtlDays`). Sizes are bytes: `requestMaxBytes` plus `sites.maxFiles`, `maxFileBytes`, `maxTotalBytes` (uncompressed), `maxArchiveExpansionBytes`, `maxPathChars`, `maxPathBytes`, `maxNameBytes`, `defaultTtlDays`, `maxTtlDays`, `allowedExtensions`, `skippedFileNames` and `skippedRootFolders`. Call it before publishing a large or multi-file site.
+Read the current limits from `GET /api/limits` (no auth; with `BREWPAGE_OWNER_TOKEN` also `reach` and `ownerMaxTtlDays`). Sizes are bytes, TTLs days: `requestMaxBytes`; `html`, `json`, `kv` and `files` max size, counts and TTL default/maximum; `profileMaxTtlDays` (TTL cap for a token in a profile); `sites.maxFiles`, `maxFileBytes`, `maxTotalBytes` (uncompressed), `maxArchiveExpansionBytes`, `maxPathChars`, `maxPathBytes`, `maxNameBytes`, `defaultTtlDays`, `maxTtlDays`, `allowedExtensions`, `skippedFileNames` and `skippedRootFolders`. Call it before publishing a large or multi-file site.
 
 Parameters: none.
 
@@ -469,7 +469,7 @@ get_limits()
 | "Remove the page I published" | `delete_resource` | Requires `ownerToken` from creation |
 | "Read back the page I published" | `get_page` | Returns raw content for editing |
 | "How many pages are on BrewPage?" | `get_stats` | Returns platform totals |
-| "How big can my site be?" | `get_limits` | Current request and site limits in bytes |
+| "How big can my site be?" | `get_limits` | Current request and per-type limits (bytes, TTL days) |
 | "Store JSON state between turns" | `publish_json` | Returns short URL + owner token |
 | "Read that JSON document back" | `get_json` | By `namespace` + `id` |
 | "Update the JSON I stored" | `update_json` | Requires `ownerToken`; preserves URL |
@@ -530,6 +530,10 @@ Every publish response includes an **owner token** -- the only credential that a
 
 ## Changelog
 
+## 1.15.5 -- 2026-10-29
+
+- `publish_html` prints the page title (`Title:`) when the server reports one; tool texts state plain size limits; `get_limits` names the per-type limits and the profile TTL cap.
+
 ## 1.15.4 -- 2026-10-29
 
 - `publish_html` and `update_html` texts name HTML, Markdown, code or JSON; `format` omitted -> server detects it.

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.15.4";
+export declare const USER_AGENT = "brewpage-mcp/1.15.5";
 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.15.4";
+export const USER_AGENT = "brewpage-mcp/1.15.5";
 export const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
 const READ_ONLY = { readOnlyHint: true };
 const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true };
@@ -188,7 +188,7 @@ export function createServer(options = {}) {
     const apiFetch = options.fetch ?? fetch;
     const server = new McpServer({
         name: "brewpage-mcp",
-        version: "1.15.4",
+        version: "1.15.5",
     });
     /** Caller argument first, then the configured default; `fromEnv` marks the configured one. */
     function ownerTokenFor(argument) {
@@ -236,7 +236,7 @@ export function createServer(options = {}) {
         const data = responseType === "text" ? await res.text() : await res.json().catch(() => null);
         return { ok: res.ok, status: res.status, data, headers: res.headers };
     }
-    /** `Title:` line when the server derived an entry page title; nothing otherwise. */
+    /** `Title:` line when the server returned a page or site entry title; nothing otherwise. */
     function titleLines(data) {
         return typeof data.title === "string" && data.title ? [`Title: ${data.title}`] : [];
     }
@@ -248,7 +248,7 @@ export function createServer(options = {}) {
         ];
         if (data.shortUrl)
             lines.push(`Short URL: ${data.shortUrl}`);
-        lines.push(`Namespace: ${data.namespace || "N/A"}`, `ID: ${data.id || "N/A"}`);
+        lines.push(`Namespace: ${data.namespace || "N/A"}`, `ID: ${data.id || "N/A"}`, ...titleLines(data));
         if (data.expiresAt)
             lines.push(`Expires: ${data.expiresAt}`);
         lines.push(...hostingResponseLines(data));
@@ -262,7 +262,7 @@ 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 (repository default limit 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). " +
+        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. " +
             MANAGE_URL_TEXT + " " + SECRETS,
@@ -333,7 +333,7 @@ export function createServer(options = {}) {
     });
     server.registerTool("publish_file", {
         ...toolMeta("Publish file from URL", ADDITIVE),
-        description: "Upload a file to BrewPage via URL. Repository defaults: 5 MiB for files/audio, 20 MiB for video. Returns its primary share link and owner token. Does not expose password or TTL inputs. " +
+        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. " +
             MANAGE_URL_TEXT + " " + SECRETS,
         inputSchema: {
             url: z.string().url().describe("URL of the file to upload"),
@@ -751,7 +751,7 @@ export function createServer(options = {}) {
     });
     server.registerTool("publish_json", {
         ...toolMeta("Publish JSON document", ADDITIVE),
-        description: "Publish a JSON document to BrewPage (repository default limit 1 MiB). Accepts a JSON object, array, or a JSON-encoded string containing any valid JSON, including scalars/null. Returns its primary share link and owner token. " +
+        description: "Publish a JSON document to BrewPage (max 1 MiB). Accepts a JSON object, array, or a JSON-encoded string containing any valid JSON, including scalars/null. Returns its primary share link and owner token. " +
             MANAGE_URL_TEXT + " " + SECRETS,
         inputSchema: {
             deliveryMode: DELIVERY_MODE_SCHEMA,
@@ -887,7 +887,7 @@ export function createServer(options = {}) {
     });
     server.registerTool("publish_kv", {
         ...toolMeta("Publish KV entry", ADDITIVE),
-        description: "Publish a key/value entry to BrewPage. Creates a KV store; the entry is addressed by (namespace, id, key). Repository defaults: 1 MiB per value, 1,000 keys per store; the key name `hosting` is reserved. Returns its primary share link and owner token. " +
+        description: "Publish a key/value entry to BrewPage. Creates a KV store; the entry is addressed by (namespace, id, key). Max 1 MiB per value, 1,000 keys per store; the key name `hosting` is reserved. Returns its primary share link and owner token. " +
             MANAGE_URL_TEXT + " " + SECRETS,
         inputSchema: {
             deliveryMode: DELIVERY_MODE_SCHEMA,
@@ -1011,8 +1011,9 @@ export function createServer(options = {}) {
     });
     server.registerTool("get_limits", {
         ...toolMeta("Get upload limits", READ_ONLY),
-        description: "Get the current BrewPage upload limits (GET /api/limits): request size, site file count, per-file and total size, " +
-            "ZIP expansion, path and name lengths, TTL default/maximum, allowed file extensions and skipped system files. Sizes are bytes. " +
+        description: "Get the current BrewPage limits (GET /api/limits): request size; per type (html, json, kv, files, sites) max size, " +
+            "counts and TTL default/maximum; profileMaxTtlDays (TTL cap for a token in a profile); site ZIP expansion, path and name lengths, " +
+            "allowed file extensions and skipped system files. Sizes are bytes, TTLs days. " +
             `With ${OWNER_TOKEN_ENV} set: also reach (token|profile) and ownerMaxTtlDays.`,
         inputSchema: {},
     }, async () => {
@@ -1033,7 +1034,7 @@ export function createServer(options = {}) {
             content: [
                 {
                     type: "text",
-                    text: `BrewPage upload limits (bytes):\n\n${JSON.stringify(data, null, 2)}`,
+                    text: `BrewPage limits (sizes in bytes, TTLs in days):\n\n${JSON.stringify(data, null, 2)}`,
                 },
             ],
         };

package/package.json

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