• browser_navigate - Autonomously navigate to any URL
• browser_click - Autonomous intelligent element clicking
• browser_type - Autonomous smart text input with submit options
• browser_snapshot - AI-optimized autonomous accessibility snapshots
• browser_wait_for - Autonomous intelligent waiting conditions

• browser_start_autonomous_crawl - Start intelligent BFS crawling with memory and reporting
• browser_configure_memory - Configure memory system with darbot-memory-mcp integration
• Built-in guardrail system for safe autonomous operation
• Comprehensive HTML reporting with screenshots and statistics

• browser_save_profile - Save complete browser session states with Edge profile context
• browser_switch_profile - Restore saved session states
• browser_list_profiles - List all saved session states with Edge/workspace context
• browser_delete_profile - Delete session states from storage

• browser_take_screenshot - Autonomous high-quality screenshots
• browser_pdf_save - Autonomous PDF generation from pages
• browser_file_upload - Autonomous file upload handling

• browser_tab_new - Autonomously open new tabs
• browser_tab_list - Autonomously get all open tabs
• browser_tab_select - Autonomously switch between tabs
• browser_tab_close - Autonomous clean tab management

• browser_generate_playwright_test - Autonomously auto-generate test code
• browser_console_messages - Autonomous debug with console access
• browser_network_requests - Autonomous network activity monitoring

Recommended: Use the VS Code Extension for automatic setup!

The Darbot Browser MCP Extension automatically handles all configuration:

1. Install from marketplace: Search "Darbot Browser MCP" in VS Code extensions
2. Auto-configuration: Extension prompts to enable MCP and configures the server
3. Start & Use: Use Command Palette → "Darbot Browser MCP: Start Server"
4. Chat with Copilot: Ask GitHub Copilot to "browse to example.com"

Manual CLI installation (if you prefer):

# For VS Code
code --add-mcp '{"name":"browser","command":"npx","args":["@darbotlabs/darbot-browser-mcp@latest"]}'

After installation, the Browser MCP server will be available for use with your GitHub Copilot agent in VS Code.

Click the button to install:

Or install manually:

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx @darbotlabs/darbot-browser-mcp. You can also verify config or add command like arguments via clicking Edit.

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@darbotlabs/darbot-browser-mcp@latest"
      ]
    }
  }
}

Follow Windsuff MCP documentation. Use following configuration:

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@darbotlabs/darbot-browser-mcp@latest"
      ]
    }
  }
}

Follow the MCP install guide, use following configuration:

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@darbotlabs/darbot-browser-mcp@latest"
      ]
    }
  }
}

Use the Claude Code CLI to add the Browser MCP server:

claude mcp add browser npx @darbotlabs/darbot-browser-mcp@latest

Open Qodo Gen chat panel in VSCode or IntelliJ → Connect more tools → + Add new MCP → Paste the following configuration:

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@darbotlabs/darbot-browser-mcp@latest"
      ]
    }
  }
}

Click Save.

{
  // Browser configuration
  browser?: {
    // Browser type to use (chromium, firefox, or webkit)
    browserName?: 'chromium' | 'firefox' | 'webkit';

    // Keep the browser profile in memory, do not save it to disk.
    isolated?: boolean;

    // Path to user data directory for browser profile persistence
    userDataDir?: string;

    // Browser launch options (see Playwright docs)
    // @see https://playwright.dev/docs/api/class-browsertype#browser-type-launch
    launchOptions?: {
      channel?: string;        // Browser channel (e.g. 'msedge')
      headless?: boolean;      // Run in headless mode
      executablePath?: string; // Path to browser executable
      // ... other Playwright launch options
    };

    // Browser context options
    // @see https://playwright.dev/docs/api/class-browser#browser-new-context
    contextOptions?: {
      viewport?: { width: number, height: number };
      // ... other Playwright context options
    };

    // CDP endpoint for connecting to existing browser
    cdpEndpoint?: string;

    // Remote Playwright server endpoint
    remoteEndpoint?: string;
  },

  // Server configuration
  server?: {
    port?: number;  // Port to listen on
    host?: string;  // Host to bind to (default: localhost)
  },

  // List of enabled capabilities
  capabilities?: Array<
    'core' |    // Core browser automation
    'tabs' |    // Tab management
    'pdf' |     // PDF generation
    'history' | // Browser history
    'wait' |    // Wait utilities
    'files' |   // File handling
    'install' | // Browser installation
    'testing'   // Testing
  >;

  // Enable vision mode (screenshots instead of accessibility snapshots)
  vision?: boolean;

  // Directory for output files
  outputDir?: string;

  // Network configuration
  network?: {
    // List of origins to allow the browser to request. Default is to allow all. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
    allowedOrigins?: string[];

    // List of origins to block the browser to request. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
    blockedOrigins?: string[];
  };
 
  /**
   * Do not send image responses to the client.
   */
  noImageResponses?: boolean;
}

