mcpbrowser 0.3.44 → 0.3.46

package/src/actions/take-screenshot.js

@@ -16,7 +16,7 @@ import logger from '../core/logger.js';
 // ============================================================================
 
 /**
- * Response for successful take_screenshot operations
+ * Response for successful browser_take_screenshot operations
  * Returns screenshot as base64-encoded image
  */
 export class TakeScreenshotSuccessResponse extends MCPResponse {
@@ -87,9 +87,9 @@ export class TakeScreenshotSuccessResponse extends MCPResponse {
  * @type {Tool}
  */
 export const TAKE_SCREENSHOT_TOOL = {
-  name: "take_screenshot",
+  name: "browser_take_screenshot",
   title: "Take Screenshot",
-  description: "**VISUAL CAPTURE** - Takes a screenshot of an already-loaded page for visual analysis. Useful when HTML parsing is insufficient or you need to see visual layout, images, charts, or rendered content. Returns a PNG image.\n\n**PREREQUISITE**: Page MUST be loaded with fetch_webpage first. This tool captures the current visual state of the page.",
+  description: "**VISUAL CAPTURE** - Takes a screenshot of an already-loaded page for visual analysis. Useful when HTML parsing is insufficient or you need to see visual layout, images, charts, or rendered content. Returns a PNG image.\n\n**PREREQUISITE**: Page MUST be loaded with browser_fetch_webpage first. This tool captures the current visual state of the page.",
   inputSchema: {
     type: "object",
     properties: {
@@ -129,7 +129,7 @@ export const TAKE_SCREENSHOT_TOOL = {
  * @returns {Promise<Object>} Result object with screenshot data
  */
 export async function takeScreenshot({ url, fullPage = false }) {
-  logger.info(`take_screenshot called: url=${url}, fullPage=${fullPage}`);
+  logger.info(`browser_take_screenshot called: url=${url}, fullPage=${fullPage}`);
   
   if (!url) {
     throw new Error("url parameter is required");
@@ -146,7 +146,7 @@ export async function takeScreenshot({ url, fullPage = false }) {
   try {
     await getBrowser();
   } catch (err) {
-    logger.error(`take_screenshot: Failed to connect to browser: ${err.message}`);
+    logger.error(`browser_take_screenshot: Failed to connect to browser: ${err.message}`);
     return new InformationalResponse(
       `Browser connection failed: ${err.message}`,
       'The browser must be running with remote debugging enabled.',
@@ -163,15 +163,15 @@ export async function takeScreenshot({ url, fullPage = false }) {
   
   if (!page) {
     const isConnectionLost = pageError && pageError.includes('connection');
-    logger.debug(`take_screenshot: ${pageError || 'No page found for ' + hostname}`);
+    logger.debug(`browser_take_screenshot: ${pageError || 'No page found for ' + hostname}`);
     return new InformationalResponse(
       isConnectionLost ? `Page connection lost for ${hostname}` : `No open page found for ${hostname}`,
       isConnectionLost 
         ? 'The browser tab was closed or the connection was lost. The page needs to be reloaded.'
         : 'The page must be loaded before you can take a screenshot',
       [
-        "Use MCPBrowser's fetch_webpage tool to load the page first",
-        "Then retry MCPBrowser's take_screenshot with the same URL"
+        "Use MCPBrowser's browser_fetch_webpage tool to load the page first",
+        "Then retry MCPBrowser's browser_take_screenshot with the same URL"
       ]
     );
   }
@@ -186,27 +186,27 @@ export async function takeScreenshot({ url, fullPage = false }) {
       fullPage: fullPage
     });
     
-    logger.info(`take_screenshot completed: captured from ${currentUrl} (fullPage=${fullPage})`);
+    logger.info(`browser_take_screenshot completed: captured from ${currentUrl} (fullPage=${fullPage})`);
     
     return new TakeScreenshotSuccessResponse(
       currentUrl,
       screenshotBuffer,
       'image/png',
       [
-        "Use MCPBrowser's get_current_html if you need the HTML instead",
-        "Use MCPBrowser's click_element to interact with elements",
-        "Use MCPBrowser's type_text to fill forms",
-        "Use MCPBrowser's close_tab to free resources when done"
+        "Use MCPBrowser's browser_get_current_html if you need the HTML instead",
+        "Use MCPBrowser's browser_click_element to interact with elements",
+        "Use MCPBrowser's browser_type_text to fill forms",
+        "Use MCPBrowser's browser_close_tab to free resources when done"
       ]
     );
   } catch (err) {
-    logger.error(`take_screenshot failed: ${err.message}`);
+    logger.error(`browser_take_screenshot failed: ${err.message}`);
     return new InformationalResponse(
       `Failed to take screenshot: ${err.message}`,
       'Could not capture screenshot from the page. The page may have navigated away or the connection was lost.',
       [
-        "Try MCPBrowser's fetch_webpage to reload the page",
-        "Use MCPBrowser's close_tab and start fresh if needed"
+        "Try MCPBrowser's browser_fetch_webpage to reload the page",
+        "Use MCPBrowser's browser_close_tab and start fresh if needed"
       ]
     );
   }

package/src/actions/type-text.js

@@ -16,7 +16,7 @@ import logger from '../core/logger.js';
 // ============================================================================
 
 /**
- * Response for successful type_text operations
+ * Response for successful browser_type_text operations
  */
 export class TypeTextSuccessResponse extends MCPResponse {
   /**
@@ -64,9 +64,9 @@ export class TypeTextSuccessResponse extends MCPResponse {
  * @type {Tool}
  */
 export const TYPE_TEXT_TOOL = {
-  name: "type_text",
+  name: "browser_type_text",
   title: "Type Text",
-  description: "**BROWSER INTERACTION** - Types text into multiple input fields on browser-loaded pages in a single call. Use this for filling forms, entering search queries, or any text input on the page.\n\nWorks with input fields, textareas, and other editable elements. Supports filling multiple fields at once for efficient form filling.\n\n**PREREQUISITE**: Page MUST be loaded with fetch_webpage first. This tool operates on an already-loaded page in the browser.",
+  description: "**BROWSER INTERACTION** - Types text into multiple input fields on browser-loaded pages in a single call. Use this for filling forms, entering search queries, or any text input on the page.\n\nWorks with input fields, textareas, and other editable elements. Supports filling multiple fields at once for efficient form filling.\n\n**PREREQUISITE**: Page MUST be loaded with browser_fetch_webpage first. This tool operates on an already-loaded page in the browser.",
   inputSchema: {
     type: "object",
     properties: {
@@ -137,7 +137,7 @@ const TYPE_DELAY_MS = 10;
  */
 export async function typeText({ url, fields, returnHtml = true, removeUnnecessaryHTML = true, postTypeWait = 1000 }) {
   const startTime = Date.now();
-  logger.info(`type_text called: ${fields?.length || 0} fields, url=${url}`);
+  logger.info(`browser_type_text called: ${fields?.length || 0} fields, url=${url}`);
   
   if (!url) {
     throw new Error("url parameter is required");
@@ -169,7 +169,7 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
   try {
     await getBrowser();
   } catch (err) {
-    logger.error(`type_text: Failed to connect to browser: ${err.message}`);
+    logger.error(`browser_type_text: Failed to connect to browser: ${err.message}`);
     return new InformationalResponse(
       `Browser connection failed: ${err.message}`,
       'The browser must be running with remote debugging enabled.',
@@ -186,15 +186,15 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
   
   if (!page) {
     const isConnectionLost = pageError && pageError.includes('connection');
-    logger.debug(`type_text: ${pageError || 'No page found for ' + hostname}`);
+    logger.debug(`browser_type_text: ${pageError || 'No page found for ' + hostname}`);
     return new InformationalResponse(
       isConnectionLost ? `Page connection lost for ${hostname}` : `No open page found for ${hostname}`,
       isConnectionLost 
         ? 'The browser tab was closed or the connection was lost. The page needs to be reloaded.'
         : 'The page must be loaded before you can type text into elements',
       [
-        "Use MCPBrowser's fetch_webpage tool to load the page first",
-        "Then retry MCPBrowser's type_text with the same URL"
+        "Use MCPBrowser's browser_fetch_webpage tool to load the page first",
+        "Then retry MCPBrowser's browser_type_text with the same URL"
       ]
     );
   }
@@ -239,20 +239,20 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
     const html = returnHtml ? await extractAndProcessHtml(page, removeUnnecessaryHTML) : null;
     const nextSteps = returnHtml
       ? [
-          "Use MCPBrowser's type_text to fill additional fields",
-          "Use MCPBrowser's click_element to submit the form or navigate",
-          "Use MCPBrowser's get_current_html to check for validation messages",
-          "Use MCPBrowser's take_screenshot if form has visual feedback or validation that's hard to parse from HTML",
-          "Use MCPBrowser's close_tab when finished"
+          "Use MCPBrowser's browser_type_text to fill additional fields",
+          "Use MCPBrowser's browser_click_element to submit the form or navigate",
+          "Use MCPBrowser's browser_get_current_html to check for validation messages",
+          "Use MCPBrowser's browser_take_screenshot if form has visual feedback or validation that's hard to parse from HTML",
+          "Use MCPBrowser's browser_close_tab when finished"
         ]
       : [
-          "Use MCPBrowser's get_current_html to see updated page state",
-          "Use MCPBrowser's take_screenshot if the page has visual feedback that's hard to parse",
-          "Use MCPBrowser's type_text for additional fields or MCPBrowser's click_element to submit",
-          "Use MCPBrowser's close_tab when finished"
+          "Use MCPBrowser's browser_get_current_html to see updated page state",
+          "Use MCPBrowser's browser_take_screenshot if the page has visual feedback that's hard to parse",
+          "Use MCPBrowser's browser_type_text for additional fields or MCPBrowser's browser_click_element to submit",
+          "Use MCPBrowser's browser_close_tab when finished"
         ];
     
-    logger.info(`type_text completed: typed into ${fieldsSummary}${returnHtml ? '' : ' (no HTML)'}`);
+    logger.info(`browser_type_text completed: typed into ${fieldsSummary}${returnHtml ? '' : ' (no HTML)'}`);
     
     return new TypeTextSuccessResponse(currentUrl, `Typed text into: ${fieldsSummary}`, html, nextSteps);
   } catch (err) {
@@ -272,29 +272,29 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
     if (isNotFound) {
       reason = `Selector not found: "${currentSelector}". The element may not exist on the page or have a different selector.`;
       nextSteps = [
-        "Use MCPBrowser's get_current_html to find the correct selector",
-        "Use MCPBrowser's take_screenshot to visually inspect the form",
+        "Use MCPBrowser's browser_get_current_html to find the correct selector",
+        "Use MCPBrowser's browser_take_screenshot to visually inspect the form",
         "Check for typos in the selector or try a simpler selector (e.g., 'input[type=\"text\"]')",
         "The element may load dynamically - try increasing waitForElementTimeout"
       ];
     } else if (isNotVisible) {
       reason = `Element "${currentSelector}" exists but is not visible. It may be hidden, collapsed, or off-screen.`;
       nextSteps = [
-        "Use MCPBrowser's take_screenshot to see the page state",
-        "Use MCPBrowser's click_element to expand/show the form section first",
-        "Use MCPBrowser's scroll_page to bring the element into view"
+        "Use MCPBrowser's browser_take_screenshot to see the page state",
+        "Use MCPBrowser's browser_click_element to expand/show the form section first",
+        "Use MCPBrowser's browser_scroll_page to bring the element into view"
       ];
     } else if (isDetached) {
       reason = `Element "${currentSelector}" was removed from the page during interaction. The page may have reloaded or updated.`;
       nextSteps = [
-        "Use MCPBrowser's get_current_html to check current page state",
-        "Retry the type_text call - the page may have stabilized"
+        "Use MCPBrowser's browser_get_current_html to check current page state",
+        "Retry the browser_type_text call - the page may have stabilized"
       ];
     } else {
       reason = `Failed to interact with "${currentSelector}": ${errorMsg}`;
       nextSteps = [
-        "Use MCPBrowser's get_current_html to verify page state",
-        "Use MCPBrowser's take_screenshot to see what's on the page visually",
+        "Use MCPBrowser's browser_get_current_html to verify page state",
+        "Use MCPBrowser's browser_take_screenshot to see what's on the page visually",
         "The element may be disabled or read-only"
       ];
     }
@@ -307,7 +307,7 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
       progressInfo = `Failed on field ${failedFieldNum} of ${totalFields}. Successfully filled ${filledSelectors.length} field(s): ${filledSelectors.join(', ')}. Do NOT re-type these fields.`;
     }
     
-    logger.error(`type_text failed on field ${failedFieldNum}/${totalFields} (${currentSelector}): ${errorMsg}`);
+    logger.error(`browser_type_text failed on field ${failedFieldNum}/${totalFields} (${currentSelector}): ${errorMsg}`);
     
     return new InformationalResponse(
       `${progressInfo}`,

package/src/cli/help.js

@@ -162,7 +162,7 @@ export function printHelp() {
   o('━'.repeat(70));
   o('');
   o('  No arguments → starts MCP server (stdin/stdout JSON-RPC).');
-  o('  CLI commands map 1:1 to MCP tools (fetch→fetch_webpage, etc.).');
+  o('  CLI commands map 1:1 to MCP tools (fetch→browser_fetch_webpage, etc.).');
   o('');
   o('  { "mcpServers": { "mcpbrowser": { "command": "npx", "args": ["-y", "mcpbrowser@latest"] } } }');
   o('');

package/src/core/html.js

@@ -70,8 +70,9 @@ export function cleanHtml(html) {
   // Remove event handler attributes (onclick, onload, etc.)
   cleaned = cleaned.replace(/\s+on[a-z]+\s*=\s*["'][^"']*["']/gi, '');
   
-  // Remove role attributes
-  cleaned = cleaned.replace(/\s+role=["'][^"']*["']/gi, '');
+  // Keep role attributes — they're semantically valuable for LLM understanding
+  // and enable stable selectors like [role="main"], [role="navigation"]
+  // cleaned = cleaned.replace(/\s+role=["'][^"']*["']/gi, '');
   
   // Remove aria-* attributes
   cleaned = cleaned.replace(/\s+aria-[a-z0-9-]+=["'][^"']*["']/gi, '');

package/src/core/logger.js

@@ -1,5 +1,7 @@
 /**
  * Logger - Emits to stderr and, when available, via MCP logging notifications.
+ * Also sends MCP progress notifications (notifications/progress) when a
+ * progressToken is active, so agents see real-time status during tool execution.
  * Stderr stays the primary sink to avoid interfering with MCP stdout traffic.
  */
 
@@ -8,6 +10,10 @@ const PREFIX = '[MCPBrowser]';
 // Optional MCP server reference for notifications/message logs.
 let mcpServer = null;
 
+// MCP progress tracking — set per-request by the request handler.
+let _progressToken = null;
+let _progressStep = 0;
+
 // Optional stdout mirroring (off by default to avoid corrupting MCP stdout).
 // Auto-enable during tests so test runners capture output.
 let consoleOutputEnabled = process.env.NODE_ENV === 'test';
@@ -32,6 +38,25 @@ function setConsoleOutput(enabled = true) {
   consoleOutputEnabled = !!enabled;
 }
 
+/**
+ * Set the MCP progress token for the current request.
+ * While set, every logger.info() call also sends a notifications/progress
+ * message so the agent sees real-time status during tool execution.
+ * @param {string|number|null|undefined} token - progressToken from request._meta
+ */
+function setProgressToken(token) {
+  _progressToken = token ?? null;
+  _progressStep = 0;
+}
+
+/**
+ * Clear the progress token after the request completes.
+ */
+function clearProgressToken() {
+  _progressToken = null;
+  _progressStep = 0;
+}
+
 async function notifyAgent(level, data) {
   if (!mcpServer?.sendLoggingMessage) return;
   try {
@@ -44,6 +69,28 @@ async function notifyAgent(level, data) {
   }
 }
 
+/**
+ * Send an MCP progress notification if a progressToken is active.
+ * Called automatically from info-level log messages.
+ * @param {string} message - Human-readable progress message
+ */
+async function sendProgress(message) {
+  if (!_progressToken || !mcpServer) return;
+  _progressStep++;
+  try {
+    await mcpServer.notification({
+      method: 'notifications/progress',
+      params: {
+        progressToken: _progressToken,
+        progress: _progressStep,
+        message
+      }
+    });
+  } catch {
+    // Fire and forget — don't break the action if progress fails
+  }
+}
+
 function emit(level, message, symbol = '') {
   const line = symbol ? `${PREFIX} ${symbol} ${message}` : `${PREFIX} ${message}`;
   console.error(line);
@@ -55,6 +102,8 @@ function emit(level, message, symbol = '') {
 
 function info(message) {
   emit('info', message);
+  // Also send as MCP progress notification when token is active
+  void sendProgress(message);
 }
 
 function warn(message) {
@@ -69,6 +118,6 @@ function debug(message) {
   emit('debug', message, '🔍');
 }
 
-export const logger = { info, warn, error, debug, attachServer, setConsoleOutput };
-export { attachServer, setConsoleOutput };
+export const logger = { info, warn, error, debug, attachServer, setConsoleOutput, setProgressToken, clearProgressToken };
+export { attachServer, setConsoleOutput, setProgressToken, clearProgressToken };
 export default logger;

package/src/core/page.js

@@ -475,23 +475,52 @@ async function waitForNavigationToSettle(page) {
  * settle and retries once.
  * @param {Page} page - The Puppeteer page instance
  * @param {boolean} removeUnnecessaryHTML - Whether to clean the HTML
+ * @param {string|null} [selector=null] - CSS selector to extract a DOM subtree instead of full page
  * @returns {Promise<string>} The processed HTML
  */
-export async function extractAndProcessHtml(page, removeUnnecessaryHTML) {
+export async function extractAndProcessHtml(page, removeUnnecessaryHTML, selector = null) {
   let html;
+
+  const extractFn = selector
+    ? (sel) => {
+        const els = document.querySelectorAll(sel);
+        if (!els.length) return null;
+        return Array.from(els).map(el => el.outerHTML).join('\n');
+      }
+    : () => document.documentElement?.outerHTML || "";
+
+  const extractArg = selector || undefined;
+
   try {
-    html = await page.evaluate(() => document.documentElement?.outerHTML || "");
+    html = await page.evaluate(extractFn, extractArg);
   } catch (err) {
     if (isNavigationError(err)) {
       logger.debug('Late navigation during HTML extraction, waiting for settle...');
       await waitForNavigationToSettle(page);
       // Re-run page readiness — the new page may be a SPA that needs rendering time
       await waitForPageReady(page);
-      html = await page.evaluate(() => document.documentElement?.outerHTML || "");
+      html = await page.evaluate(extractFn, extractArg);
     } else {
       throw err;
     }
   }
+
+  // If selector matched nothing, fall back to full page with a note
+  if (selector && html === null) {
+    logger.debug(`Selector "${selector}" matched no elements, falling back to full page`);
+    try {
+      html = await page.evaluate(() => document.documentElement?.outerHTML || "");
+    } catch (err) {
+      if (isNavigationError(err)) {
+        await waitForNavigationToSettle(page);
+        await waitForPageReady(page);
+        html = await page.evaluate(() => document.documentElement?.outerHTML || "");
+      } else {
+        throw err;
+      }
+    }
+    html = `<!-- selector "${selector}" matched no elements; returning full page -->\n` + html;
+  }
   
   let processedHtml;
   if (removeUnnecessaryHTML) {
@@ -501,5 +530,12 @@ export async function extractAndProcessHtml(page, removeUnnecessaryHTML) {
     processedHtml = enrichHtml(html, page.url());
   }
   
+  // Warn when response is very large — the agent should use the selector parameter
+  // to scope extraction to a DOM subtree instead of fetching the entire page.
+  const htmlByteLength = new TextEncoder().encode(processedHtml).length;
+  if (htmlByteLength > 500_000) {
+    logger.warn(`Large HTML response (${(htmlByteLength / 1024).toFixed(0)}KB). Consider using the "selector" parameter to extract a specific DOM subtree instead of the full page.`);
+  }
+  
   return processedHtml;
 }

package/src/core/plugin-loader.js

@@ -302,7 +302,7 @@ export function getPluginNextSteps(url, html) {
 /**
  * Build the recommendedPlugins payload for structuredContent.
  * Returns full plugin metadata including action catalog with params,
- * so agents can call actions directly without needing plugin_info.
+ * so agents can call actions directly without needing browser_plugin_info.
  * @param {string} url - Current page URL
  * @param {string} html - Extracted page HTML
  * @returns {Array<{ plugin: string, recommendation: string, actions: Array, usage: string }>}
@@ -317,7 +317,7 @@ export function getRecommendedPlugins(url, html) {
       plugin: d.pluginName,
       recommendation: recommendationText,
       actions: info.actions || [],
-      usage: `plugin_action({ plugin: '${d.pluginName}', action: '<name>', params: {...} })`
+      usage: `browser_plugin_action({ plugin: '${d.pluginName}', action: '<name>', params: {...} })`
     };
   });
 }

package/src/core/responses.js

@@ -188,7 +188,7 @@ function getHttpStatusNextSteps(statusCode, url) {
     return [
       'Authentication may be required - try logging in first',
       'Check if you have permission to access this resource',
-      "Use MCPBrowser's fetch_webpage to navigate to the login page first"
+      "Use MCPBrowser's browser_fetch_webpage to navigate to the login page first"
     ];
   }
   
@@ -204,14 +204,14 @@ function getHttpStatusNextSteps(statusCode, url) {
     return [
       'Rate limit exceeded - wait a few minutes before retrying',
       'Reduce request frequency',
-      "Call MCPBrowser's fetch_webpage again after waiting"
+      "Call MCPBrowser's browser_fetch_webpage again after waiting"
     ];
   }
   
   if (statusCode >= 500 && statusCode < 600) {
     return [
       'The server is experiencing issues',
-      "Wait a moment and try again with MCPBrowser's fetch_webpage",
+      "Wait a moment and try again with MCPBrowser's browser_fetch_webpage",
       'Check if the service has a status page for outages'
     ];
   }
@@ -219,7 +219,7 @@ function getHttpStatusNextSteps(statusCode, url) {
   return [
     ...baseSteps,
     'Try again later if this is a temporary issue',
-    "Call MCPBrowser's fetch_webpage to retry the request"
+    "Call MCPBrowser's browser_fetch_webpage to retry the request"
   ];
 }
 

package/src/mcp-browser.js

@@ -86,10 +86,16 @@ async function main() {
 
   server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
 
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
     const { name, arguments: args } = request.params;
     const safeArgs = args || {};
     
+    // Enable MCP progress notifications for this request if the client sent a progressToken.
+    // Every logger.info() call during tool execution will automatically send a
+    // notifications/progress message so the agent sees real-time status updates.
+    const progressToken = extra?._meta?.progressToken;
+    logger.setProgressToken(progressToken);
+    
     let result;
     
     try {
@@ -104,47 +110,47 @@ async function main() {
         //   result = await handleAcceptEula(safeArgs);
         //   break;
           
-        case "fetch_webpage":
+        case "browser_fetch_webpage":
           result = await fetchPage(safeArgs);
           break;
 
-        case "execute_javascript":
+        case "browser_execute_javascript":
           result = await executeJavascript(safeArgs);
           break;
           
-        case "click_element":
+        case "browser_click_element":
           result = await clickElement(safeArgs);
           break;
           
-        case "type_text":
+        case "browser_type_text":
           result = await typeText(safeArgs);
           break;
           
-        case "close_tab":
+        case "browser_close_tab":
           result = await closeTab(safeArgs);
           break;
           
-        case "get_current_html":
+        case "browser_get_current_html":
           result = await getCurrentHtml(safeArgs);
           break;
           
-        case "take_screenshot":
+        case "browser_take_screenshot":
           result = await takeScreenshot(safeArgs);
           break;
           
-        case "scroll_page":
+        case "browser_scroll_page":
           result = await scrollPage(safeArgs);
           break;
 
-        case "navigate_history":
+        case "browser_navigate_history":
           result = await navigateHistory(safeArgs);
           break;
 
-        case "plugin_info":
+        case "browser_plugin_info":
           result = pluginInfo(safeArgs);
           break;
 
-        case "plugin_action":
+        case "browser_plugin_action":
           result = await pluginAction(safeArgs);
           break;
           
@@ -161,6 +167,8 @@ async function main() {
         `${name} failed: ${error.message}`,
         ['Check browser is installed', 'Try specifying browser parameter explicitly (chrome, edge, or brave)', 'Check MCP server logs for details']
       ).toMcpFormat();
+    } finally {
+      logger.clearProgressToken();
     }
     
     // Transform result into MCP-compliant response using instance method

package/src/plugins/_example/index.js

@@ -81,7 +81,7 @@ export function getActions() {
         }, limit);
 
         return new ExampleActionResponse(items, [
-          "Call plugin_action with action 'get_item_detail' to read a specific item"
+          "Call browser_plugin_action with action 'get_item_detail' to read a specific item"
         ]);
       }
     },
@@ -114,7 +114,7 @@ export function getActions() {
         }
 
         return new ExampleActionResponse(detail, [
-          "Use plugin_action with action 'list_items' to see all items"
+          "Use browser_plugin_action with action 'list_items' to see all items"
         ]);
       }
     }

package/src/plugins/gcal/actions/check-availability.js

@@ -85,7 +85,7 @@ export async function checkAvailability({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/create-event.js

@@ -47,7 +47,7 @@ export async function createEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/delete-event.js

@@ -44,7 +44,7 @@ export async function deleteEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/edit-event.js

@@ -51,7 +51,7 @@ export async function editEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/list-events.js

@@ -34,7 +34,7 @@ export async function listEvents({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/read-event.js

@@ -47,7 +47,7 @@ export async function readEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/rsvp-event.js

@@ -62,7 +62,7 @@ export async function rsvpEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/search-events.js

@@ -42,7 +42,7 @@ export async function searchEvents({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }