brewpage-mcp 1.16.9 → 1.16.10

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.9
+npx -y brewpage-mcp@1.16.10
 ```
 
 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.9"]
+      "args": ["-y", "brewpage-mcp@1.16.10"]
     }
   }
 }
@@ -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.9
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.16.10
 ```
 
 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.9"]
+      "args": ["-y", "brewpage-mcp@1.16.10"]
     }
   }
 }
@@ -89,7 +89,7 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.16.9"]
+    "args": ["-y", "brewpage-mcp@1.16.10"]
   }
 }
 ```
@@ -97,7 +97,7 @@ Open the Cline MCP settings panel and add:
 ### Global Install
 
 ```bash
-npm install -g brewpage-mcp@1.16.9
+npm install -g brewpage-mcp@1.16.10
 brewpage-mcp
 ```
 
@@ -108,9 +108,9 @@ Twenty tools are available. Creation returns an owner token; keep it to modify o
 | Tool | Purpose |
 |------|---------|
 | `publish_html` | Publish HTML, Markdown, code or JSON |
-| `update_html` | Replace page content; omitted format preserves stored format |
+| `update_html` | Replace page content; omitted format preserves stored format, except a whole HTML document makes a Markdown page an HTML page |
 | `get_page` | Fetch raw page content |
-| `publish_file` | Fetch a source URL and upload the file |
+| `publish_file` | Fetch a source URL and upload the file; HTML and Markdown become pages |
 | `publish_site` | Publish a single page or complete multi-file site bundle |
 | `republish_site` | Replace the complete site bundle at the same ID/link |
 | `publish_json` | Publish a JSON object, array, or JSON-encoded string |
@@ -176,7 +176,7 @@ publish_html(content="<h1>Report</h1>...", format="HTML", ttlDays=15)
 
 Update an existing HTML or Markdown page in place, preserving its short URL. Requires the original `ownerToken` returned at creation.
 
-Parameters: `namespace` (string), `id` (string), `content` (string, the new body), `ownerToken` (string), `format` (optional HTML/Markdown alias or supported code language such as `json`, `yaml`, or `typescript`; omitted preserves the stored format), `tags` (optional; replace the stored tags, `[]` clears, omitted keeps them).
+Parameters: `namespace` (string), `id` (string), `content` (string, the new body), `ownerToken` (string), `format` (optional HTML/Markdown alias or supported code language such as `json`, `yaml`, or `typescript`; omitted preserves the stored format, except that a whole HTML document makes a Markdown page an HTML page), `tags` (optional; replace the stored tags, `[]` clears, omitted keeps them).
 
 An update never changes the link or delivery mode; an advisory `deliveryModeReason` and `Delivery notice:` line are printed when the server returns them.
 
@@ -216,6 +216,8 @@ Upload a file to BrewPage by fetching it from a URL. Returns a public URL and ow
 
 Parameters: `url` (string, the source URL to fetch), `namespace` (optional -- omit to keep the file private: unlisted and not indexed, anyone with the link can open it; `public` lists the file in the gallery and sitemap for Google, Bing and AI search), `filename` (optional custom filename), `deliveryMode` (optional). This tool does not expose base64, password, or TTL inputs.
 
+An HTML or Markdown file becomes a page in any namespace and the returned link opens the page (notice `html-file-as-page` or `markdown-file-as-page`). A known file name extension decides, then the source's Content-Type, then the content; `.txt` and anything unclear stay files. An HTML file over the page limit or in no readable encoding stays a file shown as source (notice `html-file-as-source`). A file read in a guessed encoding is saved as UTF-8 (notice `charset-guessed`).
+
 Example prompt:
 
 > "Upload this PNG and give me a shareable link."
@@ -530,9 +532,13 @@ Every publish response includes an **owner token** -- the only credential that a
 
 ## Changelog
 
+## 1.16.10 -- 2026-11-05
+
+- `publish_html`, `publish_file` and `update_html` texts state the format order: `format`, known file name extension, then for files the source's Content-Type, then the content. `publish_file`: HTML and Markdown become pages in any namespace. `update_html`: a whole HTML document makes a Markdown page an HTML page. Contract 2.10.2. `User-Agent: brewpage-mcp/1.16.10`.
+
 ## 1.16.9 -- 2026-11-05
 
-- A publish result without an owner token (`result.extras.isOwner` false) prints a neutral line instead of naming another owner. Contract 2.9.6. `User-Agent: brewpage-mcp/1.16.9`.
+- A publish result without an owner token (`result.extras.isOwner` false) prints a neutral line instead of naming another owner. Contract 2.9.6. `User-Agent: brewpage-mcp/1.16.10`.
 
 ## 1.16.8 -- 2026-11-02
 

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.9";
+export declare const USER_AGENT = "brewpage-mcp/1.16.10";
 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.9";
+export const USER_AGENT = "brewpage-mcp/1.16.10";
 export const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
 const READ_ONLY = { readOnlyHint: true };
 const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true };
@@ -223,7 +223,7 @@ export function createServer(options = {}) {
     const apiFetch = options.fetch ?? fetch;
     const server = new McpServer({
         name: "brewpage-mcp",
-        version: "1.16.9",
+        version: "1.16.10",
     });
     /** Caller argument first, then the configured default; `fromEnv` marks the configured one. */
     function ownerTokenFor(argument) {
@@ -299,7 +299,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 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). " +
+            "Format order: `format`, then a known filename extension, else the 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,
@@ -310,7 +310,7 @@ export function createServer(options = {}) {
                 .string()
                 .min(1)
                 .optional()
-                .describe("Omit: server detects html, markdown, code or JSON. `html` keeps code/JSON as HTML; also markdown/md or a code language."),
+                .describe("Omit: a known filename extension decides, else the server detects html, markdown, code or JSON. `html` keeps code/JSON as HTML; also markdown/md or a code language. A whole HTML document sent as markdown becomes an HTML page."),
             namespace: z
                 .string()
                 .optional()
@@ -324,7 +324,7 @@ export function createServer(options = {}) {
                 .string()
                 .max(200)
                 .optional()
-                .describe("Optional original filename (≤200 chars). Used as title fallback when no <title>/<h1>; immutable on update."),
+                .describe("Optional original filename (≤200 chars). Without `format`, a known extension sets the format (.md stays Markdown, even a whole HTML document). Used as title fallback when no <title>/<h1>; immutable on update."),
             showTopBar: z
                 .boolean()
                 .optional()
@@ -371,6 +371,8 @@ export function createServer(options = {}) {
     server.registerTool("publish_file", {
         ...toolMeta("Publish file from URL", ADDITIVE),
         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. " +
+            "HTML and Markdown files become pages in any namespace and the link opens the page: a known file name extension decides, then the source's Content-Type, then the content; `.txt` and anything unclear stay files. " +
+            "An HTML file over the page limit or in no readable encoding stays a file shown as source (notice html-file-as-source). " +
             MANAGE_URL_TEXT + " " + SECRETS,
         inputSchema: {
             url: z.string().url().describe("URL of the file to upload"),
@@ -379,7 +381,7 @@ export function createServer(options = {}) {
                 .string()
                 .optional()
                 .describe(NAMESPACE_DESCRIPTION),
-            filename: z.string().optional().describe("Custom filename (optional)"),
+            filename: z.string().optional().describe("Custom filename (optional); replaces the URL's name, so its extension decides whether the file becomes a page"),
             ownerToken: z.string().optional().describe(CREATE_OWNER_TOKEN_DESCRIPTION),
         },
     }, async ({ url: fileUrl, namespace, filename, deliveryMode, ownerToken }) => {
@@ -756,6 +758,7 @@ export function createServer(options = {}) {
     server.registerTool("update_html", {
         ...toolMeta("Update page", DESTRUCTIVE),
         description: "Update an existing BrewPage HTML, Markdown, code or JSON page. Requires owner token. Returns the updated page metadata. " +
+            "Format omitted keeps the stored format, except a whole HTML document makes a Markdown page an HTML page. " +
             "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 + " " + NO_PUBLIC_CREDENTIALS,
         inputSchema: {
             namespace: z.string().describe("Page namespace"),
@@ -765,7 +768,7 @@ export function createServer(options = {}) {
             format: z
                 .string()
                 .optional()
-                .describe("Content format. Accepts (case-insensitive on html/markdown): 'html', 'markdown'/'md', or a code language — yaml, json, xml, csv, tsv, log, toml, ini, sql, sh, bat, env, javascript, typescript, tsx, jsx, css, properties, docker, txt. Omit to preserve the stored format."),
+                .describe("Content format. Accepts (case-insensitive on html/markdown): 'html', 'markdown'/'md', or a code language — yaml, json, xml, csv, tsv, log, toml, ini, sql, sh, bat, env, javascript, typescript, tsx, jsx, css, properties, docker, txt. Omit to preserve the stored format, except a whole HTML document makes a Markdown page an HTML page."),
             tags: z
                 .array(z.string())
                 .optional()

package/package.json

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