mcp-scraper 0.45.0 → 0.47.0

package/dist/bin/mcp-scraper-cli.js

@@ -11,7 +11,7 @@ import "../chunk-G3P3ZDB4.js";
 import "../chunk-3ZUBQQPQ.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-CEZ3NFBP.js";
+} from "../chunk-H4NWAF5B.js";
 
 // src/cli/human-cli.ts
 import { Command } from "commander";

package/dist/bin/mcp-scraper-install.cjs

@@ -53,13 +53,14 @@ function renderInstallTerminal(options) {
     "1/1 install surfaces ready",
     colorize("Newest: any approved connection read can become an indexed Memory snapshot in one call. OAuth stays tenant-isolated and provider content is redacted and marked untrusted.", "lime", color),
     "",
-    `${colorize("Tools", "cyan", color)}  ${colorize("(215 MCP tools)", "muted", color)}`,
+    `${colorize("Tools", "cyan", color)}  ${colorize("(220 MCP tools)", "muted", color)}`,
     toolRow("search", ["harvest_paa", "search_serp", "maps_search", "maps_place_intel"], color),
     toolRow("extract", ["extract_url", "map_site_urls", "extract_site", "audit_site", "directory_workflow"], color),
     toolRow("build", ["create_editorial_reading_room", "rank_tracker_workflow", "portable HTML"], color),
     toolRow("media", ["youtube_harvest", "youtube_transcribe", "facebook_ad_search", "facebook_page_intel", "facebook_ad_transcribe", "facebook_video_transcribe", "instagram_profile_content", "instagram_media_download", "reddit_thread"], color),
     toolRow("browser", ["browser_open", "browser_profile_connect", "browser_profile_list", "browser_close", "browser_screenshot", "browser_read", "browser_locate", "browser_replay_mark", "browser_replay_annotate"], color),
     toolRow("connect", ["list_service_connections", "describe_service_connection_tool", "import_service_connection_to_memory", "export_connected_service_data", "renew_connected_data_download", "read_service_connection", "call_service_connection_action"], color),
+    toolRow("commons", ["commons_search_entities", "commons_prepare_entity", "commons_submit_entity", "commons_prepare_publication", "commons_claim_publication", "commons_publish_editorial", "commons_get_publication"], color),
     toolRow("account", ["credits_info", "reports", "MCP resources"], color),
     toolRow("memory", ["memory-put", "memory-get", "memory-search", "list-vaults", "record-fact", "list-scheduled-actions"], color),
     `${colorize("Workflows", "cyan", color)}  ${colorize("(MCP + CLI + API)", "muted", color)}`,
@@ -106,7 +107,7 @@ function renderInstallTerminal(options) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.45.0";
+var PACKAGE_VERSION = "0.47.0";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-scraper-install.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/install-terminal.ts","../../src/version.ts","../../bin/mcp-scraper-install.ts"],"sourcesContent":["export interface InstallTerminalOptions {\n  color?: boolean\n  version: string\n  apiKeyConfigured?: boolean\n}\n\ntype Tone = 'cyan' | 'lime' | 'amber' | 'red' | 'muted' | 'bold'\n\nconst CODES: Record<Tone | 'reset', string> = {\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  lime: '\\x1b[32m',\n  amber: '\\x1b[33m',\n  red: '\\x1b[31m',\n  muted: '\\x1b[90m',\n  bold: '\\x1b[1m',\n}\n\nfunction colorize(value: string, tone: Tone, enabled: boolean): string {\n  if (!enabled) return value\n  return `${CODES[tone]}${value}${CODES.reset}`\n}\n\nfunction toolRow(label: string, tools: string[], enabled: boolean): string {\n  const padded = label.padEnd(9, ' ')\n  return `  ${colorize(padded, 'muted', enabled)} ${tools.join(colorize('  .  ', 'muted', enabled))}`\n}\n\nexport function renderInstallTerminal(options: InstallTerminalOptions): string {\n  const color = options.color ?? true\n  const apiKeyValue = options.apiKeyConfigured ? '$MCP_SCRAPER_API_KEY' : 'sk_live_your_key'\n  const ascii = String.raw`\n __  __  ____ ____ \n|  \\/  |/ ___|  _ \\\n| |\\/| | |   | |_) |\n| |  | | |___|  __/\n|_|  |_|\\____|_|\n\n ____   ____ ____      _    ____  _____ ____\n/ ___| / ___|  _ \\    / \\  |  _ \\| ____|  _ \\\n\\___ \\| |   | |_) |  / _ \\ | |_) |  _| | |_) |\n ___) | |___|  _ <  / ___ \\|  __/| |___|  _ <\n|____/ \\____|_| \\_\\/_/   \\_\\_|   |_____|_| \\_\\\n`\n\n  const claudeCommand = [\n    `MCP_SCRAPER_API_KEY=${apiKeyValue} npx -y -p mcp-scraper@latest \\\\`,\n    '  mcp-scraper-cli agent install claude --apply',\n  ].join('\\n')\n\n  const codexConfig = [\n    '[mcp_servers.mcp-scraper]',\n    'command = \"npx\"',\n    'args = [\"-y\", \"-p\", \"mcp-scraper@latest\", \"mcp-scraper\"]',\n    `env = { MCP_SCRAPER_API_KEY = \"${apiKeyValue}\" }`,\n  ].join('\\n')\n\n  return [\n    colorize(`mcp-scraper v${options.version}`, 'bold', color),\n    colorize('> mcp-scraper-install', 'muted', color),\n    colorize(ascii, 'amber', color),\n    `${colorize('MCP Scraper Agent', 'cyan', color)}  .  v${options.version}  .  mcpscraper.dev`,\n    '1/1 install surfaces ready',\n    colorize('Newest: any approved connection read can become an indexed Memory snapshot in one call. OAuth stays tenant-isolated and provider content is redacted and marked untrusted.', 'lime', color),\n    '',\n    `${colorize('Tools', 'cyan', color)}  ${colorize('(215 MCP tools)', 'muted', color)}`,\n    toolRow('search', ['harvest_paa', 'search_serp', 'maps_search', 'maps_place_intel'], color),\n    toolRow('extract', ['extract_url', 'map_site_urls', 'extract_site', 'audit_site', 'directory_workflow'], color),\n    toolRow('build', ['create_editorial_reading_room', 'rank_tracker_workflow', 'portable HTML'], color),\n    toolRow('media', ['youtube_harvest', 'youtube_transcribe', 'facebook_ad_search', 'facebook_page_intel', 'facebook_ad_transcribe', 'facebook_video_transcribe', 'instagram_profile_content', 'instagram_media_download', 'reddit_thread'], color),\n    toolRow('browser', ['browser_open', 'browser_profile_connect', 'browser_profile_list', 'browser_close', 'browser_screenshot', 'browser_read', 'browser_locate', 'browser_replay_mark', 'browser_replay_annotate'], color),\n    toolRow('connect', ['list_service_connections', 'describe_service_connection_tool', 'import_service_connection_to_memory', 'export_connected_service_data', 'renew_connected_data_download', 'read_service_connection', 'call_service_connection_action'], color),\n    toolRow('account', ['credits_info', 'reports', 'MCP resources'], color),\n    toolRow('memory', ['memory-put', 'memory-get', 'memory-search', 'list-vaults', 'record-fact', 'list-scheduled-actions'], color),\n    `${colorize('Workflows', 'cyan', color)}  ${colorize('(MCP + CLI + API)', 'muted', color)}`,\n    toolRow('route', ['workflow_list', 'workflow_suggest', 'workflow_run', 'workflow_step', 'workflow_status', 'workflow_artifact_read'], color),\n    toolRow('seo', ['directory', 'agent-packet', 'competitive audit', 'map/serp comparison', 'PAA/AIO briefs', 'scheduled runs'], color),\n    '',\n    colorize('Usage tips:', 'amber', color),\n    'Run mcp-scraper-install for this visible card. Run mcp-scraper-cli for setup utilities and subcommands.',\n    'Run mcp-scraper in a human terminal to print this card; MCP clients get the same command as a silent stdio server.',\n    'Explicit card command: npx -y -p mcp-scraper@latest mcp-scraper-install',\n    'Hosted browser sessions use direct/no-proxy egress by default.',\n    'Customer auth setup: run browser_profile_connect, send the watch_url, let the user sign in, then call browser_profile_list until AUTHENTICATED.',\n    'Connected account ranges: call export_connected_service_data once. It handles Gmail, Calendar, Zoom, and Resend pagination; do not loop read_service_connection over individual records.',\n    'Connected account RAG: call import_service_connection_to_memory for one bounded approved read. It writes a redacted, untrusted snapshot to a stable Memory path and embeds it for search.',\n    'Stack logins / reconnect: run browser_profile_connect again with the same profile name and another domain to add accounts or refresh a login.',\n    'Start with workflow_suggest for broad jobs like market analysis, ICP research, CRO audits, brand briefs, content gaps, and AI visibility.',\n    'For MCP clients, use mcp-scraper so one install can mix SERP, Maps, browser, reports, and saved MCP resources.',\n    'If you hit the concurrency limit, add an extra slot for $5/month with mcp-scraper-cli billing concurrency checkout.',\n    '',\n    `${colorize('Ready.', 'lime', color)} Install the combined MCP server with one command:`,\n    '',\n    colorize('Setup doctor', 'amber', color),\n    'npx -y -p mcp-scraper@latest mcp-scraper-cli doctor',\n    '',\n    colorize('Hosted profile setup', 'amber', color),\n    'In your MCP client, call browser_profile_connect with email=\"seo@example.com\" and domain=\"chatgpt.com\".',\n    'Give the returned watch_url to the user. After they sign in, call browser_profile_list, then browser_open with the returned profile. Add more logins by calling browser_profile_connect again with the same profile and a new domain.',\n    '',\n    colorize('Claude Code one-command setup', 'amber', color),\n    claudeCommand,\n    'Then fully exit Claude Code and open a new Claude terminal. Check with: claude mcp list',\n    '',\n    colorize('Codex config', 'amber', color),\n    codexConfig,\n    '',\n    colorize('Claude Desktop Extension', 'amber', color),\n    'Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb',\n    '',\n    colorize('Safety note:', 'muted', color),\n    'mcp-scraper prints this card only when stdin/stdout are an interactive TTY. In MCP clients it writes only JSON-RPC to stdout.',\n    'Use --stdio or MCP_SCRAPER_FORCE_STDIO=1 to force server mode from a terminal.',\n    '',\n  ].join('\\n')\n}\n","export const PACKAGE_VERSION = '0.45.0'\n","#!/usr/bin/env node\nimport { renderInstallTerminal } from '../src/install-terminal.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst noColor =\n  process.argv.includes('--no-color') ||\n  process.env.NO_COLOR !== undefined ||\n  process.env.FORCE_COLOR === '0' ||\n  !process.stdout.isTTY\n\nconst help = process.argv.includes('--help') || process.argv.includes('-h')\nif (help) {\n  process.stdout.write([\n    'Usage: mcp-scraper-install [--no-color]',\n    '',\n    'Prints the branded MCP Scraper terminal install card and copyable install commands.',\n    'mcp-scraper prints the same card in a human terminal and runs as the MCP stdio server in clients.',\n    '',\n  ].join('\\n'))\n  process.exit(0)\n}\n\nprocess.stdout.write(renderInstallTerminal({\n  version: PACKAGE_VERSION,\n  color: !noColor,\n  apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim()),\n}))\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/install-terminal.ts","../../src/version.ts","../../bin/mcp-scraper-install.ts"],"sourcesContent":["export interface InstallTerminalOptions {\n  color?: boolean\n  version: string\n  apiKeyConfigured?: boolean\n}\n\ntype Tone = 'cyan' | 'lime' | 'amber' | 'red' | 'muted' | 'bold'\n\nconst CODES: Record<Tone | 'reset', string> = {\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  lime: '\\x1b[32m',\n  amber: '\\x1b[33m',\n  red: '\\x1b[31m',\n  muted: '\\x1b[90m',\n  bold: '\\x1b[1m',\n}\n\nfunction colorize(value: string, tone: Tone, enabled: boolean): string {\n  if (!enabled) return value\n  return `${CODES[tone]}${value}${CODES.reset}`\n}\n\nfunction toolRow(label: string, tools: string[], enabled: boolean): string {\n  const padded = label.padEnd(9, ' ')\n  return `  ${colorize(padded, 'muted', enabled)} ${tools.join(colorize('  .  ', 'muted', enabled))}`\n}\n\nexport function renderInstallTerminal(options: InstallTerminalOptions): string {\n  const color = options.color ?? true\n  const apiKeyValue = options.apiKeyConfigured ? '$MCP_SCRAPER_API_KEY' : 'sk_live_your_key'\n  const ascii = String.raw`\n __  __  ____ ____ \n|  \\/  |/ ___|  _ \\\n| |\\/| | |   | |_) |\n| |  | | |___|  __/\n|_|  |_|\\____|_|\n\n ____   ____ ____      _    ____  _____ ____\n/ ___| / ___|  _ \\    / \\  |  _ \\| ____|  _ \\\n\\___ \\| |   | |_) |  / _ \\ | |_) |  _| | |_) |\n ___) | |___|  _ <  / ___ \\|  __/| |___|  _ <\n|____/ \\____|_| \\_\\/_/   \\_\\_|   |_____|_| \\_\\\n`\n\n  const claudeCommand = [\n    `MCP_SCRAPER_API_KEY=${apiKeyValue} npx -y -p mcp-scraper@latest \\\\`,\n    '  mcp-scraper-cli agent install claude --apply',\n  ].join('\\n')\n\n  const codexConfig = [\n    '[mcp_servers.mcp-scraper]',\n    'command = \"npx\"',\n    'args = [\"-y\", \"-p\", \"mcp-scraper@latest\", \"mcp-scraper\"]',\n    `env = { MCP_SCRAPER_API_KEY = \"${apiKeyValue}\" }`,\n  ].join('\\n')\n\n  return [\n    colorize(`mcp-scraper v${options.version}`, 'bold', color),\n    colorize('> mcp-scraper-install', 'muted', color),\n    colorize(ascii, 'amber', color),\n    `${colorize('MCP Scraper Agent', 'cyan', color)}  .  v${options.version}  .  mcpscraper.dev`,\n    '1/1 install surfaces ready',\n    colorize('Newest: any approved connection read can become an indexed Memory snapshot in one call. OAuth stays tenant-isolated and provider content is redacted and marked untrusted.', 'lime', color),\n    '',\n    `${colorize('Tools', 'cyan', color)}  ${colorize('(220 MCP tools)', 'muted', color)}`,\n    toolRow('search', ['harvest_paa', 'search_serp', 'maps_search', 'maps_place_intel'], color),\n    toolRow('extract', ['extract_url', 'map_site_urls', 'extract_site', 'audit_site', 'directory_workflow'], color),\n    toolRow('build', ['create_editorial_reading_room', 'rank_tracker_workflow', 'portable HTML'], color),\n    toolRow('media', ['youtube_harvest', 'youtube_transcribe', 'facebook_ad_search', 'facebook_page_intel', 'facebook_ad_transcribe', 'facebook_video_transcribe', 'instagram_profile_content', 'instagram_media_download', 'reddit_thread'], color),\n    toolRow('browser', ['browser_open', 'browser_profile_connect', 'browser_profile_list', 'browser_close', 'browser_screenshot', 'browser_read', 'browser_locate', 'browser_replay_mark', 'browser_replay_annotate'], color),\n    toolRow('connect', ['list_service_connections', 'describe_service_connection_tool', 'import_service_connection_to_memory', 'export_connected_service_data', 'renew_connected_data_download', 'read_service_connection', 'call_service_connection_action'], color),\n    toolRow('commons', ['commons_search_entities', 'commons_prepare_entity', 'commons_submit_entity', 'commons_prepare_publication', 'commons_claim_publication', 'commons_publish_editorial', 'commons_get_publication'], color),\n    toolRow('account', ['credits_info', 'reports', 'MCP resources'], color),\n    toolRow('memory', ['memory-put', 'memory-get', 'memory-search', 'list-vaults', 'record-fact', 'list-scheduled-actions'], color),\n    `${colorize('Workflows', 'cyan', color)}  ${colorize('(MCP + CLI + API)', 'muted', color)}`,\n    toolRow('route', ['workflow_list', 'workflow_suggest', 'workflow_run', 'workflow_step', 'workflow_status', 'workflow_artifact_read'], color),\n    toolRow('seo', ['directory', 'agent-packet', 'competitive audit', 'map/serp comparison', 'PAA/AIO briefs', 'scheduled runs'], color),\n    '',\n    colorize('Usage tips:', 'amber', color),\n    'Run mcp-scraper-install for this visible card. Run mcp-scraper-cli for setup utilities and subcommands.',\n    'Run mcp-scraper in a human terminal to print this card; MCP clients get the same command as a silent stdio server.',\n    'Explicit card command: npx -y -p mcp-scraper@latest mcp-scraper-install',\n    'Hosted browser sessions use direct/no-proxy egress by default.',\n    'Customer auth setup: run browser_profile_connect, send the watch_url, let the user sign in, then call browser_profile_list until AUTHENTICATED.',\n    'Connected account ranges: call export_connected_service_data once. It handles Gmail, Calendar, Zoom, and Resend pagination; do not loop read_service_connection over individual records.',\n    'Connected account RAG: call import_service_connection_to_memory for one bounded approved read. It writes a redacted, untrusted snapshot to a stable Memory path and embeds it for search.',\n    'Stack logins / reconnect: run browser_profile_connect again with the same profile name and another domain to add accounts or refresh a login.',\n    'Start with workflow_suggest for broad jobs like market analysis, ICP research, CRO audits, brand briefs, content gaps, and AI visibility.',\n    'For MCP clients, use mcp-scraper so one install can mix SERP, Maps, browser, reports, and saved MCP resources.',\n    'If you hit the concurrency limit, add an extra slot for $5/month with mcp-scraper-cli billing concurrency checkout.',\n    '',\n    `${colorize('Ready.', 'lime', color)} Install the combined MCP server with one command:`,\n    '',\n    colorize('Setup doctor', 'amber', color),\n    'npx -y -p mcp-scraper@latest mcp-scraper-cli doctor',\n    '',\n    colorize('Hosted profile setup', 'amber', color),\n    'In your MCP client, call browser_profile_connect with email=\"seo@example.com\" and domain=\"chatgpt.com\".',\n    'Give the returned watch_url to the user. After they sign in, call browser_profile_list, then browser_open with the returned profile. Add more logins by calling browser_profile_connect again with the same profile and a new domain.',\n    '',\n    colorize('Claude Code one-command setup', 'amber', color),\n    claudeCommand,\n    'Then fully exit Claude Code and open a new Claude terminal. Check with: claude mcp list',\n    '',\n    colorize('Codex config', 'amber', color),\n    codexConfig,\n    '',\n    colorize('Claude Desktop Extension', 'amber', color),\n    'Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb',\n    '',\n    colorize('Safety note:', 'muted', color),\n    'mcp-scraper prints this card only when stdin/stdout are an interactive TTY. In MCP clients it writes only JSON-RPC to stdout.',\n    'Use --stdio or MCP_SCRAPER_FORCE_STDIO=1 to force server mode from a terminal.',\n    '',\n  ].join('\\n')\n}\n","export const PACKAGE_VERSION = '0.47.0'\n","#!/usr/bin/env node\nimport { renderInstallTerminal } from '../src/install-terminal.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst noColor =\n  process.argv.includes('--no-color') ||\n  process.env.NO_COLOR !== undefined ||\n  process.env.FORCE_COLOR === '0' ||\n  !process.stdout.isTTY\n\nconst help = process.argv.includes('--help') || process.argv.includes('-h')\nif (help) {\n  process.stdout.write([\n    'Usage: mcp-scraper-install [--no-color]',\n    '',\n    'Prints the branded MCP Scraper terminal install card and copyable install commands.',\n    'mcp-scraper prints the same card in a human terminal and runs as the MCP stdio server in clients.',\n    '',\n  ].join('\\n'))\n  process.exit(0)\n}\n\nprocess.stdout.write(renderInstallTerminal({\n  version: PACKAGE_VERSION,\n  color: !noColor,\n  apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim()),\n}))\n"],"mappings":"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","names":[]}

package/dist/bin/mcp-scraper-install.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   renderInstallTerminal
-} from "../chunk-GRODXRUY.js";
+} from "../chunk-QSUGPYGQ.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-CEZ3NFBP.js";
+} from "../chunk-H4NWAF5B.js";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-stdio-server.cjs

