brewpage-mcp 1.15.0 → 1.15.2

package/README.md

@@ -17,11 +17,28 @@ Choosing a host? See how BrewPage compares with GitHub Pages, Netlify Drop, Tiin
 ## Quick Start
 
 ```bash
-npx -y brewpage-mcp@1.15.0
+npx -y brewpage-mcp@1.15.2
 ```
 
 Requires Node.js 20 or newer. This starts the stdio server for an MCP client.
 
+### Remote (no install)
+
+Add `https://brewpage.app/mcp` as a custom connector / remote MCP server by URL in Claude.ai, ChatGPT or any Streamable HTTP client. No auth; same 20 tools.
+
+Claude Code: `claude mcp add --transport http brewpage https://brewpage.app/mcp`, or in `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "brewpage": {
+      "type": "http",
+      "url": "https://brewpage.app/mcp"
+    }
+  }
+}
+```
+
 ## Installation
 
 ### Claude Desktop
@@ -33,7 +50,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.15.0"]
+      "args": ["-y", "brewpage-mcp@1.15.2"]
     }
   }
 }
@@ -44,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.0
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.15.2
 ```
 
 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 +75,7 @@ Open **Settings > MCP** and add:
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.15.0"]
+      "args": ["-y", "brewpage-mcp@1.15.2"]
     }
   }
 }
@@ -72,7 +89,7 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.15.0"]
+    "args": ["-y", "brewpage-mcp@1.15.2"]
   }
 }
 ```
@@ -80,7 +97,7 @@ Open the Cline MCP settings panel and add:
 ### Global Install
 
 ```bash
-npm install -g brewpage-mcp@1.15.0
+npm install -g brewpage-mcp@1.15.2
 brewpage-mcp
 ```
 
@@ -213,9 +230,9 @@ publish_file(url="https://example.com/diagram.png")
 
 ### `publish_site`
 
-Publish a single-page or multi-file HTML site. Pass `entryContent` for a single page or `files` (array of `{path, content}`) for a multi-file site. Supports password protection, TTL, and owner token grouping.
+Publish a single-page or multi-file HTML site. Pass `entryContent` for a single page or `files` (array of `{path, content}`) for a multi-file site. Supports password protection, TTL, and owner token grouping. The result prints `Title:` (entry page title) after `ID:` when the server derives one.
 
-Limits (current values from `get_limits`): a request is at most 25 MB; a site at most 200 files, 5 MB per file and 20 MB in total; each path at most 380 characters. System files such as `.DS_Store` and `__MACOSX/` are skipped and never count; files with an unsupported extension or a too-long path are skipped and reported in notices. Entry: `entry`, else root `index.html`, else the shallowest HTML file. A site limit hit answers 400 with a message naming the limit, as does a PDF/Office file that is unreadable, password-protected or too complex; 413 means the request is over 25 MB, has too many files and form fields, or a file name/path is too long; 422 means no servable file is left; 503 means busy: retry after `Retry-After` seconds (failed publish tools print it).
+Limits (current values from `get_limits`): a request is at most 25 MB; a site at most 200 files, 5 MB per file and 20 MB in total; each path at most 380 characters. System files such as `.DS_Store` and `__MACOSX/` are skipped and never count; files with an unsupported extension or a too-long path are skipped and reported in notices. Entry: `entry`, else root `index.html`, else the shallowest HTML file. A site limit hit answers 400 with a message naming the limit, as does a PDF/Office file that is unreadable or password-protected; 413 means the request is over 25 MB, has too many files and form fields, or a file name/path is too long; 422 means no servable file is left; 503 means busy: retry after `Retry-After` seconds (failed publish tools print it).
 
 Parameters: exactly one of `entryContent` (string) or non-empty `files` (array of `{path, content}`), `entry` (optional entry file path, default `index.html`), `namespace` (optional -- omit for private, unlisted content; `public` lists the site in the gallery and sitemap for Google, Bing and AI search; a site always gets its own subdomain), `password` (optional), `ttlDays` (days or a string such as `2w`; default 15; the server clamps to 1--30), `ownerToken` (optional, groups site under an existing owner), `deliveryMode` (optional; fresh sites require `subdomain`).
 
@@ -513,6 +530,14 @@ Every publish response includes an **owner token** -- the only credential that a
 
 ## Changelog
 
+## 1.15.2 -- 2026-10-29
+
+- `publish_site` and `republish_site` print the site's entry page title (`Title:`) when the server reports one.
+
+## 1.15.1 -- 2026-10-27
+
+- Tool texts match contract 2.8.5 PDF/Office errors: a 400 means the file is unreadable or password-protected.
+
 ## 1.15.0 -- 2026-10-27
 
 - Supports MCP protocol 2026-07-28 (SDK v2).

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.0";
+export declare const USER_AGENT = "brewpage-mcp/1.15.2";
 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.0";
+export const USER_AGENT = "brewpage-mcp/1.15.2";
 export const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
 const READ_ONLY = { readOnlyHint: true };
 const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true };
@@ -111,8 +111,8 @@ const DELIVERY_MODE_SCHEMA = z.enum(["path", "subdomain"]).optional().describe("
 const SITE_LIMITS_TEXT = "Default limits (current values: GET /api/limits): a request is at most 25 MB; a site at most 200 files, 5 MB per file and 20 MB 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. " +
-    "Errors: 400 = a site limit exceeded (the message names it), invalid path, no HTML file, or a PDF/Office file unreadable, " +
-    "password-protected or too complex; 413 = request over 25 MB, too many files and form fields, or a file name/path too long; " +
+    "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 MB, 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.";
 function hostingResponseLines(data) {
     const fields = ["routingCohort", "deliveryMode", "requestedDeliveryMode", "effectiveDeliveryMode",
@@ -188,7 +188,7 @@ export function createServer(options = {}) {
     const apiFetch = options.fetch ?? fetch;
     const server = new McpServer({
         name: "brewpage-mcp",
-        version: "1.15.0",
+        version: "1.15.2",
     });
     /** Caller argument first, then the configured default; `fromEnv` marks the configured one. */
     function ownerTokenFor(argument) {
@@ -236,6 +236,10 @@ 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. */
+    function titleLines(data) {
+        return typeof data.title === "string" && data.title ? [`Title: ${data.title}`] : [];
+    }
     function formatPublishResponse(data, effectiveNamespace, sentOwnerToken, listable = true) {
         const lines = [
             `Published successfully!`,
@@ -596,6 +600,7 @@ export function createServer(options = {}) {
             `URL: ${site.link || "N/A"}`,
             `Namespace: ${site.namespace || "N/A"}`,
             `ID: ${site.id || "N/A"}`,
+            ...titleLines(site),
             `Entry file: ${site.entryFile || "index.html"}`,
             `Files: ${site.fileCount || 1}`,
         ];
@@ -687,6 +692,7 @@ export function createServer(options = {}) {
             `URL: ${site.link || "N/A"}`,
             `Namespace: ${site.namespace || namespace}`,
             `ID: ${site.id || id}`,
+            ...titleLines(site),
             `Entry file: ${site.entryFile || "index.html"}`,
             `Files: ${site.fileCount || 1}`,
         ];

package/package.json

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