Page
Page — MCP tools exposed to agents.
20 tools in this group.
browser_open
Navigate the browser to a URL. url is required; a bare host (e.g. example.com) is prefixed with https://. To launch (or connect to) a browser without navigating, use browser_start; to close it, use browser_stop. (The CLI open is url-optional and lazy-launches when bare — this agent tool is url-required by design: same capabilities, different surface ergonomics, not a 1:1 syntax mirror.)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). | |
url | string | yes | The URL to navigate to (required; bare hosts get https:// prepended) |
browser_back
Navigate back in browser history (like clicking the back button)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_forward
Navigate forward in browser history (like clicking the forward button)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_reload
Reload the current page. Waits for the page to fully load.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ignore_cache | boolean | no | Bypass the browser cache when reloading (default: false) | |
session | string | no | Optional: named session to run this call in (default: current session). | |
wait | string | no | Readiness state to wait for before returning (default: complete) (one of: none, interactive, complete) |
browser_get_url
Get the current page URL
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_get_title
Get the current page title
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
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) | |
session | string | no | Optional: named session to run this call in (default: current session). |
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) | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_read
Return a page as agent-readable text (markdown). With a url, fetches it over HTTP without the browser (negotiates markdown/plain, retries a .md path, discovers llms.txt, extracts readable text from HTML). WITHOUT a url, renders the active tab's live DOM, capturing client-rendered/authenticated state a plain fetch cannot.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter | string | no | Narrow output to sections/headings/links matching this text | |
json | boolean | no | false | Return the full fetch envelope (url, finalUrl, status, contentType, source, content) as JSON instead of just the content |
llms | string | no | Read the nearest llms.txt (index) or llms-full.txt (full) instead of the page (one of: index, full) | |
outline | boolean | no | false | Return a compact heading outline of the page |
raw | boolean | no | false | Return the body verbatim, without markdown extraction |
require_md | boolean | no | false | Fail unless the response Content-Type is text/markdown |
session | string | no | Optional: named session to run this call in (default: current session). | |
timeout_ms | integer | no | Request timeout in milliseconds (default 30000) | |
url | string | no | URL to fetch (http/https; a bare host assumes https). Omit to read the active tab's live DOM instead. |
browser_set_content
Replace the page HTML content
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
html | string | yes | HTML content to set | |
session | string | no | Optional: named session to run this call in (default: current session). |
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 |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_evaluate
Execute JavaScript in the browser to extract data, query the DOM, or inspect page state. Returns the evaluated result. Use this to get text content, attributes, element data, or any information from the page.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expression | string | yes | JavaScript expression to evaluate | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_wait
Wait for an element to reach a specified state (attached, visible, or hidden)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the element to wait for | |
session | string | no | Optional: named session to run this call in (default: current session). | |
state | string | no | "attached" | State to wait for: "attached" (exists in DOM), "visible" (visible on page), or "hidden" (not found or not visible) (one of: attached, visible, hidden) |
timeout | integer | no | 30000 | Timeout in milliseconds (default: 30000) |
browser_wait_for_url
Wait until the page URL contains a given substring
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pattern | string | yes | Substring to match in the URL | |
session | string | no | Optional: named session to run this call in (default: current session). | |
timeout | integer | no | 30000 | Timeout in milliseconds (default: 30000) |
browser_wait_for_load
Wait until the page reaches the "complete" ready state (all resources loaded)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). | |
timeout | integer | no | 30000 | Timeout in milliseconds (default: 30000) |
browser_wait_for_text
Wait until specific text appears on the page
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). | |
text | string | yes | Text to wait for on the page | |
timeout | integer | no | 30000 | Timeout in milliseconds (default: 30000) |
browser_wait_for_fn
Wait until a JavaScript expression returns a truthy value
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expression | string | yes | JavaScript expression to evaluate (e.g., "window.ready === true") | |
session | string | no | Optional: named session to run this call in (default: current session). | |
timeout | integer | no | 30000 | Timeout in milliseconds (default: 30000) |
browser_console_list
List buffered browser console messages and page errors (WebDriver BiDi log.entryAdded). Optional filters narrow the result without clearing the buffer.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
level | string | no | Only include entries at this log level (one of: debug, info, warn, error) | |
session | string | no | Optional: named session to run this call in (default: current session). | |
text | string | no | Only include entries whose text contains this substring | |
type | string | no | Only include console API entries or javascript exception entries (one of: console, javascript) |
browser_console_wait
Wait for the next matching browser console message or page error (log.entryAdded). Returns immediately if a matching buffered entry already exists; consumes the matched entry.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
level | string | no | Only match entries at this log level (one of: debug, info, warn, error) | |
session | string | no | Optional: named session to run this call in (default: current session). | |
text | string | no | Only match entries whose text contains this substring | |
timeout_ms | integer | no | 30000 | Timeout in milliseconds (default: 30000) |
type | string | no | Only match console API entries or javascript exception entries (one of: console, javascript) |
browser_console_clear
Clear the buffered browser console / page-error history for this session
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |