mcpbrowser 0.3.44 → 0.3.45

package/src/actions/get-current-html.js

@@ -17,7 +17,7 @@ import { getPluginNextSteps, getRecommendedPlugins } from '../core/plugin-loader
 // ============================================================================
 
 /**
- * Response for successful get_current_html operations
+ * Response for successful browser_get_current_html operations
  */
 export class GetCurrentHtmlSuccessResponse extends MCPResponse {
   /**
@@ -62,9 +62,9 @@ export class GetCurrentHtmlSuccessResponse extends MCPResponse {
  * @type {Tool}
  */
 export const GET_CURRENT_HTML_TOOL = {
-  name: "get_current_html",
+  name: "browser_get_current_html",
   title: "Get Current HTML",
-  description: "**BROWSER STATE EXTRACTION** - Retrieves current HTML from an already-loaded page WITHOUT navigating/reloading. Use this to check page state after interactions (click, type) or to re-examine the current page. Much faster than fetch_webpage since it only extracts HTML from the current page state.\n\n**PREREQUISITE**: Page MUST be loaded with fetch_webpage first. This tool reads from an already-loaded page in the browser.",
+  description: "**BROWSER STATE EXTRACTION** - Retrieves current HTML from an already-loaded page WITHOUT navigating/reloading. Use this to check page state after interactions (click, type) or to re-examine the current page. Much faster than browser_fetch_webpage since it only extracts HTML from the current page state.\n\n**PREREQUISITE**: Page MUST be loaded with browser_fetch_webpage first. This tool reads from an already-loaded page in the browser.",
   inputSchema: {
     type: "object",
     properties: {
@@ -109,7 +109,7 @@ export const GET_CURRENT_HTML_TOOL = {
  */
 export async function getCurrentHtml({ url, removeUnnecessaryHTML = true }) {
   const startTime = Date.now();
-  logger.info(`get_current_html called: url=${url}`);
+  logger.info(`browser_get_current_html called: url=${url}`);
   
   if (!url) {
     throw new Error("url parameter is required");
@@ -126,7 +126,7 @@ export async function getCurrentHtml({ url, removeUnnecessaryHTML = true }) {
   try {
     await getBrowser();
   } catch (err) {
-    logger.error(`get_current_html: Failed to connect to browser: ${err.message}`);
+    logger.error(`browser_get_current_html: Failed to connect to browser: ${err.message}`);
     return new InformationalResponse(
       `Browser connection failed: ${err.message}`,
       'The browser must be running with remote debugging enabled.',
@@ -143,15 +143,15 @@ export async function getCurrentHtml({ url, removeUnnecessaryHTML = true }) {
   
   if (!page) {
     const isConnectionLost = pageError && pageError.includes('connection');
-    logger.debug(`get_current_html: ${pageError || 'No page found for ' + hostname}`);
+    logger.debug(`browser_get_current_html: ${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 get its current HTML',
       [
-        "Use MCPBrowser's fetch_webpage tool to load the page first",
-        "Then retry MCPBrowser's get_current_html with the same URL"
+        "Use MCPBrowser's browser_fetch_webpage tool to load the page first",
+        "Then retry MCPBrowser's browser_get_current_html with the same URL"
       ]
     );
   }
@@ -160,28 +160,28 @@ export async function getCurrentHtml({ url, removeUnnecessaryHTML = true }) {
     const currentUrl = page.url();
     const html = await extractAndProcessHtml(page, removeUnnecessaryHTML);
     
-    logger.info(`get_current_html completed: got HTML from ${currentUrl}`);
+    logger.info(`browser_get_current_html completed: got HTML from ${currentUrl}`);
     
     return new GetCurrentHtmlSuccessResponse(
       currentUrl,
       html,
       [
         ...getPluginNextSteps(currentUrl, html),
-        "Use MCPBrowser's click_element to interact with elements",
-        "Use MCPBrowser's type_text to fill forms",
-        "Use MCPBrowser's take_screenshot if page layout or visual content is hard to understand from HTML",
-        "Use MCPBrowser's close_tab to free resources when done"
+        "Use MCPBrowser's browser_click_element to interact with elements",
+        "Use MCPBrowser's browser_type_text to fill forms",
+        "Use MCPBrowser's browser_take_screenshot if page layout or visual content is hard to understand from HTML",
+        "Use MCPBrowser's browser_close_tab to free resources when done"
       ],
       getRecommendedPlugins(currentUrl, html)
     );
   } catch (err) {
-    logger.error(`get_current_html failed: ${err.message}`);
+    logger.error(`browser_get_current_html failed: ${err.message}`);
     return new InformationalResponse(
       `Failed to get HTML: ${err.message}`,
       'Could not extract HTML 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/navigate-history.js

@@ -17,7 +17,7 @@ import logger from '../core/logger.js';
 // ============================================================================
 
 /**
- * Response for successful navigate_history operations
+ * Response for successful browser_navigate_history operations
  */
 export class NavigateHistorySuccessResponse extends MCPResponse {
   /**
@@ -69,9 +69,9 @@ export class NavigateHistorySuccessResponse extends MCPResponse {
 
 /** @type {Tool} */
 export const NAVIGATE_HISTORY_TOOL = {
-  name: "navigate_history",
+  name: "browser_navigate_history",
   title: "Navigate Back/Forward",
-  description: "**BROWSER HISTORY NAVIGATION** - Navigate back or forward in browser history on an already-loaded page. Use after clicking links to return to the previous page, or to go forward after going back.\n\n**PREREQUISITE**: Page MUST be loaded with fetch_webpage first. This tool navigates the history of an existing browser tab.",
+  description: "**BROWSER HISTORY NAVIGATION** - Navigate back or forward in browser history on an already-loaded page. Use after clicking links to return to the previous page, or to go forward after going back.\n\n**PREREQUISITE**: Page MUST be loaded with browser_fetch_webpage first. This tool navigates the history of an existing browser tab.",
   inputSchema: {
     type: "object",
     properties: {
@@ -126,7 +126,7 @@ export const NAVIGATE_HISTORY_TOOL = {
  * @returns {Promise<MCPResponse>} Navigation result
  */
 export async function navigateHistory({ url, direction = 'back', returnHtml = true, removeUnnecessaryHTML = true }) {
-  logger.info(`navigate_history called: url=${url}, direction=${direction}`);
+  logger.info(`browser_navigate_history called: url=${url}, direction=${direction}`);
 
   if (!url) {
     throw new Error("url parameter is required");
@@ -143,7 +143,7 @@ export async function navigateHistory({ url, direction = 'back', returnHtml = tr
   try {
     await getBrowser();
   } catch (err) {
-    logger.error(`navigate_history: Failed to connect to browser: ${err.message}`);
+    logger.error(`browser_navigate_history: Failed to connect to browser: ${err.message}`);
     return new InformationalResponse(
       `Browser connection failed: ${err.message}`,
       'The browser must be running with remote debugging enabled.',
@@ -160,15 +160,15 @@ export async function navigateHistory({ url, direction = 'back', returnHtml = tr
 
   if (!page) {
     const isConnectionLost = pageError && pageError.includes('connection');
-    logger.debug(`navigate_history: ${pageError || 'No page found for ' + hostname}`);
+    logger.debug(`browser_navigate_history: ${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 navigate its history.',
       [
-        "Use MCPBrowser's fetch_webpage tool to load the page first",
-        "Then retry MCPBrowser's navigate_history with the same URL"
+        "Use MCPBrowser's browser_fetch_webpage tool to load the page first",
+        "Then retry MCPBrowser's browser_navigate_history with the same URL"
       ]
     );
   }
@@ -186,15 +186,15 @@ export async function navigateHistory({ url, direction = 'back', returnHtml = tr
 
     // goBack/goForward return null if there's no history entry
     if (response === null) {
-      logger.info(`navigate_history: No ${direction} history entry available`);
+      logger.info(`browser_navigate_history: No ${direction} history entry available`);
       return new InformationalResponse(
         `No ${direction} history entry available`,
         `The page has no ${direction} history to navigate to. This means you're already at the ${direction === 'back' ? 'first' : 'last'} page in the browsing history for this tab.`,
         [
           direction === 'back'
-            ? "Use MCPBrowser's fetch_webpage to navigate to a different URL"
-            : "Use MCPBrowser's navigate_history with direction='back' to go back instead",
-          "Use MCPBrowser's get_current_html to check the current page content"
+            ? "Use MCPBrowser's browser_fetch_webpage to navigate to a different URL"
+            : "Use MCPBrowser's browser_navigate_history with direction='back' to go back instead",
+          "Use MCPBrowser's browser_get_current_html to check the current page content"
         ]
       );
     }
@@ -207,7 +207,7 @@ export async function navigateHistory({ url, direction = 'back', returnHtml = tr
       if (newHostname !== hostname) {
         domainPages.delete(hostname);
         domainPages.set(newHostname, page);
-        logger.info(`navigate_history: Updated domainPages mapping: ${hostname} → ${newHostname}`);
+        logger.info(`browser_navigate_history: Updated domainPages mapping: ${hostname} → ${newHostname}`);
       }
     } catch {
       // If URL parsing fails, keep existing mapping
@@ -220,7 +220,7 @@ export async function navigateHistory({ url, direction = 'back', returnHtml = tr
       html = await extractAndProcessHtml(page, removeUnnecessaryHTML);
     }
 
-    logger.info(`navigate_history completed: ${direction} from ${previousUrl} to ${currentUrl}`);
+    logger.info(`browser_navigate_history completed: ${direction} from ${previousUrl} to ${currentUrl}`);
 
     return new NavigateHistorySuccessResponse(
       direction,
@@ -228,20 +228,20 @@ export async function navigateHistory({ url, direction = 'back', returnHtml = tr
       currentUrl,
       html,
       [
-        "Use MCPBrowser's navigate_history to go back or forward again",
-        "Use MCPBrowser's click_element to interact with elements on the page",
-        "Use MCPBrowser's get_current_html to re-read the page content",
-        "Use MCPBrowser's fetch_webpage to navigate to a new URL"
+        "Use MCPBrowser's browser_navigate_history to go back or forward again",
+        "Use MCPBrowser's browser_click_element to interact with elements on the page",
+        "Use MCPBrowser's browser_get_current_html to re-read the page content",
+        "Use MCPBrowser's browser_fetch_webpage to navigate to a new URL"
       ]
     );
   } catch (err) {
-    logger.error(`navigate_history failed: ${err.message}`);
+    logger.error(`browser_navigate_history failed: ${err.message}`);
     return new InformationalResponse(
       `Navigation ${direction} failed: ${err.message}`,
       'The browser could not navigate. The page may have been closed 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/plugin-action.js

@@ -2,7 +2,7 @@
  * plugin-action.js — MCP tool that dispatches to a plugin's action.
  * Looks up the plugin by name, finds the action, provides the browser
  * page object, and calls the action's execute function.
- * Part of the plugin dispatch pair (plugin_info + plugin_action).
+ * Part of the plugin dispatch pair (browser_plugin_info + browser_plugin_action).
  */
 
 import { MCPResponse, ErrorResponse } from '../core/responses.js';
@@ -36,9 +36,9 @@ export class PluginActionSuccessResponse extends MCPResponse {
 
 /** @type {Tool} */
 export const PLUGIN_ACTION_TOOL = {
-  name: "plugin_action",
+  name: "browser_plugin_action",
   title: "Plugin Action",
-  description: "Execute a site-specific plugin action. Use plugin_info first to discover available actions and their parameters. Plugins provide specialized automation for UI-heavy websites like Gmail, Outlook, PowerBI, AWS, and Azure — faster and more reliable than generic DOM interaction.",
+  description: "Execute a site-specific plugin action. Use browser_plugin_info first to discover available actions and their parameters. Plugins provide specialized automation for UI-heavy websites like Gmail, Outlook, PowerBI, AWS, and Azure — faster and more reliable than generic DOM interaction.",
   inputSchema: {
     type: "object",
     properties: {
@@ -52,7 +52,7 @@ export const PLUGIN_ACTION_TOOL = {
       },
       params: {
         type: "object",
-        description: "Action parameters. Use plugin_info to discover accepted parameters.",
+        description: "Action parameters. Use browser_plugin_info to discover accepted parameters.",
         additionalProperties: true
       }
     },
@@ -86,7 +86,7 @@ export const PLUGIN_ACTION_TOOL = {
  * @returns {Promise<MCPResponse>}
  */
 export async function pluginAction({ plugin: pluginName, action: actionName, params = {} }) {
-  logger.info(`plugin_action called: plugin=${pluginName} action=${actionName}`);
+  logger.info(`browser_plugin_action called: plugin=${pluginName} action=${actionName}`);
 
   const loadedPlugins = getLoadedPlugins();
 
@@ -96,7 +96,7 @@ export async function pluginAction({ plugin: pluginName, action: actionName, par
     const available = [...loadedPlugins.keys()].join(', ') || '(none)';
     return new ErrorResponse(
       `Unknown plugin: '${pluginName}'. Available plugins: ${available}`,
-      ["Call plugin_info() to list all loaded plugins"]
+      ["Call browser_plugin_info() to list all loaded plugins"]
     );
   }
 
@@ -107,7 +107,7 @@ export async function pluginAction({ plugin: pluginName, action: actionName, par
     const validActions = actions.map(a => a.name).join(', ');
     return new ErrorResponse(
       `Unknown action '${actionName}' for plugin '${pluginName}'. Available actions: ${validActions}`,
-      [`Call plugin_info({ plugin: '${pluginName}' }) to see all available actions and their parameters`]
+      [`Call browser_plugin_info({ plugin: '${pluginName}' }) to see all available actions and their parameters`]
     );
   }
 
@@ -136,17 +136,17 @@ export async function pluginAction({ plugin: pluginName, action: actionName, par
     if (!matchedPage) {
       const targetPatterns = pluginInstance.manifest.urlPatterns.join(', ');
       return new ErrorResponse(
-        `Plugin '${pluginName}' requires ${targetPatterns} but no matching page is open. Use fetch_webpage to navigate to the correct site first.`,
-        [`Use MCPBrowser's fetch_webpage to navigate to a page matching: ${targetPatterns}`, `Then retry plugin_action`]
+        `Plugin '${pluginName}' requires ${targetPatterns} but no matching page is open. Use browser_fetch_webpage to navigate to the correct site first.`,
+        [`Use MCPBrowser's browser_fetch_webpage to navigate to a page matching: ${targetPatterns}`, `Then retry browser_plugin_action`]
       );
     }
     
     page = matchedPage;
   } catch (err) {
-    logger.error(`plugin_action: browser error — ${err.message}`);
+    logger.error(`browser_plugin_action: browser error — ${err.message}`);
     return new ErrorResponse(
       `Browser connection failed: ${err.message}`,
-      ["Ensure the browser is running with remote debugging enabled", "Retry plugin_action after browser is connected"]
+      ["Ensure the browser is running with remote debugging enabled", "Retry browser_plugin_action after browser is connected"]
     );
   }
 
@@ -164,15 +164,15 @@ export async function pluginAction({ plugin: pluginName, action: actionName, par
       pluginName,
       actionName,
       result,
-      [`Use plugin_info({ plugin: '${pluginName}' }) to see other available actions`]
+      [`Use browser_plugin_info({ plugin: '${pluginName}' }) to see other available actions`]
     );
   } catch (err) {
-    logger.error(`plugin_action: "${pluginName}/${actionName}" failed — ${err.message}`);
+    logger.error(`browser_plugin_action: "${pluginName}/${actionName}" failed — ${err.message}`);
     return new ErrorResponse(
-      `Plugin '${pluginName}' action '${actionName}' failed: ${err.message}. The site structure may have changed. You can fall back to generic MCPBrowser tools (click_element, get_current_html).`,
+      `Plugin '${pluginName}' action '${actionName}' failed: ${err.message}. The site structure may have changed. You can fall back to generic MCPBrowser tools (browser_click_element, browser_get_current_html).`,
       [
         "Check if the page is on the correct site",
-        "Try MCPBrowser's get_current_html to inspect the page state",
+        "Try MCPBrowser's browser_get_current_html to inspect the page state",
         "Use generic MCPBrowser tools as a fallback"
       ]
     );

package/src/actions/plugin-info.js

@@ -1,7 +1,7 @@
 /**
  * plugin-info.js — MCP tool that returns information about installed plugins,
  * their available actions, parameters, and high-level site context.
- * Part of the plugin dispatch pair (plugin_info + plugin_action).
+ * Part of the plugin dispatch pair (browser_plugin_info + browser_plugin_action).
  */
 
 import { MCPResponse, ErrorResponse } from '../core/responses.js';
@@ -53,9 +53,9 @@ export class PluginActionDetailResponse extends MCPResponse {
 
 /** @type {Tool} */
 export const PLUGIN_INFO_TOOL = {
-  name: "plugin_info",
+  name: "browser_plugin_info",
   title: "Plugin Info",
-  description: "Get information about an installed site plugin — its available actions, parameters, and site context. Call this after a plugin is detected (recommended in nextSteps) to discover what actions you can perform via plugin_action. You can also call with no arguments to list all loaded plugins.",
+  description: "Get information about an installed site plugin — its available actions, parameters, and site context. Call this after a plugin is detected (recommended in nextSteps) to discover what actions you can perform via browser_plugin_action. You can also call with no arguments to list all loaded plugins.",
   inputSchema: {
     type: "object",
     properties: {
@@ -96,7 +96,7 @@ export const PLUGIN_INFO_TOOL = {
  * @returns {MCPResponse}
  */
 export function pluginInfo({ plugin, action } = {}) {
-  logger.info(`plugin_info called: plugin=${plugin || '(all)'} action=${action || '(all)'}`);
+  logger.info(`browser_plugin_info called: plugin=${plugin || '(all)'} action=${action || '(all)'}`);
 
   const loadedPlugins = getLoadedPlugins();
 
@@ -112,7 +112,7 @@ export function pluginInfo({ plugin, action } = {}) {
     }
 
     const nextSteps = plugins.length > 0
-      ? plugins.map(p => `Call plugin_info({ plugin: '${p.name}' }) to see ${p.name}'s available actions`)
+      ? plugins.map(p => `Call browser_plugin_info({ plugin: '${p.name}' }) to see ${p.name}'s available actions`)
       : ["No plugins are currently loaded. Add plugin names to plugins.json and restart the server."];
 
     return new PluginListResponse(plugins, nextSteps);
@@ -125,7 +125,7 @@ export function pluginInfo({ plugin, action } = {}) {
     return new ErrorResponse(
       `Unknown plugin: '${plugin}'. Available plugins: ${available}`,
       loadedPlugins.size > 0
-        ? [`Call plugin_info() with no arguments to list all plugins`]
+        ? [`Call browser_plugin_info() with no arguments to list all plugins`]
         : ["No plugins are currently loaded. Add plugin names to plugins.json and restart the server."]
     );
   }
@@ -138,14 +138,14 @@ export function pluginInfo({ plugin, action } = {}) {
       const validActions = actions.map(a => a.name).join(', ');
       return new ErrorResponse(
         `Unknown action '${action}' for plugin '${plugin}'. Available actions: ${validActions}`,
-        [`Call plugin_info({ plugin: '${plugin}' }) to see all available actions`]
+        [`Call browser_plugin_info({ plugin: '${plugin}' }) to see all available actions`]
       );
     }
 
     return new PluginActionDetailResponse(
       plugin,
       { name: actionDef.name, description: actionDef.description, params: actionDef.params },
-      [`Call plugin_action({ plugin: '${plugin}', action: '${action}', params: { ... } })`]
+      [`Call browser_plugin_action({ plugin: '${plugin}', action: '${action}', params: { ... } })`]
     );
   }
 
@@ -161,9 +161,9 @@ export function pluginInfo({ plugin, action } = {}) {
 
   const nextSteps = [
     ...(info.actions || []).slice(0, 3).map(a =>
-      `Use plugin_action({ plugin: '${plugin}', action: '${a.name}' }) to ${a.description.toLowerCase()}`
+      `Use browser_plugin_action({ plugin: '${plugin}', action: '${a.name}' }) to ${a.description.toLowerCase()}`
     ),
-    "Use fetch_webpage to navigate to the target site first if not already there"
+    "Use browser_fetch_webpage to navigate to the target site first if not already there"
   ];
 
   return new PluginInfoResponse(pluginDetail, nextSteps);

package/src/actions/scroll-page.js

@@ -16,7 +16,7 @@ import logger from '../core/logger.js';
 // ============================================================================
 
 /**
- * Response for successful scroll_page operations
+ * Response for successful browser_scroll_page operations
  * Returns scroll result with new scroll position
  */
 export class ScrollPageSuccessResponse extends MCPResponse {
@@ -92,9 +92,9 @@ export class ScrollPageSuccessResponse extends MCPResponse {
  * @type {Tool}
  */
 export const SCROLL_PAGE_TOOL = {
-  name: "scroll_page",
+  name: "browser_scroll_page",
   title: "Scroll Page",
-  description: "**PAGE NAVIGATION** - Scrolls within an already-loaded page. Use before take_screenshot to capture different parts of the page, or to bring elements into view before interaction.\n\n**PREREQUISITE**: Page MUST be loaded with fetch_webpage first.\n\n**SCROLL MODES**:\n- By direction: Scroll up/down/left/right by pixel amount\n- To element: Scroll until a specific element is visible\n- To position: Scroll to absolute coordinates",
+  description: "**PAGE NAVIGATION** - Scrolls within an already-loaded page. Use before browser_take_screenshot to capture different parts of the page, or to bring elements into view before interaction.\n\n**PREREQUISITE**: Page MUST be loaded with browser_fetch_webpage first.\n\n**SCROLL MODES**:\n- By direction: Scroll up/down/left/right by pixel amount\n- To element: Scroll until a specific element is visible\n- To position: Scroll to absolute coordinates",
   inputSchema: {
     type: "object",
     properties: {
@@ -166,7 +166,7 @@ export const SCROLL_PAGE_TOOL = {
  * @returns {Promise<Object>} Result object with scroll position data
  */
 export async function scrollPage({ url, direction, amount = 500, selector, x, y }) {
-  logger.info(`scroll_page called: url=${url}, direction=${direction}, amount=${amount}, selector=${selector}, x=${x}, y=${y}`);
+  logger.info(`browser_scroll_page called: url=${url}, direction=${direction}, amount=${amount}, selector=${selector}, x=${x}, y=${y}`);
   
   if (!url) {
     throw new Error("url parameter is required");
@@ -183,7 +183,7 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
   try {
     await getBrowser();
   } catch (err) {
-    logger.error(`scroll_page: Failed to connect to browser: ${err.message}`);
+    logger.error(`browser_scroll_page: Failed to connect to browser: ${err.message}`);
     return new InformationalResponse(
       `Browser connection failed: ${err.message}`,
       'The browser must be running with remote debugging enabled.',
@@ -200,15 +200,15 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
   
   if (!page) {
     const isConnectionLost = pageError && pageError.includes('connection');
-    logger.debug(`scroll_page: ${pageError || 'No page found for ' + hostname}`);
+    logger.debug(`browser_scroll_page: ${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 scroll',
       [
-        "Use MCPBrowser's fetch_webpage tool to load the page first",
-        "Then retry MCPBrowser's scroll_page with the same URL"
+        "Use MCPBrowser's browser_fetch_webpage tool to load the page first",
+        "Then retry MCPBrowser's browser_scroll_page with the same URL"
       ]
     );
   }
@@ -219,7 +219,7 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
     // Determine scroll mode and execute
     if (selector) {
       // Scroll to element mode
-      logger.debug(`scroll_page: Scrolling to element: ${selector}`);
+      logger.debug(`browser_scroll_page: Scrolling to element: ${selector}`);
       
       const elementExists = await page.$(selector);
       if (!elementExists) {
@@ -227,7 +227,7 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
           `Element not found: ${selector}`,
           'The specified CSS selector did not match any element on the page.',
           [
-            "Use MCPBrowser's get_current_html to inspect the page structure",
+            "Use MCPBrowser's browser_get_current_html to inspect the page structure",
             "Verify the CSS selector is correct",
             "Try a different selector"
           ]
@@ -243,7 +243,7 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
       
     } else if (typeof x === 'number' && typeof y === 'number') {
       // Absolute position mode
-      logger.debug(`scroll_page: Scrolling to absolute position: (${x}, ${y})`);
+      logger.debug(`browser_scroll_page: Scrolling to absolute position: (${x}, ${y})`);
       
       await page.evaluate(({ scrollX, scrollY }) => {
         window.scrollTo(scrollX, scrollY);
@@ -251,7 +251,7 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
       
     } else if (direction) {
       // Directional scroll mode
-      logger.debug(`scroll_page: Scrolling ${direction} by ${amount}px`);
+      logger.debug(`browser_scroll_page: Scrolling ${direction} by ${amount}px`);
       
       const scrollDeltas = {
         up: { x: 0, y: -amount },
@@ -271,7 +271,7 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
       
     } else {
       // No scroll parameters provided - just return current position
-      logger.debug(`scroll_page: No scroll action specified, returning current position`);
+      logger.debug(`browser_scroll_page: No scroll action specified, returning current position`);
     }
     
     // Small delay to let scroll complete
@@ -287,7 +287,7 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
       viewportHeight: window.innerHeight
     }));
     
-    logger.info(`scroll_page completed: position=(${scrollInfo.scrollX}, ${scrollInfo.scrollY}), page=(${scrollInfo.pageWidth}x${scrollInfo.pageHeight})`);
+    logger.info(`browser_scroll_page completed: position=(${scrollInfo.scrollX}, ${scrollInfo.scrollY}), page=(${scrollInfo.pageWidth}x${scrollInfo.pageHeight})`);
     
     return new ScrollPageSuccessResponse(
       currentUrl,
@@ -298,20 +298,20 @@ export async function scrollPage({ url, direction, amount = 500, selector, x, y
       scrollInfo.viewportWidth,
       scrollInfo.viewportHeight,
       [
-        "Use MCPBrowser's take_screenshot to capture the current view",
-        "Use MCPBrowser's scroll_page again to navigate further",
-        "Use MCPBrowser's click_element to interact with visible elements",
-        "Use MCPBrowser's get_current_html to get the page content"
+        "Use MCPBrowser's browser_take_screenshot to capture the current view",
+        "Use MCPBrowser's browser_scroll_page again to navigate further",
+        "Use MCPBrowser's browser_click_element to interact with visible elements",
+        "Use MCPBrowser's browser_get_current_html to get the page content"
       ]
     );
   } catch (err) {
-    logger.error(`scroll_page failed: ${err.message}`);
+    logger.error(`browser_scroll_page failed: ${err.message}`);
     return new InformationalResponse(
       `Failed to scroll page: ${err.message}`,
       'Could not scroll 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/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"
       ]
     );
   }