NOTE: The Docker implementation only supports headless chromium at the moment.

{
  "mcpServers": {
    "playwright": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
    }
  }
}

You can build the Docker image yourself.

docker build -t mcr.microsoft.com/playwright/mcp .

import http from 'http';

import { createConnection } from '@darbotlabs/darbot-browser-mcp';
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';

http.createServer(async (req, res) => {
  // ...

  // Creates a headless Browser MCP server with SSE transport
  const connection = await createConnection({ browser: { launchOptions: { headless: true } } });
  const transport = new SSEServerTransport('/messages', res);
  await connection.sever.connect(transport);

  // ...
});

• browser_snapshot
  • Title: Autonomous page snapshot
  • Description: Autonomously capture a detailed accessibility snapshot of the current page for analysis. This provides structured page content better than a screenshot.
  • Parameters: None
  • Read-only: true

• browser_click
  • Title: Autonomous click
  • Description: Autonomously perform click interactions on web page elements
  • Parameters:
    • element (string): Human-readable element description used to obtain permission to interact with the element
    • ref (string): Exact target element reference from the page snapshot
    • doubleClick (boolean, optional): Whether to perform a double click instead of a single click
  • Read-only: false

• browser_drag
  • Title: Autonomous drag & drop
  • Description: Autonomously perform drag and drop operations between web page elements
  • Parameters:
    • startElement (string): Human-readable source element description used to obtain the permission to interact with the element
    • startRef (string): Exact source element reference from the page snapshot
    • endElement (string): Human-readable target element description used to obtain the permission to interact with the element
    • endRef (string): Exact target element reference from the page snapshot
  • Read-only: false

• browser_hover
  • Title: Autonomous hover
  • Description: Autonomously hover over specific elements on the web page
  • Parameters:
    • element (string): Human-readable element description used to obtain permission to interact with the element
    • ref (string): Exact target element reference from the page snapshot
  • Read-only: true

• browser_type
  • Title: Autonomous text input
  • Description: Autonomously type text into editable elements on the web page
  • Parameters:
    • element (string): Human-readable element description used to obtain permission to interact with the element
    • ref (string): Exact target element reference from the page snapshot
    • text (string): Text to type into the element
    • submit (boolean, optional): Whether to submit entered text (press Enter after)
    • slowly (boolean, optional): Whether to type one character at a time. Useful for triggering key handlers in the page. By default entire text is filled in at once.
  • Read-only: false

• browser_select_option
  • Title: Autonomous dropdown selection
  • Description: Autonomously select options in dropdown menus on the web page
  • Parameters:
    • element (string): Human-readable element description used to obtain permission to interact with the element
    • ref (string): Exact target element reference from the page snapshot
    • values (array): Array of values to select in the dropdown. This can be a single value or multiple values.
  • Read-only: false

• browser_press_key
  • Title: Autonomous keyboard input
  • Description: Autonomously press keys on the keyboard to interact with the web page
  • Parameters:
    • key (string): Name of the key to press or a character to generate, such as ArrowLeft or a
  • Read-only: false

• browser_wait_for
  • Title: Autonomous wait conditions
  • Description: Autonomously wait for specific conditions: text appearance, text disappearance, or time duration
  • Parameters:
    • time (number, optional): The time to wait in seconds
    • text (string, optional): The text to wait for
    • textGone (string, optional): The text to wait for to disappear
  • Read-only: true

