browser_network_requests

Instructions

Implementation Reference

• src/tools/browser_tools.js:1066-1110 (handler)

  Main handler function for browser_network_requests tool. Monitors network requests and responses on the current page, collecting URL, method, headers, postData, status, and timestamps into page._networkRequests array. Returns the list of collected requests/responses with a count.

  async function browserNetworkRequests() {
    try {
      const page = await getPage();
      
      // Set up request monitoring if not already done
      if (!page._networkRequests) {
        page._networkRequests = [];
        
        page.on('request', request => {
          page._networkRequests.push({
            url: request.url(),
            method: request.method(),
            headers: request.headers(),
            postData: request.postData(),
            timestamp: new Date().toISOString(),
            type: 'request'
          });
        });
        
        page.on('response', response => {
          page._networkRequests.push({
            url: response.url(),
            status: response.status(),
            statusText: response.statusText(),
            headers: response.headers(),
            timestamp: new Date().toISOString(),
            type: 'response'
          });
        });
      }
  
      return {
        success: true,
        requests: page._networkRequests || [],
        count: (page._networkRequests || []).length
      };
  
    } catch (error) {
      logger.error(`Error getting network requests: ${error.message}`);
      return {
        success: false,
        message: error.message
      };
    }
  }

• src/mcp/server.js:127-136 (registration)

  Registration of the browser_network_requests tool in the MCP tools list with a generated description.

  const browserExtras = [
    { n:'browser_navigate_back' }, { n:'browser_navigate_forward' }, { n:'browser_hover' }, { n:'browser_drag' },
    { n:'browser_select_option' }, { n:'browser_press_key' }, { n:'browser_snapshot' }, { n:'browser_console_messages' },
    { n:'browser_network_requests' }, { n:'browser_tab_list' }, { n:'browser_tab_new' }, { n:'browser_tab_select' },
    { n:'browser_tab_close' }, { n:'browser_file_upload' }, { n:'browser_wait' }, { n:'browser_wait_for' },
    { n:'browser_resize' }, { n:'browser_handle_dialog' }
  ];
  for (const b of browserExtras) {
    tools.push({ name: b.n, description: b.n.replace(/_/g,' '), inputSchema: { type:'object', properties:{} } });
  }

• src/mcp/server.js:296-296 (registration)

  Dispatch case for browser_network_requests, calling browserTools.browserNetworkRequests() and returning the data.

  case 'browser_network_requests': data = await browserTools.browserNetworkRequests(); break;

• src/tools/browser_tools.js:1127-1162 (helper)

  Module export exposing browserNetworkRequests as part of the browserTools API.

  module.exports = {
    // Navigation
    browserNavigate,
    browserNavigateBack,
    browserNavigateForward,
    
    // Interaction
    browserClick,
    browserType,
    browserHover,
    browserDrag,
    browserSelectOption,
    browserPressKey,
    
    // Capture
    browserTakeScreenshot,
    browserSnapshot,
    browserPdfSave,
    
    // Tab management
    browserTabList,
    browserTabNew,
    browserTabSelect,
    browserTabClose,
    
    // Utilities
    browserConsoleMessages,
    browserFileUpload,
    browserWait,
    browserWaitFor,
    browserResize,
    browserHandleDialog,
    browserClose,
    browserInstall,
    browserNetworkRequests
  };