@@ -669,6 +669,28 @@ var HttpMcpToolExecutor = class {
   commonsListNeedsLinks(input) {
     return this.call("/commons/needs-links/search", input);
   }
+  commonsPreparePublication(input) {
+    return this.call("/commons/publications/prepare", input);
+  }
+  commonsValidatePublication(input) {
+    return this.call("/commons/publications/validate", input);
+  }
+  commonsClaimPublication(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.call("/commons/publications/claim", { ...body, idempotencyKey }, this.timeoutMs, "POST", {
+      "Idempotency-Key": `commons-publication-claim-${(0, import_node_crypto.createHash)("sha256").update(idempotencyKey).digest("hex")}`
+    });
+  }
+  commonsPublishEditorial(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.call("/commons/publications/publish", { ...body, idempotencyKey }, this.timeoutMs, "POST", {
+      "Idempotency-Key": `commons-publication-publish-${(0, import_node_crypto.createHash)("sha256").update(idempotencyKey).digest("hex")}`
+    });
+  }
+  commonsGetPublication(input) {
+    const query = new URLSearchParams({ includeEditions: String(input.includeEditions ?? true) });
+    return this.getJson(input.subdomain ? `/commons/publications/${encodeURIComponent(input.subdomain)}?${query}` : `/commons/publications/me?${query}`);
+  }
   async captureSerpSnapshot(input) {
     const fingerprint = (0, import_node_crypto.createHash)("sha256").update(JSON.stringify(input)).digest("hex");
     const now = Date.now();
@@ -832,7 +854,7 @@ render();
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.45.0";
+var PACKAGE_VERSION = "0.47.0";
 
 // src/mcp/browser-agent-tool-schemas.ts
 var import_zod = require("zod");
@@ -6872,6 +6894,18 @@ seam is noted so you can chain them.
   Use saved filters when a person wants their MCP to operate inside a reading room, trail, source scope,
   category, tag bundle, media constraint, or other personalized subset of the shared Commons graph.
 
+## Transparent Commons user publications
+- A user-owned editorial publication is separate from the neutral public wiki. Start with
+  **commons_prepare_publication** to normalize the requested subdomain, check availability, and read the live
+  ownership contract. Then call **commons_validate_publication** with operation \`claim\` before
+  **commons_claim_publication**.
+- Each account may claim one stable name at \`https://{name}.transparent-commons.cc\`. Claims require an
+  idempotency key and never publish content by themselves.
+- To publish, use **editorial_reading_room_guide** when needed, research and author the complete source-grounded
+  edition, validate it with **commons_validate_publication** operation \`publish\`, then call
+  **commons_publish_editorial**. The publish result returns the permanent publication, archive, and edition URLs.
+- Use **commons_get_publication** to recover the caller's publication and current edition revisions. Existing
+  edition edits require the returned baseRevision. Only the account that claimed the subdomain can publish to it.
 
 ## Google Maps
 - Find multiple places/competitors/prospects -> **maps_search** (returns \`results[]\` with name,
@@ -7334,13 +7368,33 @@ var ScheduledArtifactSelectionSchema = import_zod3.z.discriminatedUnion("mode",
     templateVersionId: import_zod3.z.string().uuid()
   }).strict()
 ]);
-var ArtifactTemplateConfigSchema = import_zod3.z.object({
+var EditorialArtifactTemplateConfigSchema = import_zod3.z.object({
   theme: import_zod3.z.enum(["paper", "ink", "warm"]),
   density: import_zod3.z.enum(["comfortable", "compact"]),
   showSourceRail: import_zod3.z.boolean(),
   showGeneratedAt: import_zod3.z.boolean(),
   brandName: import_zod3.z.string().trim().min(1).max(80).optional()
 }).strict();
+var PersonalAuthorityFeatureFlagsSchema = import_zod3.z.object({
+  navigation: import_zod3.z.boolean(),
+  socialLinks: import_zod3.z.boolean(),
+  authority: import_zod3.z.boolean(),
+  consultation: import_zod3.z.boolean(),
+  learning: import_zod3.z.boolean(),
+  services: import_zod3.z.boolean(),
+  proof: import_zod3.z.boolean(),
+  finalCta: import_zod3.z.boolean()
+}).strict();
+var PersonalAuthorityTemplateConfigSchema = import_zod3.z.object({
+  theme: import_zod3.z.enum(["blue", "slate", "monochrome"]),
+  showGeneratedAt: import_zod3.z.boolean(),
+  brandName: import_zod3.z.string().trim().min(1).max(80).optional(),
+  featureFlags: PersonalAuthorityFeatureFlagsSchema
+}).strict();
+var ArtifactTemplateConfigSchema = import_zod3.z.union([
+  EditorialArtifactTemplateConfigSchema,
+  PersonalAuthorityTemplateConfigSchema
+]);
 var EditorialReadingRoomV1InputSchema = import_zod3.z.object({
   title: import_zod3.z.string().trim().min(1).max(300),
   dek: import_zod3.z.string().trim().max(1e3).optional(),
@@ -7373,25 +7427,104 @@ var EditorialReadingRoomV1InputSchema = import_zod3.z.object({
     });
   }
 });
-var CreateArtifactTemplateInputSchema = import_zod3.z.object({
-  presetKey: import_zod3.z.literal("editorial_reading_room_v1"),
+var PersonalAuthorityActionSchema = import_zod3.z.object({
+  label: import_zod3.z.string().trim().min(1).max(120),
+  href: import_zod3.z.string().trim().min(1).max(2e3)
+}).strict();
+var PersonalAuthorityV1InputSchema = import_zod3.z.object({
+  name: import_zod3.z.string().trim().min(1).max(160),
+  professionalTitle: import_zod3.z.string().trim().min(1).max(300),
+  summary: import_zod3.z.string().trim().min(1).max(1500),
+  location: import_zod3.z.string().trim().max(160).optional(),
+  email: import_zod3.z.string().trim().email().max(320).optional(),
+  phone: import_zod3.z.string().trim().max(80).optional(),
+  primaryAction: PersonalAuthorityActionSchema,
+  secondaryAction: PersonalAuthorityActionSchema.optional(),
+  socialLinks: import_zod3.z.array(import_zod3.z.object({
+    label: import_zod3.z.string().trim().min(1).max(60),
+    href: import_zod3.z.string().trim().min(1).max(2e3)
+  }).strict()).max(8).default([]),
+  authority: import_zod3.z.object({
+    heading: import_zod3.z.string().trim().min(1).max(500),
+    paragraphs: import_zod3.z.array(import_zod3.z.string().trim().min(1).max(2e3)).min(1).max(6)
+  }).strict().optional(),
+  consultation: import_zod3.z.object({
+    eyebrow: import_zod3.z.string().trim().max(120).optional(),
+    heading: import_zod3.z.string().trim().min(1).max(400),
+    summary: import_zod3.z.string().trim().min(1).max(1e3),
+    action: PersonalAuthorityActionSchema
+  }).strict().optional(),
+  learning: import_zod3.z.object({
+    heading: import_zod3.z.string().trim().min(1).max(400),
+    summary: import_zod3.z.string().trim().max(1e3).optional(),
+    topics: import_zod3.z.array(import_zod3.z.object({
+      title: import_zod3.z.string().trim().min(1).max(160),
+      headline: import_zod3.z.string().trim().min(1).max(300),
+      summary: import_zod3.z.string().trim().min(1).max(1500),
+      href: import_zod3.z.string().trim().min(1).max(2e3).optional()
+    }).strict()).min(1).max(12)
+  }).strict().optional(),
+  services: import_zod3.z.object({
+    heading: import_zod3.z.string().trim().min(1).max(400),
+    summary: import_zod3.z.string().trim().max(1e3).optional(),
+    offers: import_zod3.z.array(import_zod3.z.object({
+      title: import_zod3.z.string().trim().min(1).max(160),
+      description: import_zod3.z.string().trim().min(1).max(1500),
+      action: PersonalAuthorityActionSchema.optional()
+    }).strict()).min(1).max(6)
+  }).strict().optional(),
+  proof: import_zod3.z.object({
+    heading: import_zod3.z.string().trim().min(1).max(400),
+    summary: import_zod3.z.string().trim().max(1e3).optional(),
+    testimonials: import_zod3.z.array(import_zod3.z.object({
+      quote: import_zod3.z.string().trim().min(1).max(1500),
+      person: import_zod3.z.string().trim().min(1).max(160),
+      role: import_zod3.z.string().trim().max(200).optional()
+    }).strict()).min(1).max(12)
+  }).strict().optional(),
+  finalCta: import_zod3.z.object({
+    eyebrow: import_zod3.z.string().trim().max(120).optional(),
+    heading: import_zod3.z.string().trim().min(1).max(400),
+    summary: import_zod3.z.string().trim().max(1e3).optional(),
+    action: PersonalAuthorityActionSchema
+  }).strict().optional()
+}).strict();
+var TemplateIdentityFields = {
   name: import_zod3.z.string().trim().min(1).max(120),
   description: import_zod3.z.string().trim().max(500).default(""),
-  config: ArtifactTemplateConfigSchema,
   authoringInstructions: import_zod3.z.string().trim().max(4e3)
-}).strict();
-var UpdateArtifactTemplateInputSchema = CreateArtifactTemplateInputSchema.omit({ presetKey: true }).partial().refine((input) => Object.keys(input).length > 0, "At least one field is required");
-var ArtifactTemplateVersionSchema = import_zod3.z.object({
+};
+var CreateArtifactTemplateInputSchema = import_zod3.z.discriminatedUnion("presetKey", [
+  import_zod3.z.object({
+    presetKey: import_zod3.z.literal("editorial_reading_room_v1"),
+    ...TemplateIdentityFields,
+    config: EditorialArtifactTemplateConfigSchema
+  }).strict(),
+  import_zod3.z.object({
+    presetKey: import_zod3.z.literal("personal_authority_v1"),
+    ...TemplateIdentityFields,
+    config: PersonalAuthorityTemplateConfigSchema
+  }).strict()
+]);
+var UpdateArtifactTemplateInputSchema = import_zod3.z.object({
+  name: TemplateIdentityFields.name.optional(),
+  description: import_zod3.z.string().trim().max(500).optional(),
+  config: ArtifactTemplateConfigSchema.optional(),
+  authoringInstructions: TemplateIdentityFields.authoringInstructions.optional()
+}).strict().refine((input) => Object.keys(input).length > 0, "At least one field is required");
+var ArtifactTemplateVersionBase = {
   templateVersionId: import_zod3.z.string().uuid(),
   templateId: import_zod3.z.string().uuid(),
   version: import_zod3.z.number().int().positive(),
-  rendererKey: import_zod3.z.literal("editorial_reading_room_v1"),
   rendererVersion: import_zod3.z.literal(1),
   inputContractVersion: import_zod3.z.literal(1),
-  config: ArtifactTemplateConfigSchema,
   authoringInstructions: import_zod3.z.string().max(4e3),
   createdAt: import_zod3.z.string().datetime()
-}).strict();
+};
+var ArtifactTemplateVersionSchema = import_zod3.z.discriminatedUnion("rendererKey", [
+  import_zod3.z.object({ ...ArtifactTemplateVersionBase, rendererKey: import_zod3.z.literal("editorial_reading_room_v1"), config: EditorialArtifactTemplateConfigSchema }).strict(),
+  import_zod3.z.object({ ...ArtifactTemplateVersionBase, rendererKey: import_zod3.z.literal("personal_authority_v1"), config: PersonalAuthorityTemplateConfigSchema }).strict()
+]);
 var ArtifactTemplateSchema = import_zod3.z.object({
   templateId: import_zod3.z.string().uuid(),
   name: import_zod3.z.string().min(1).max(120),
@@ -7406,9 +7539,15 @@ var ArtifactTemplateSchema = import_zod3.z.object({
 var ListArtifactTemplatesResponseSchema = import_zod3.z.object({
   ok: import_zod3.z.literal(true),
   presets: import_zod3.z.array(import_zod3.z.object({
-    presetKey: import_zod3.z.literal("editorial_reading_room_v1"),
+    presetKey: import_zod3.z.enum(["editorial_reading_room_v1", "personal_authority_v1"]),
     name: import_zod3.z.string(),
     description: import_zod3.z.string(),
+    mark: import_zod3.z.string().min(1).max(4),
+    featureFlags: import_zod3.z.array(import_zod3.z.object({
+      key: import_zod3.z.string().min(1),
+      label: import_zod3.z.string().min(1),
+      description: import_zod3.z.string().min(1)
+    }).strict()),
     defaultConfig: ArtifactTemplateConfigSchema
   }).strict()),
   templates: import_zod3.z.array(ArtifactTemplateSchema)
@@ -7423,7 +7562,7 @@ var ScheduledRunArtifactOutputSchema = import_zod3.z.object({
   artifactId: import_zod3.z.string().min(1).max(1e3),
   templateId: import_zod3.z.string().uuid(),
   templateVersionId: import_zod3.z.string().uuid(),
-  rendererKey: import_zod3.z.literal("editorial_reading_room_v1"),
+  rendererKey: import_zod3.z.enum(["editorial_reading_room_v1", "personal_authority_v1"]),
   rendererVersion: import_zod3.z.literal(1),
   mimeType: import_zod3.z.literal("text/html"),
   title: import_zod3.z.string().min(1).max(300),
@@ -7475,18 +7614,29 @@ var GetScheduledRunResponseSchema = import_zod3.z.object({
   ok: import_zod3.z.literal(true),
   run: ScheduledRunResultSchema
 }).strict();
-var InternalScheduledArtifactRenderRequestSchema = import_zod3.z.object({
+var InternalScheduledArtifactRenderRequestBase = {
   identity: import_zod3.z.string().min(1).max(320),
   ownerId: import_zod3.z.string().regex(/^[a-f0-9]{24}$/),
   runId: import_zod3.z.string().min(1).max(200),
   scheduleId: import_zod3.z.string().uuid(),
   templateId: import_zod3.z.string().uuid(),
   templateVersionId: import_zod3.z.string().uuid(),
-  rendererKey: import_zod3.z.literal("editorial_reading_room_v1"),
-  rendererVersion: import_zod3.z.literal(1),
-  config: ArtifactTemplateConfigSchema,
-  input: EditorialReadingRoomV1InputSchema
-}).strict();
+  rendererVersion: import_zod3.z.literal(1)
+};
+var InternalScheduledArtifactRenderRequestSchema = import_zod3.z.discriminatedUnion("rendererKey", [
+  import_zod3.z.object({
+    ...InternalScheduledArtifactRenderRequestBase,
+    rendererKey: import_zod3.z.literal("editorial_reading_room_v1"),
+    config: EditorialArtifactTemplateConfigSchema,
+    input: EditorialReadingRoomV1InputSchema
+  }).strict(),
+  import_zod3.z.object({
+    ...InternalScheduledArtifactRenderRequestBase,
+    rendererKey: import_zod3.z.literal("personal_authority_v1"),
+    config: PersonalAuthorityTemplateConfigSchema,
+    input: PersonalAuthorityV1InputSchema
+  }).strict()
+]);
 var CreateScheduledRunViewLinkInputSchema = import_zod3.z.object({
   artifactId: import_zod3.z.string().min(1).max(1e3),
   expiresInDays: import_zod3.z.number().int().min(1).max(30).default(7)
@@ -8236,6 +8386,37 @@ var RenewEditorialReadingRoomDownloadOutputSchema = {
   downloadUrlExpiresAt: import_zod6.z.string(),
   expiresAt: import_zod6.z.string()
 };
+var CommonsPublicationSubdomainSchema = import_zod6.z.string().trim().min(3).max(50).describe("Requested publication name under transparent-commons.cc. The server normalizes spaces to hyphens, rejects reserved names, and enforces one globally unique name per account.");
+var CommonsPreparePublicationInputSchema = {
+  requestedSubdomain: CommonsPublicationSubdomainSchema,
+  title: import_zod6.z.string().trim().min(1).max(140).optional().describe("Reader-facing publication title. Omit to derive it from the chosen subdomain."),
+  description: import_zod6.z.string().trim().max(500).optional().describe("Short description used on the publication archive and discovery surfaces.")
+};
+var CommonsValidatePublicationInputSchema = {
+  operation: import_zod6.z.enum(["claim", "publish"]).describe("Validate either a new name claim or a finished editorial edition without writing."),
+  requestedSubdomain: CommonsPublicationSubdomainSchema.optional().describe("Publication name to validate when operation is claim."),
+  publicationSubdomain: CommonsPublicationSubdomainSchema.optional().describe("Already claimed publication name to validate when operation is publish."),
+  title: import_zod6.z.string().trim().min(1).max(140).optional(),
+  description: import_zod6.z.string().trim().max(500).optional(),
+  edition: import_zod6.z.object(CreateEditorialReadingRoomInputSchema).strict().optional().describe("Complete source-grounded reading-room payload to validate when operation is publish."),
+  editionSlug: import_zod6.z.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(80).optional().describe("Stable public edition slug. Defaults to edition.site.slug."),
+  baseRevision: import_zod6.z.number().int().positive().optional().describe("Current edition revision when validating an edit.")
+};
+var CommonsClaimPublicationInputSchema = {
+  ...CommonsPreparePublicationInputSchema,
+  idempotencyKey: import_zod6.z.string().trim().min(8).max(200).describe("Unique key for this intended claim. Reuse it only when retrying the same claim.")
+};
+var CommonsPublishEditorialInputSchema = {
+  publicationSubdomain: CommonsPublicationSubdomainSchema.describe("Publication owned by the authenticated account."),
+  editionSlug: import_zod6.z.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(80).optional().describe("Stable public edition slug. Defaults to site.slug."),
+  idempotencyKey: import_zod6.z.string().trim().min(8).max(200).describe("Unique key for this intended publish. Reuse it only when retrying the same revision."),
+  baseRevision: import_zod6.z.number().int().positive().optional().describe("Required when revising an existing edition; use the current revision from commons_get_publication."),
+  ...CreateEditorialReadingRoomInputSchema
+};
+var CommonsGetPublicationInputSchema = {
+  subdomain: CommonsPublicationSubdomainSchema.optional().describe("Public publication name to inspect. Omit to return the publication owned by the authenticated account."),
+  includeEditions: import_zod6.z.boolean().default(true).describe("Include the latest revision of every published edition.")
+};
 var RankTrackerModeSchema = import_zod6.z.enum(["maps", "organic", "ai_overview", "paa"]);
 var RankTrackerBlueprintInputSchema = {
   projectName: import_zod6.z.string().min(1).optional().describe("Optional name for the rank tracker project, client, or campaign."),
@@ -10955,6 +11136,41 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
       openWorldHint: false
     }
   }, async (input) => executor.commonsListFilters(input));
+  server.registerTool("commons_prepare_publication", {
+    title: "Prepare Transparent Commons Publication",
+    description: "Check and normalize a subscriber-chosen Transparent Commons publication name before any write. Returns name availability, the caller's existing publication, permanent URL shape, ownership rules, and the required validate/claim/publish workflow. This is for a user-owned editorial publication, not a neutral /wiki/ entity.",
+    inputSchema: CommonsPreparePublicationInputSchema,
+    outputSchema: recordOutputSchema("commons_prepare_publication", CommonsGenericOutputSchema),
+    annotations: { title: "Prepare Transparent Commons Publication", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, async (input) => executor.commonsPreparePublication(input));
+  server.registerTool("commons_validate_publication", {
+    title: "Validate Transparent Commons Publication",
+    description: "Validate a publication name claim or a complete source-grounded editorial edition without writing. Use operation claim before commons_claim_publication and operation publish before commons_publish_editorial. This uses the editorial reading-room contract and checks ownership plus revision conflicts.",
+    inputSchema: CommonsValidatePublicationInputSchema,
+    outputSchema: recordOutputSchema("commons_validate_publication", CommonsGenericOutputSchema),
+    annotations: { title: "Validate Transparent Commons Publication", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, async (input) => executor.commonsValidatePublication(input));
+  server.registerTool("commons_claim_publication", {
+    title: "Claim Transparent Commons Publication",
+    description: "Permanently claim one globally unique publication subdomain for the authenticated MCP Scraper account. Call commons_prepare_publication and commons_validate_publication first. This creates public identity state but does not publish an edition. Requires an idempotencyKey; retries with the same intended claim are safe.",
+    inputSchema: CommonsClaimPublicationInputSchema,
+    outputSchema: recordOutputSchema("commons_claim_publication", CommonsGenericOutputSchema),
+    annotations: { title: "Claim Transparent Commons Publication", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
+  }, async (input) => executor.commonsClaimPublication(input));
+  server.registerTool("commons_publish_editorial", {
+    title: "Publish Transparent Commons Editorial Edition",
+    description: "Publish a fully authored editorial reading-room edition to the caller-owned Transparent Commons subdomain and return permanent root, archive, and edition URLs. The calling AI must research and author the source-grounded edition first; this tool validates, renders, and persists it. For an existing edition, pass its current baseRevision. Requires an idempotencyKey; this is not the neutral wiki write tool.",
+    inputSchema: CommonsPublishEditorialInputSchema,
+    outputSchema: recordOutputSchema("commons_publish_editorial", CommonsGenericOutputSchema),
+    annotations: { title: "Publish Transparent Commons Editorial Edition", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
+  }, async (input) => executor.commonsPublishEditorial(input));
+  server.registerTool("commons_get_publication", {
+    title: "Get Transparent Commons Publication",
+    description: "Read a Transparent Commons publication and its latest edition revisions. Omit subdomain to inspect the caller-owned publication; pass a name to inspect a public publication. Returns the permanent public and archive URLs needed for sharing or later edits.",
+    inputSchema: CommonsGetPublicationInputSchema,
+    outputSchema: recordOutputSchema("commons_get_publication", CommonsGenericOutputSchema),
+    annotations: { title: "Get Transparent Commons Publication", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, async (input) => executor.commonsGetPublication(input));
   server.registerTool("directory_workflow", {
     title: "Directory Workflow: Markets + Maps",
     description: `Start a durable directory/prospecting job: selects US city markets from versioned hosted Census-place data, optionally joins the active hosted ZIP dataset, then runs Google Maps business searches per city. Pass a new idempotencyKey for each intended job and reuse it only when retrying that call. Production does not read server-local location CSVs. Always returns a background jobId; poll with directory_workflow_status. ${fileBehavior("Saves a CSV of results per city.", "Completed jobs return an owner-scoped CSV artifact.")}`,
@@ -13946,13 +14162,14 @@ function renderInstallTerminal(options) {
     "1/1 install surfaces ready",
     colorize("Newest: any approved connection read can become an indexed Memory snapshot in one call. OAuth stays tenant-isolated and provider content is redacted and marked untrusted.", "lime", color),
     "",
-    `${colorize("Tools", "cyan", color)}  ${colorize("(215 MCP tools)", "muted", color)}`,
+    `${colorize("Tools", "cyan", color)}  ${colorize("(220 MCP tools)", "muted", color)}`,
     toolRow("search", ["harvest_paa", "search_serp", "maps_search", "maps_place_intel"], color),
     toolRow("extract", ["extract_url", "map_site_urls", "extract_site", "audit_site", "directory_workflow"], color),
     toolRow("build", ["create_editorial_reading_room", "rank_tracker_workflow", "portable HTML"], color),
     toolRow("media", ["youtube_harvest", "youtube_transcribe", "facebook_ad_search", "facebook_page_intel", "facebook_ad_transcribe", "facebook_video_transcribe", "instagram_profile_content", "instagram_media_download", "reddit_thread"], color),
     toolRow("browser", ["browser_open", "browser_profile_connect", "browser_profile_list", "browser_close", "browser_screenshot", "browser_read", "browser_locate", "browser_replay_mark", "browser_replay_annotate"], color),
     toolRow("connect", ["list_service_connections", "describe_service_connection_tool", "import_service_connection_to_memory", "export_connected_service_data", "renew_connected_data_download", "read_service_connection", "call_service_connection_action"], color),
+    toolRow("commons", ["commons_search_entities", "commons_prepare_entity", "commons_submit_entity", "commons_prepare_publication", "commons_claim_publication", "commons_publish_editorial", "commons_get_publication"], color),
     toolRow("account", ["credits_info", "reports", "MCP resources"], color),
     toolRow("memory", ["memory-put", "memory-get", "memory-search", "list-vaults", "record-fact", "list-scheduled-actions"], color),
     `${colorize("Workflows", "cyan", color)}  ${colorize("(MCP + CLI + API)", "muted", color)}`,
@@ -14130,40 +14347,40 @@ function annotations(title, readOnlyHint, destructiveHint = false, idempotentHin
 }
 function registerScheduledResultsMcpTools(server, executor) {
   server.registerTool("list_artifact_templates", {
-    title: "List Artifact Templates",
-    description: "List approved built-in artifact presets and saved immutable template versions. A preset must be saved before an automation can select it.",
+    title: "List Templates",
+    description: "List registered presentation presets and saved immutable template versions. A preset must be saved before an automation can select it.",
     inputSchema: import_zod10.z.object({
       status: import_zod10.z.enum(["active", "archived", "all"]).default("active")
     }).strict(),
     outputSchema: recordOutputSchema("list_artifact_templates", McpListArtifactTemplatesOutputSchema),
-    annotations: annotations("List Artifact Templates", true)
+    annotations: annotations("List Templates", true)
   }, (input) => executor.call(
     `/artifact-templates?status=${encodeURIComponent(input.status)}`,
     ListArtifactTemplatesOutputSchema
   ));
   server.registerTool("get_artifact_template", {
-    title: "Get Artifact Template",
-    description: "Read one saved artifact template and its immutable version history.",
+    title: "Get Template",
+    description: "Read one saved template, its renderer family, configuration, and immutable version history.",
     inputSchema: import_zod10.z.object({ templateId: TemplateIdSchema }).strict(),
     outputSchema: recordOutputSchema("get_artifact_template", McpArtifactTemplateOutputSchema),
-    annotations: annotations("Get Artifact Template", true)
+    annotations: annotations("Get Template", true)
   }, (input) => executor.call(
     `/artifact-templates/${encodeURIComponent(input.templateId)}`,
     ArtifactTemplateOutputSchema
   ));
   server.registerTool("create_artifact_template", {
-    title: "Save Artifact Template",
-    description: "Save the approved Editorial Reading Room preset as a user-owned template version 1. Arbitrary HTML, JavaScript, and executable code are not accepted.",
+    title: "Create Template",
+    description: "Create a user-owned template from a registered preset. Customize supported flags and presentation guidance; arbitrary executable code is not accepted.",
     inputSchema: CreateArtifactTemplateInputSchema,
     outputSchema: recordOutputSchema("create_artifact_template", McpArtifactTemplateOutputSchema),
-    annotations: annotations("Save Artifact Template", false)
+    annotations: annotations("Create Template", false)
   }, (input) => executor.call("/artifact-templates", ArtifactTemplateOutputSchema, "POST", input));
   server.registerTool("update_artifact_template", {
-    title: "Create Artifact Template Version",
-    description: "Create the next immutable version of a saved artifact template. Existing automations remain pinned to their exact prior version until explicitly changed.",
+    title: "Update Template",
+    description: "Create the next immutable version of a saved template. Existing automations remain pinned to their exact prior version until explicitly changed.",
     inputSchema: UpdateArtifactTemplateToolInputSchema,
     outputSchema: recordOutputSchema("update_artifact_template", McpArtifactTemplateOutputSchema),
-    annotations: annotations("Create Artifact Template Version", false)
+    annotations: annotations("Update Template", false)
   }, (input) => {
     const { templateId, ...body } = input;
     UpdateArtifactTemplateInputSchema.parse(body);
@@ -14175,14 +14392,14 @@ function registerScheduledResultsMcpTools(server, executor) {
     );
   });
   server.registerTool("archive_artifact_template", {
-    title: "Archive Artifact Template",
+    title: "Archive Template",
     description: "Archive or restore a saved template without deleting its immutable versions. Existing pinned automations continue to work.",
     inputSchema: import_zod10.z.object({
       templateId: TemplateIdSchema,
       archived: import_zod10.z.boolean()
     }).strict(),
     outputSchema: recordOutputSchema("archive_artifact_template", McpArtifactTemplateOutputSchema),
-    annotations: annotations("Archive Artifact Template", false, false, true)
+    annotations: annotations("Archive Template", false, false, true)
   }, (input) => executor.call(
     `/artifact-templates/${encodeURIComponent(input.templateId)}/${input.archived ? "archive" : "restore"}`,
     ArtifactTemplateOutputSchema,