Description of how to use the server

Creates a new browser context with an auto-generated unique ID

Lists all active browser instances

Closes a specific browser instance

Gets detailed information about a specific browser instance

Gets usage statistics for browsers

Retrieves recent HMR events

Captures a screenshot of the current page or a specific element. Stores the screenshot in the MCP resource system and returns a resource URI. If ENABLE_BASE64 environment variable is set to 'true', also includes base64 encoded image in the response.

Retrieves properties and state information of a specific element

Retrieves style information of a specific element

Retrieves dimension and position information of a specific element

Monitors network requests in the browser for a specified duration

Retrieves the HTML content of a specific element and its children with optional depth control

Retrieves console logs from the development server

Executes a sequence of predefined browser commands safely. Available commands:

• click: Clicks on an element matching the selector or at specified coordinates

• type: Types text into an input element

• wait: Waits for an element, a specified time period, or a condition

• navigate: Navigates to a specified URL

• select: Selects an option in a dropdown

• check: Checks or unchecks a checkbox

• hover: Hovers over an element

• focus: Focuses an element

• blur: Removes focus from an element

• keypress: Simulates pressing a keyboard key

• scroll: Scrolls the page or an element

• getAttribute: Gets an attribute value from an element

• getProperty: Gets a property value from an element

• drag: Performs a drag operation from one position to another

• refresh: Refreshes the current page

Note on coordinates: For all mouse-related commands (click, drag, etc.), coordinates are relative to the browser viewport where (0,0) is the top-left corner. X increases to the right, Y increases downward.

Examples are available in the schema definition.

Evaluates JavaScript code directly in the browser context and returns the result. Supports expressions, function strings, and complex code with automatic execution handling. Can target the entire page or work with element handles for precise DOM manipulation.

Examples:

• Simple expression: "document.title"

• Arrow function: "() => document.querySelectorAll('a').length"

• Regular function: "function() { return document.body.children.length; }"

• Function with arguments: "(tag) => document.getElementsByTagName(tag).length"

• Complex code: "() => { const divs = document.querySelectorAll('div'); return { count: divs.length, hasClass: divs[0]?.className }; }"

• Async function: "async () => { const res = await fetch('/api'); return res.json(); }"