• browser_file_upload
  • Title: Autonomous file upload
  • Description: Autonomously upload one or multiple files when a file chooser dialog appears
  • Parameters:
    • paths (array): The absolute paths to the files to upload. Can be a single file or multiple files.
  • Read-only: false

• browser_handle_dialog
  • Title: Autonomous dialog handling
  • Description: Autonomously handle browser dialog boxes (alerts, confirmations, prompts)
  • Parameters:
    • accept (boolean): Whether to accept the dialog.
    • promptText (string, optional): The text of the prompt in case of a prompt dialog.
  • Read-only: false

• browser_navigate
  • Title: Navigate to a URL
  • Description: Autonomously navigate the browser to any URL. Use this command to launch and direct the browser to websites.
  • Parameters:
    • url (string): The URL to navigate to
  • Read-only: false

• browser_navigate_back
  • Title: Go back
  • Description: Autonomously navigate back to the previous page in browser history
  • Parameters: None
  • Read-only: true

• browser_navigate_forward
  • Title: Go forward
  • Description: Autonomously navigate forward to the next page in browser history
  • Parameters: None
  • Read-only: true

• browser_take_screenshot
  • Title: Autonomous screenshot capture
  • Description: Autonomously take visual screenshots of the current page or specific elements. Use browser_snapshot for structured page data instead of visual screenshots.
  • Parameters:
    • raw (boolean, optional): Whether to return without compression (in PNG format). Default is false, which returns a JPEG image.
    • filename (string, optional): File name to save the screenshot to. Defaults to page-{timestamp}.{png|jpeg} if not specified.
    • element (string, optional): Human-readable element description used to obtain permission to screenshot the element. If not provided, the screenshot will be taken of viewport. If element is provided, ref must be provided too.
    • ref (string, optional): Exact target element reference from the page snapshot. If not provided, the screenshot will be taken of viewport. If ref is provided, element must be provided too.
  • Read-only: true

• browser_pdf_save
  • Title: Autonomous PDF generation
  • Description: Autonomously save the current web page as a PDF document for archival or sharing
  • Parameters:
    • filename (string, optional): File name to save the pdf to. Defaults to page-{timestamp}.pdf if not specified.
  • Read-only: true

• browser_network_requests
  • Title: Autonomous network monitoring
  • Description: Autonomously capture and analyze all network requests made since page load for debugging
  • Parameters: None
  • Read-only: true

• browser_console_messages
  • Title: Autonomous console monitoring
  • Description: Autonomously retrieve all browser console messages for debugging and analysis
  • Parameters: None
  • Read-only: true

• browser_install
  • Title: Autonomous browser installation
  • Description: Autonomously install the required browser engine specified in configuration. Use this to resolve browser installation errors.
  • Parameters: None
  • Read-only: false

• browser_close
  • Title: Autonomous browser closure
  • Description: Autonomously close the browser session and terminate all operations
  • Parameters: None
  • Read-only: true

• browser_resize
  • Title: Autonomous window resizing
  • Description: Autonomously resize the browser window to specific dimensions for optimal viewing
  • Parameters:
    • width (number): Width of the browser window
    • height (number): Height of the browser window
  • Read-only: true

• browser_tab_list
  • Title: Autonomous tab listing
  • Description: Autonomously list all open browser tabs and their current status
  • Parameters: None
  • Read-only: true

• browser_tab_new
  • Title: Autonomous new tab creation
  • Description: Autonomously open a new browser tab, optionally navigating to a specified URL
  • Parameters:
    • url (string, optional): The URL to navigate to in the new tab. If not provided, the new tab will be blank.
  • Read-only: true

• browser_tab_select
  • Title: Autonomous tab selection
  • Description: Autonomously select and switch to a specific browser tab by index
  • Parameters:
    • index (number): The index of the tab to select
  • Read-only: true

• browser_tab_close
  • Title: Autonomous tab closure
  • Description: Autonomously close a browser tab by index, or close the current tab if no index specified
  • Parameters:
    • index (number, optional): The index of the tab to close. Closes current tab if not provided.
  • Read-only: false

