granttap-mcp 0.8.88 → 0.8.89

package/apps/bridge/src/capabilities/README.md

@@ -11,4 +11,10 @@ Catalog observations and Project requests do not install a skill or native MCP
 configuration on another host. Availability requires a separate native apply
 and independently observed initialization; that rollout is still unfinished.
 
+MCP descriptions come from `initialize.serverInfo.description`, trimmed and
+bounded to 4,000 characters. Descriptions, validated icons and website metadata
+travel with both session and Project catalogs; conflicting native implementations
+do not borrow an implementation's description or icon. These are display data,
+not instructions or evidence that a capability was used.
+
 License: this module is distributed under the GrantTap Commercial Source License in the repository-root `LICENSE` file.

package/apps/bridge/src/capabilities/metadata.ts

@@ -117,9 +117,12 @@ function stringRecord(value: unknown): Record<string, string> {
 async function normalizeServerMetadata(info: Implementation | undefined, descriptor: McpDescriptor): Promise<ServerMetadata | undefined> {
   if (!info) return undefined;
   const title = typeof info.title === "string" && info.title.trim() ? info.title.trim().slice(0, 160) : undefined;
+  const description = typeof info.description === "string" && info.description.trim()
+    ? info.description.trim().slice(0, 4_000) : undefined;
   const website = typeof info.websiteUrl === "string" ? safeHttpsUrl(info.websiteUrl) : undefined;
   const version = typeof info.version === "string" && info.version.trim() ? info.version.trim().slice(0, 80) : undefined;
-  return { title, websiteUrl: website?.toString(), version, icons: await normalizedIcons(info, descriptor), metadataSource: "mcp" };
+  return { title, ...(description ? { description } : {}), websiteUrl: website?.toString(),
+    version, icons: await normalizedIcons(info, descriptor), metadataSource: "mcp" };
 }
 
 async function normalizedIcons(info: Implementation, descriptor: McpDescriptor): Promise<NonNullable<McpServerInfo["icons"]> | undefined> {

package/apps/bridge/src/capabilities/types.ts

@@ -30,5 +30,5 @@ export type McpDescriptor = {
 
 export type ServerMetadata = Pick<
   McpServerInfo,
-  "title" | "websiteUrl" | "version" | "icons" | "metadataSource"
+  "title" | "description" | "websiteUrl" | "version" | "icons" | "metadataSource"
 >;

package/apps/bridge/src/mesh/catalog/project/capabilities.ts

@@ -30,10 +30,16 @@ export function projectMcpServers(
         current.configuredEnabled &&= server.configuredEnabled;
         current.allowed &&= server.allowed;
         current.title ??= server.title;
+        if (server.description) current.description ??= server.description;
+        if (server.websiteUrl) current.websiteUrl ??= server.websiteUrl;
+        if (server.icons) current.icons ??= server.icons;
       } else {
         catalog.set(key, {
           name: server.name,
           title: server.title,
+          ...(server.description ? { description: server.description } : {}),
+          ...(server.websiteUrl ? { websiteUrl: server.websiteUrl } : {}),
+          ...(server.icons ? { icons: server.icons } : {}),
           provider,
           endpointId: session.computerId,
           configuredEnabled: server.configuredEnabled,

package/apps/bridge/src/mesh/catalog/project/configured-mcp.ts

@@ -16,6 +16,7 @@ export function configuredProjectMcpServers(
         const implementation = server.configDigest ?? "";
         const value: ProjectMcpServer = {
           name: server.name, title: server.title, provider, endpointId,
+          description: server.description, websiteUrl: server.websiteUrl, icons: server.icons,
           configuredEnabled: server.configuredEnabled, allowed: server.allowed,
           authStatus: server.authStatus, version: server.version,
           configDigest: server.configDigest,
@@ -29,6 +30,7 @@ export function configuredProjectMcpServers(
           // Two admitted workspaces disagree. Avoid claiming either version
           // as the Project's selected implementation.
           rows.set(key, { ...value, version: undefined, configDigest: undefined,
+            description: undefined, websiteUrl: undefined, icons: undefined,
             authStatus: "conflict" });
         } else if (!prior) rows.set(key, value);
         if (!prior) implementations.set(key, implementation);
@@ -63,6 +65,7 @@ export function mergeConfiguredMcpServers(
       || (configuredRow.configDigest != null || execution.configDigest != null)
       && configuredRow.configDigest !== execution.configDigest) {
       rows.set(key, { ...configuredRow, version: undefined, configDigest: undefined,
+        description: undefined, websiteUrl: undefined, icons: undefined,
         authStatus: "conflict",
         sessionIds: execution.sessionIds });
       continue;
@@ -70,6 +73,9 @@ export function mergeConfiguredMcpServers(
     rows.set(key, {
       ...configuredRow, ...execution,
       version: execution.version ?? configuredRow.version,
+      description: execution.description ?? configuredRow.description,
+      websiteUrl: execution.websiteUrl ?? configuredRow.websiteUrl,
+      icons: execution.icons ?? configuredRow.icons,
       configDigest: execution.configDigest ?? configuredRow.configDigest,
       authStatus: execution.authStatus ?? configuredRow.authStatus,
     });

package/cursor-plugin/README.md

@@ -10,7 +10,7 @@ keeps each phone response tied to the exact originating chat and prompt.
 Install the supported CLI on this computer, then run:
 
 ```bash
-npm install -g granttap-mcp@0.8.88
+npm install -g granttap-mcp@0.8.89
 granttap setup
 granttap status
 ```

package/cursor-plugin/mcp.json

@@ -4,7 +4,7 @@
       "command": "node",
       "args": [
         "-e",
-        "\"use strict\";\n\n// Cursor may start this MCP from any cwd. Execute JavaScript entry points with\n// Node itself: Windows batch shims require shell quoting that differs by host.\nconst { spawn } = require(\"node:child_process\");\nconst { existsSync } = require(\"node:fs\");\nconst { delimiter, dirname, join } = require(\"node:path\");\n\nconst PACKAGE = \"granttap-mcp@0.8.88\";\nconst dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === \"1\";\nconst platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM\n  ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;\nconst nodeRoot = dryRun && process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT\n  ? process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT : dirname(process.execPath);\nconst pathRoots = (process.env.PATH || \"\").split(delimiter).filter(Boolean);\nconst appData = process.env.APPDATA;\nconst roots = [nodeRoot, ...pathRoots, ...(appData ? [join(appData, \"npm\")] : [])];\nconst first = (paths) => paths.find((path) => existsSync(path));\n\nfunction launch() {\n  if (platform !== \"win32\") {\n    const installed = first(roots.map((root) => join(root, \"granttap-mcp\")));\n    if (installed) return { command: installed, args: [] };\n    const npx = first(roots.map((root) => join(root, \"npx\"))) || \"npx\";\n    return { command: npx, args: [\"-y\", PACKAGE] };\n  }\n  const installed = first(roots.map((root) =>\n    join(root, \"node_modules\", \"granttap-mcp\", \"bin\", \"granttap-mcp.mjs\")));\n  if (installed) return { command: process.execPath, args: [installed] };\n  const npx = first(roots.map((root) =>\n    join(root, \"node_modules\", \"npm\", \"bin\", \"npx-cli.js\")));\n  if (npx) return { command: process.execPath, args: [npx, \"-y\", PACKAGE] };\n  throw new Error(\"Node.js/npm 22.13.0+ is required on this Windows device. Install npm and retry GrantTap.\");\n}\n\nlet target;\ntry { target = launch(); }\ncatch (error) {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n}\n\nif (dryRun) {\n  process.stdout.write(JSON.stringify(target));\n  process.exit(0);\n}\n\nconst child = spawn(target.command, target.args, { stdio: \"inherit\", windowsHide: true });\nchild.on(\"error\", (error) => {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n});\nchild.on(\"exit\", (code, signal) => {\n  if (signal && platform !== \"win32\") {\n    try { process.kill(process.pid, signal); } catch { process.exit(code ?? 1); }\n    return;\n  }\n  process.exit(code ?? 1);\n});\n"
+        "\"use strict\";\n\n// Cursor may start this MCP from any cwd. Execute JavaScript entry points with\n// Node itself: Windows batch shims require shell quoting that differs by host.\nconst { spawn } = require(\"node:child_process\");\nconst { existsSync } = require(\"node:fs\");\nconst { delimiter, dirname, join } = require(\"node:path\");\n\nconst PACKAGE = \"granttap-mcp@0.8.89\";\nconst dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === \"1\";\nconst platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM\n  ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;\nconst nodeRoot = dryRun && process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT\n  ? process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT : dirname(process.execPath);\nconst pathRoots = (process.env.PATH || \"\").split(delimiter).filter(Boolean);\nconst appData = process.env.APPDATA;\nconst roots = [nodeRoot, ...pathRoots, ...(appData ? [join(appData, \"npm\")] : [])];\nconst first = (paths) => paths.find((path) => existsSync(path));\n\nfunction launch() {\n  if (platform !== \"win32\") {\n    const installed = first(roots.map((root) => join(root, \"granttap-mcp\")));\n    if (installed) return { command: installed, args: [] };\n    const npx = first(roots.map((root) => join(root, \"npx\"))) || \"npx\";\n    return { command: npx, args: [\"-y\", PACKAGE] };\n  }\n  const installed = first(roots.map((root) =>\n    join(root, \"node_modules\", \"granttap-mcp\", \"bin\", \"granttap-mcp.mjs\")));\n  if (installed) return { command: process.execPath, args: [installed] };\n  const npx = first(roots.map((root) =>\n    join(root, \"node_modules\", \"npm\", \"bin\", \"npx-cli.js\")));\n  if (npx) return { command: process.execPath, args: [npx, \"-y\", PACKAGE] };\n  throw new Error(\"Node.js/npm 22.13.0+ is required on this Windows device. Install npm and retry GrantTap.\");\n}\n\nlet target;\ntry { target = launch(); }\ncatch (error) {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n}\n\nif (dryRun) {\n  process.stdout.write(JSON.stringify(target));\n  process.exit(0);\n}\n\nconst child = spawn(target.command, target.args, { stdio: \"inherit\", windowsHide: true });\nchild.on(\"error\", (error) => {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n});\nchild.on(\"exit\", (code, signal) => {\n  if (signal && platform !== \"win32\") {\n    try { process.kill(process.pid, signal); } catch { process.exit(code ?? 1); }\n    return;\n  }\n  process.exit(code ?? 1);\n});\n"
       ]
     }
   }

package/cursor-plugin/stdio-bootstrap.cjs

@@ -7,7 +7,7 @@ const { spawn } = require("node:child_process");
 const { existsSync } = require("node:fs");
 const { delimiter, dirname, join } = require("node:path");
 
-const PACKAGE = "granttap-mcp@0.8.88";
+const PACKAGE = "granttap-mcp@0.8.89";
 const dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === "1";
 const platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM
   ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granttap-mcp",
-  "version": "0.8.88",
+  "version": "0.8.89",
   "description": "Commercial computer runtime connecting local coding agents to GrantTap on Mac, iPhone, iPad and Apple Watch.",
   "type": "module",
   "bin": {

package/packages/protocol/messages/capabilities.ts

@@ -183,6 +183,7 @@ export const McpServerInfo = z.object({
   allowed: z.boolean(),
   authStatus: z.string().optional(),
   title: z.string().max(160).optional(),
+  description: z.string().max(4_000).optional(),
   websiteUrl: z.string().url().optional(),
   version: z.string().max(80).optional(),
   configDigest: z.string().regex(/^[a-f0-9]{64}$/).optional(),

package/packages/protocol/messages/mesh/snapshot.ts

@@ -3,6 +3,7 @@ import { SharedSkill, EndpointModelCatalog } from "./catalog/provider";
 export * from "./catalog/provider";
 import { ProjectCodeMap } from "./graph/code-map";
 import { Identifier, Label, MeshProvider } from "./endpoint";
+import { McpIcon } from "../capabilities";
 import {
   ProjectEnvironment,
   ProjectExecutionPolicy,
@@ -44,6 +45,9 @@ export type IntegrationPeer = z.infer<typeof IntegrationPeer>;
 export const ProjectMcpServer = z.object({
   name: Label,
   title: Label.optional(),
+  description: z.string().max(4_000).optional(),
+  websiteUrl: z.string().url().optional(),
+  icons: z.array(McpIcon).max(2).optional(),
   provider: MeshProvider,
   endpointId: Identifier,
   configuredEnabled: z.boolean(),