brewpage-mcp 1.15.3 → 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.3
+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.3"]
+      "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.3
+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.3"]
+      "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.3"]
+    "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.3
+npm install -g brewpage-mcp@1.15.5
 brewpage-mcp
 ```
 
@@ -107,7 +107,7 @@ Twenty tools are available. Creation returns an owner token; keep it to modify o
 
 | Tool | Purpose |
 |------|---------|
-| `publish_html` | Publish HTML or Markdown |
+| `publish_html` | Publish HTML, Markdown, code or JSON |
 | `update_html` | Replace page content; omitted format preserves stored format |
 | `get_page` | Fetch raw page content |
 | `publish_file` | Fetch a source URL and upload the file |
@@ -156,7 +156,7 @@ update_hosting(type="html", namespace="public", id="aBcDeFgHiJ", ownerToken="tok
 
 ### `publish_html`
 
-Publish HTML or Markdown content to BrewPage. Returns a public URL and owner token. Markdown raw HTML is rendered through an allowlist: scripts, styles, event handlers, forms, frames/embeds and `meta`/`base`/`link` are removed; links allow `http`, `https`, `mailto`, `tel` and relative URLs, images also `data:`; a lone unknown tag such as `<author>` shows as text.
+Publish HTML, Markdown, code or JSON content to BrewPage; with `format` omitted the server detects it. Returns a public URL and owner token. Markdown raw HTML is rendered through an allowlist: scripts, styles, event handlers, forms, frames/embeds and `meta`/`base`/`link` are removed; links allow `http`, `https`, `mailto`, `tel` and relative URLs, images also `data:`; a lone unknown tag such as `<author>` shows as text.
 
 Parameters: `content` (string), `format` (optional; omit to let the server detect HTML, Markdown, code or JSON; `html` keeps code/JSON as HTML; also `markdown`/`md` or a code language), `namespace` (optional -- **omit for private, unlisted content**; `public` lists the page in the gallery and sitemap for Google, Bing and AI search, served on the brewpage.app domain; never put secrets there), `password` (optional), `ttlDays` (days or a string such as `2w`; default 15; the server clamps to 1--30), `filename` (optional, used as title fallback), `showTopBar` (optional boolean -- adds a toolbar with filename, Download button, and theme toggle), `deliveryMode` (optional).
 
@@ -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,14 @@ 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.
+
 ## 1.15.3 -- 2026-10-29
 
 - `publish_html` sends `format` only when given, so the server detects code or JSON (contract 2.8.27); pass `html` to keep HTML.

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.3";
+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.3";
+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.3",
+        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));
@@ -261,8 +261,8 @@ export function createServer(options = {}) {
         return lines.join("\n");
     }
     server.registerTool("publish_html", {
-        ...toolMeta("Publish HTML or Markdown page", ADDITIVE),
-        description: "Publish HTML or Markdown content to BrewPage (repository default limit 5 MiB). Returns its primary share link and owner token. Supports password protection, custom TTL, optional filename, and an opt-in top toolbar (showTopBar). " +
+        ...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. " +
             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"),
@@ -715,12 +715,12 @@ export function createServer(options = {}) {
     });
     server.registerTool("update_html", {
         ...toolMeta("Update page", DESTRUCTIVE),
-        description: "Update an existing BrewPage HTML/Markdown page. Requires owner token. Returns the updated page metadata. " +
+        description: "Update an existing BrewPage HTML, Markdown, code or JSON 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." + OLD_READ_ONLY_TEXT,
         inputSchema: {
             namespace: z.string().describe("Page namespace"),
             id: z.string().describe("Page ID"),
-            content: z.string().describe("New HTML or Markdown content"),
+            content: z.string().describe("New HTML, Markdown, code or JSON content"),
             ownerToken: z.string().optional().describe(OWNER_TOKEN_DESCRIPTION),
             format: z
                 .string()
@@ -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.3",
+  "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",