Inspect page
Inspect page — MCP tools exposed to agents.
17 tools in this group.
browser_a11y_tree
Get the accessibility tree of the current page. Returns a tree of ARIA roles, names, and states — useful for understanding page structure without visual rendering.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
everything | boolean | no | false | Show all nodes including generic containers. Default: false |
browser_count
Count the number of elements matching a CSS selector
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector to count matches for |
browser_find
Find an element and return its info (tag, text, bounding box). Use a CSS selector or a semantic locator (role, text, label, placeholder, testid, xpath, alt, title). Combine role with text or other locators to narrow results.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
alt | string | no | Find element by alt attribute | |
label | string | no | Find input by associated label text or aria-label | |
placeholder | string | no | Find element by placeholder attribute | |
role | string | no | ARIA role to match (e.g., "button", "link", "textbox", "heading", "checkbox") | |
selector | string | no | CSS selector for the element to find | |
testid | string | no | Find element by data-testid attribute | |
text | string | no | Find element containing this text | |
title | string | no | Find element by title attribute | |
xpath | string | no | Find element by XPath expression |
browser_find_all
Find all elements matching a CSS selector and return their info (tag, text, bounding box)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | no | 10 | Maximum number of elements to return (default: 10) |
selector | string | yes | CSS selector to match elements |
browser_frame
Find a frame by name (exact match) or URL (substring match)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
nameOrUrl | string | yes | Frame name (exact match) or URL substring to find |
browser_frames
List all child frames (iframes) on the current page
No parameters.
browser_get_attribute
Get the value of an HTML attribute on an element
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
attribute | string | yes | Attribute name to retrieve (e.g., "href", "src", "class", "data-id") | |
selector | string | yes | CSS selector for the element |
browser_get_html
Get the HTML content of the page or a specific element
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
outer | boolean | no | false | Return outerHTML instead of innerHTML (default: false) |
selector | string | no | CSS selector for a specific element (optional, defaults to full page HTML) |
browser_get_text
Get the text content of the page or a specific element
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | no | CSS selector for a specific element (optional, defaults to full page text) |
browser_get_title
Get the current page title
No parameters.
browser_get_url
Get the current page URL
No parameters.
browser_get_value
Get the current value of an input, textarea, or select element
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the form element |
browser_is_checked
Check if a checkbox or radio button is checked. Returns true/false.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector or @ref for the checkbox/radio element |
browser_is_enabled
Check if an element is enabled (not disabled). Returns true/false.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector or @ref for the element |
browser_is_visible
Check if an element is visible on the page. Returns true/false without throwing errors.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the element |
browser_list_pages
List all open browser pages with their URLs
No parameters.
browser_map
Map interactive page elements with @refs for targeting. Returns a list of interactive elements (buttons, links, inputs, etc.) each with a short @ref like @e1, @e2. Use these refs as selectors in other commands (click, fill, etc.).
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | no | CSS selector to scope element discovery to a subtree (e.g. "nav", "#sidebar") |