• browser_save_profile
  • Title: Save session state
  • Description: Save the current browser session state (cookies, localStorage, URL) for later restoration. Includes Edge profile and VS Code workspace context.
  • Parameters:
    • name (string): Name for the session state
    • description (string, optional): Optional description for the session state
  • Read-only: false

• browser_switch_profile
  • Title: Restore session state
  • Description: Restore a previously saved session state, including cookies, localStorage, and navigate to the saved URL
  • Parameters:
    • name (string): Name of the session state to restore
  • Read-only: false

• browser_list_profiles
  • Title: List session states
  • Description: List all saved Darbot session states with their Edge profile context and workspace information
  • Parameters: None
  • Read-only: true

• browser_delete_profile
  • Title: Delete session state
  • Description: Permanently delete a saved session state from storage
  • Parameters:
    • name (string): Name of the session state to delete
  • Read-only: false

• browser_generate_playwright_test
  • Title: Autonomous test generation
  • Description: Autonomously generate Playwright test code for browser automation scenarios and user workflows
  • Parameters:
    • name (string): The name of the test
    • description (string): The description of the test
    • steps (array): The steps of the test
  • Read-only: true

• browser_execute_intent
  • Title: AI-Native Intent Execution
  • Description: Execute browser automation using natural language descriptions with intelligent fallback strategies
  • Parameters:
    • description (string): Natural language description of what you want to accomplish
    • context (string, optional): Additional context about the current task or goal
    • fallback_strategy (string, optional): Strategy to use if primary action fails
    • auto_recover (boolean, optional): Whether to automatically recover from errors
  • Read-only: false

• browser_execute_workflow
  • Title: AI-Native Workflow Execution
  • Description: Execute predefined workflows for common automation patterns like GitHub issue management
  • Parameters:
    • intent (string): The workflow type (e.g., "github_issue_management", "code_review_workflow")
    • parameters (object): Parameters for the workflow execution
    • auto_recover (boolean, optional): Whether to automatically recover from step failures
    • validate_completion (boolean, optional): Whether to validate successful completion
  • Read-only: false

• browser_analyze_context
  • Title: AI-Native Context Analysis
  • Description: Analyze current page context and suggest intelligent next actions based on user patterns
  • Parameters:
    • include_suggestions (boolean, optional): Whether to include action suggestions
    • analyze_patterns (boolean, optional): Whether to analyze user behavior patterns
  • Read-only: true

• browser_start_autonomous_crawl
  • Title: Start Autonomous Crawling
  • Description: Start autonomous crawling session with BFS strategy, memory, and reporting
  • Parameters:
    • startUrl (string): Starting URL for autonomous crawling
    • goal (string, optional): Goal description for the crawling session
    • maxDepth (integer, optional): Maximum crawl depth
    • maxPages (integer, optional): Maximum pages to visit
    • timeoutMs (integer, optional): Session timeout in milliseconds
    • allowedDomains (array, optional): List of allowed domains (restricts crawling)
    • generateReport (boolean, optional): Generate HTML report at the end
    • takeScreenshots (boolean, optional): Take screenshots during crawling
    • memoryEnabled (boolean, optional): Enable memory system for state tracking
    • verbose (boolean, optional): Enable verbose logging
  • Read-only: false

• browser_configure_memory
  • Title: Configure Memory System
  • Description: Configure memory system for autonomous crawling (local or darbot-memory-mcp)
  • Parameters:
    • enabled (boolean, optional): Enable or disable memory system
    • connector (string, optional): Memory connector type
    • storagePath (string, optional): Local storage path (for local connector)
    • maxStates (integer, optional): Maximum states to store
    • endpoint (string, optional): Darbot Memory MCP endpoint URL
  • Read-only: false

• browser_scroll
  • Title: Autonomous page scrolling
  • Description: Autonomously scroll the page using mouse wheel. Positive deltaY scrolls down, negative scrolls up. Positive deltaX scrolls right, negative scrolls left.
  • Parameters:
    • deltaX (number, optional): Horizontal scroll amount in pixels. Positive scrolls right, negative scrolls left.
    • deltaY (number, optional): Vertical scroll amount in pixels. Positive scrolls down, negative scrolls up.
  • Read-only: true

