brewpage-mcp 1.19.0 → 1.19.1

package/README.md

@@ -16,17 +16,11 @@ Choosing a host? See how BrewPage compares with GitHub Pages, Netlify Drop, Tiin
 
 ## Quick Start
 
-```bash
-npx -y brewpage-mcp@1.19.0
-```
-
-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 30 tools.
+One remote MCP server for every client: `https://brewpage.app/mcp` (Streamable HTTP, no authentication, same 30 tools). Add it by URL in Claude (a custom connector), ChatGPT (a custom MCP server) or any Streamable HTTP client.
 
-Claude Code: `claude mcp add --transport http brewpage https://brewpage.app/mcp`, or in `.mcp.json`:
+Claude Code: `claude mcp add --transport http brewpage --scope user https://brewpage.app/mcp` (leave out `--scope user` to add it to the current project only), or in `.mcp.json`:
 
 ```json
 {
@@ -39,43 +33,84 @@ Claude Code: `claude mcp add --transport http brewpage https://brewpage.app/mcp`
 }
 ```
 
+### Local (npx)
+
+For clients that only start local servers; the same tools as the server URL.
+
+```bash
+npx -y brewpage-mcp@1.19.1
+```
+
+Requires Node.js 20 or newer. This starts the stdio server for an MCP client.
+
 ## Installation
 
-### Claude Desktop
+### Claude.ai and Claude Desktop
+
+Claude calls a remote MCP server a custom connector. Add it once in Claude on the web; Claude Desktop picks it up too. Nothing to install.
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+1. Open **Customize** > **Connectors**.
+2. Click **+ Add**, then **Add custom connector**.
+3. Name it **BrewPage**, paste `https://brewpage.app/mcp` and click **Continue**.
+4. Click **Continue** again, choose **No sign in** under Authentication and click **Add**.
+
+The free plan includes one custom connector.
+
+Local fallback (stdio, needs Node.js; the same tools): add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
 ```json
 {
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.19.0"]
+      "args": ["-y", "brewpage-mcp@1.19.1"]
     }
   }
 }
 ```
 
+### ChatGPT
+
+Add BrewPage as a custom MCP server; ChatGPT then publishes for you. Nothing to install.
+
+1. Open **Plugins** in ChatGPT.
+2. Click **+**, then **Add custom MCP server**.
+3. Name it **BrewPage** and paste `https://brewpage.app/mcp` as the server URL.
+4. Choose no authentication, select **I understand and want to continue**, then **Create as a plugin**.
+5. Install the new plugin, then ask ChatGPT to publish.
+
+Custom servers follow your ChatGPT plan and workspace settings.
+
 ### Claude Code
 
-Register a project-scoped stdio server:
+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.19.0
+claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.19.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).
 
 ### Cursor
 
-Open **Settings > MCP** and add:
+One click: **Add to Cursor** on [brewpage.app/integrations](https://brewpage.app/integrations#cursor) opens the install dialog in Cursor with BrewPage filled in. Or add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "brewpage": { "url": "https://brewpage.app/mcp" }
+  }
+}
+```
+
+Local fallback (stdio, needs Node.js; the same tools): open **Settings > MCP** and add:
 
 ```json
 {
   "mcpServers": {
     "brewpage": {
       "command": "npx",
-      "args": ["-y", "brewpage-mcp@1.19.0"]
+      "args": ["-y", "brewpage-mcp@1.19.1"]
     }
   }
 }
@@ -89,18 +124,11 @@ Open the Cline MCP settings panel and add:
 {
   "brewpage": {
     "command": "npx",
-    "args": ["-y", "brewpage-mcp@1.19.0"]
+    "args": ["-y", "brewpage-mcp@1.19.1"]
   }
 }
 ```
 
-### Global Install
-
-```bash
-npm install -g brewpage-mcp@1.19.0
-brewpage-mcp
-```
-
 ## Tools
 
 Thirty tools are available. Creation returns an owner token; keep it to modify or delete the resource later. Owner tools take `ownerToken`, else `BREWPAGE_OWNER_TOKEN` (local server only). Supported password inputs use `X-Password`. Secrets allowed; likely ones are flagged in notices. For a secret: private namespace + password.
@@ -697,6 +725,10 @@ Every publish response includes an **owner token** -- the only credential that a
 
 ## Changelog
 
+## 1.19.1 -- 2026-11-12
+
+- README only: the remote server `https://brewpage.app/mcp` comes first, with setup steps for Claude and ChatGPT; the local `npx` server is the fallback; the global install section is removed. No tool or input change. Contract 2.22.0. `User-Agent: brewpage-mcp/1.19.1`.
+
 ## 1.19.0 -- 2026-11-11
 
 - Page data: a page can save what its visitors enter (form answers, guestbook, votes, scores, game progress). Five new tools: `get_guide` returns the short reference to read before writing such a page; `get_page_data` reads the settings or one list's entries; `set_page_data` writes author entries; `configure_page_data` changes who can read a list and its limits; `delete_page_data` removes entries. `publish_html` and `publish_site` take `state` on create, `update_html` and `republish_site` on update. The four page-data tools take the owner token, or the page's management link alone as `manageUrl`. The server sends short instructions when a client connects. Thirty tools. Contract 2.22.0. `User-Agent: brewpage-mcp/1.19.0`.

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.19.0";
+export declare const USER_AGENT = "brewpage-mcp/1.19.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

@@ -2,7 +2,7 @@ import { McpServer } from "@modelcontextprotocol/server";
 import { z } from "zod";
 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.19.0";
+export const USER_AGENT = "brewpage-mcp/1.19.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 = [
@@ -513,7 +513,7 @@ export function createServer(options = {}) {
     const apiFetch = options.fetch ?? fetch;
     const server = new McpServer({
         name: "brewpage-mcp",
-        version: "1.19.0",
+        version: "1.19.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.19.0",
+  "version": "1.19.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",