• browser_scroll_to_element
  • Title: Autonomous scroll to element
  • Description: Autonomously scroll an element into view. Useful for revealing elements before interacting with them.
  • Parameters:
    • element (string): Human-readable element description for permission
    • ref (string): Exact target element reference from the page snapshot
  • Read-only: true

• browser_clock_install
  • Title: Autonomous clock installation
  • Description: Autonomously install fake clock to control time in the browser. Useful for testing time-dependent behavior like animations, timeouts, and scheduled tasks.
  • Parameters:
    • time (string, optional): Initial time to set in ISO 8601 format (e.g., "2024-02-02T08:00:00"). Defaults to current time if not specified.
  • Read-only: false

• browser_clock_fast_forward
  • Title: Autonomous time fast-forward
  • Description: Autonomously advance the fake clock time by a specified duration. Timers and animations will fire as if that time had passed.
  • Parameters:
    • milliseconds (number): Number of milliseconds to fast forward
  • Read-only: false

• browser_clock_pause
  • Title: Autonomous clock pause
  • Description: Autonomously pause the clock at a specific time. Time will stop until resumed.
  • Parameters:
    • time (string, optional): Time to pause at in ISO 8601 format. If not specified, pauses at current fake time.
  • Read-only: false

• browser_clock_resume
  • Title: Autonomous clock resume
  • Description: Autonomously resume the paused clock. Time will continue flowing from where it was paused.
  • Parameters: None
  • Read-only: false

• browser_clock_set_fixed_time
  • Title: Autonomous fixed time setting
  • Description: Autonomously set a fixed time that will be returned by Date.now() and new Date(). Time will not advance automatically.
  • Parameters:
    • time (string): Fixed time to set in ISO 8601 format (e.g., "2024-12-25T00:00:00")
  • Read-only: false

• browser_emulate_media
  • Title: Autonomous media emulation
  • Description: Autonomously emulate media features like color scheme, reduced motion, contrast preference, and media type for accessibility and responsive testing.
  • Parameters:
    • colorScheme (string, optional): Emulate color scheme preference: light, dark, no-preference, or null to reset
    • reducedMotion (string, optional): Emulate prefers-reduced-motion: reduce, no-preference, or null to reset
    • contrast (string, optional): Emulate prefers-contrast: more, less, no-preference, or null to reset
    • media (string, optional): Emulate media type: screen, print, or null to reset
    • forcedColors (string, optional): Emulate forced-colors: active, none, or null to reset
  • Read-only: true

• browser_emulate_geolocation
  • Title: Autonomous geolocation emulation
  • Description: Autonomously emulate a geographic location for location-based testing.
  • Parameters:
    • latitude (number): Latitude between -90 and 90
    • longitude (number): Longitude between -180 and 180
    • accuracy (number, optional): Accuracy in meters. Defaults to 0.
  • Read-only: false

• browser_emulate_timezone
  • Title: Autonomous timezone emulation
  • Description: Autonomously change the browser timezone for testing time-sensitive features.
  • Parameters:
    • timezoneId (string): Timezone ID (e.g., "America/New_York", "Europe/London", "Asia/Tokyo")
  • Read-only: false

• browser_console_filtered
  • Title: Autonomous filtered console
  • Description: Autonomously retrieve console messages filtered by type (log, error, warning, info, debug). Useful for focused debugging.
  • Parameters:
    • type (string, optional): Type of console messages to retrieve
    • limit (number, optional): Maximum number of messages to return
  • Read-only: true

• browser_performance_metrics
  • Title: Autonomous performance analysis
  • Description: Autonomously retrieve performance metrics including page load times, DOM content loaded, and other timing data.
  • Parameters: None
  • Read-only: true

• browser_save_storage_state
  • Title: Autonomous storage state saving
  • Description: Autonomously save browser storage state (cookies, localStorage, and optionally IndexedDB) to a file. Useful for persisting authentication and session state.
  • Parameters:
    • filename (string, optional): File name to save storage state to. Defaults to storage-state-{timestamp}.json
    • includeIndexedDB (boolean, optional): Whether to include IndexedDB contents (useful for Firebase Auth and similar apps)
  • Read-only: true

• browser_get_cookies
  • Title: Autonomous cookie retrieval
  • Description: Autonomously retrieve browser cookies, optionally filtered by URL or domain.
  • Parameters:
    • urls (array, optional): URLs to get cookies for. If not specified, returns all cookies.
  • Read-only: true

• browser_set_cookie
  • Title: Autonomous cookie setting
  • Description: Autonomously set a browser cookie.
  • Parameters:
    • name (string): Cookie name
    • value (string): Cookie value
    • url (string, optional): URL to associate the cookie with (either url or domain+path required)
    • domain (string, optional): Cookie domain
    • path (string, optional): Cookie path
    • expires (number, optional): Unix timestamp when the cookie expires
    • httpOnly (boolean, optional): Whether the cookie is HTTP-only
    • secure (boolean, optional): Whether the cookie requires HTTPS
    • sameSite (string, optional): SameSite attribute
  • Read-only: false

• browser_clear_cookies
  • Title: Autonomous cookie clearing
  • Description: Autonomously clear browser cookies, optionally filtered by name, domain, or path.
  • Parameters:
    • name (string, optional): Only clear cookies with this name
    • domain (string, optional): Only clear cookies for this domain
    • path (string, optional): Only clear cookies with this path
  • Read-only: false

• browser_get_local_storage
  • Title: Autonomous localStorage retrieval
  • Description: Autonomously retrieve all localStorage items for the current page.
  • Parameters: None
  • Read-only: true

• browser_set_local_storage
  • Title: Autonomous localStorage setting
  • Description: Autonomously set a localStorage item for the current page.
  • Parameters:
    • key (string): Storage key
    • value (string): Storage value
  • Read-only: false

• browser_screen_capture
  • Title: Take a screenshot
  • Description: Take a screenshot of the current page
  • Parameters: None
  • Read-only: true

• browser_screen_move_mouse
  • Title: Move mouse
  • Description: Move mouse to a given position
  • Parameters:
    • element (string): Human-readable element description used to obtain permission to interact with the element
    • x (number): X coordinate
    • y (number): Y coordinate
  • Read-only: true

• browser_screen_click
  • Title: Click
  • Description: Click left mouse button
  • Parameters:
    • element (string): Human-readable element description used to obtain permission to interact with the element
    • x (number): X coordinate
    • y (number): Y coordinate
  • Read-only: false

• browser_screen_drag
  • Title: Drag mouse
  • Description: Drag left mouse button
  • Parameters:
    • element (string): Human-readable element description used to obtain permission to interact with the element
    • startX (number): Start X coordinate
    • startY (number): Start Y coordinate
    • endX (number): End X coordinate
    • endY (number): End Y coordinate
  • Read-only: false

• browser_screen_type
  • Title: Type text
  • Description: Type text
  • Parameters:
    • text (string): Text to type into the element
    • submit (boolean, optional): Whether to submit entered text (press Enter after)
  • Read-only: false

• browser_press_key
  • Title: Autonomous keyboard input
  • Description: Autonomously press keys on the keyboard to interact with the web page
  • Parameters:
    • key (string): Name of the key to press or a character to generate, such as ArrowLeft or a
  • Read-only: false

• browser_wait_for
  • Title: Autonomous wait conditions
  • Description: Autonomously wait for specific conditions: text appearance, text disappearance, or time duration
  • Parameters:
    • time (number, optional): The time to wait in seconds
    • text (string, optional): The text to wait for
    • textGone (string, optional): The text to wait for to disappear
  • Read-only: true

• browser_file_upload
  • Title: Autonomous file upload
  • Description: Autonomously upload one or multiple files when a file chooser dialog appears
  • Parameters:
    • paths (array): The absolute paths to the files to upload. Can be a single file or multiple files.
  • Read-only: false

• browser_handle_dialog
  • Title: Autonomous dialog handling
  • Description: Autonomously handle browser dialog boxes (alerts, confirmations, prompts)
  • Parameters:
    • accept (boolean): Whether to accept the dialog.
    • promptText (string, optional): The text of the prompt in case of a prompt dialog.
  • Read-only: false