Capture
Capture — MCP tools exposed to agents.
14 tools in this group.
browser_screenshot
Capture a screenshot of the current page
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
annotate | boolean | no | false | Annotate interactive elements with numbered labels (default: false) |
filename | string | no | Optional filename to save the screenshot (e.g., screenshot.png) | |
fullPage | boolean | no | false | Capture the full page (entire document) instead of just the viewport (default: false) |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_pdf
Save the current page as a PDF file
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
background | boolean | no | Print background graphics (default: false) | |
filename | string | no | Output filename for the PDF (e.g., page.pdf) | |
margin | object | no | Page margins in cm (default: 1.0 each) | |
orientation | string | no | Page orientation (default: portrait) (one of: portrait, landscape) | |
page | object | no | Page size in cm (default: 21.59 x 27.94, US Letter) | |
pageRanges | array | no | Pages to print: numbers or ranges like "2-4" (default: all pages) | |
scale | number | no | Print scale, 0.1-2.0 (default: 1.0) | |
session | string | no | Optional: named session to run this call in (default: current session). | |
shrinkToFit | boolean | no | Shrink content to fit the page width (default: true) |
browser_record_start
Start a browser recording (screenshots and/or HTML snapshots). Output is Playwright trace viewer compatible.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
bidi | boolean | no | false | Record raw BiDi commands in the recording (default: false) |
format | string | no | "jpeg" | Screenshot format: "jpeg" or "png" (default: "jpeg") (one of: jpeg, png) |
name | string | no | Name for the recording (default: "record") | |
quality | number | no | 0.5 | JPEG quality 0.0-1.0 (default: 0.5, ignored for png) |
screenshots | boolean | no | true | Capture screenshots after each action (default: true) |
session | string | no | Optional: named session to run this call in (default: current session). | |
snapshots | boolean | no | false | Capture HTML snapshots (default: false) |
sources | boolean | no | false | Include source information (default: false) |
title | string | no | Title shown in trace viewer (defaults to name) |
browser_record_stop
Stop recording and save to a Playwright-compatible trace ZIP file
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
path | string | no | Output file path (default: record.zip) | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_record_start_group
Start a named group in the recording (groups nest actions in the trace viewer)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name for the group | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_record_stop_group
End the current recording group
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_record_start_chunk
Start a new chunk within the current recording (for splitting long recordings)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | no | Name for the chunk | |
session | string | no | Optional: named session to run this call in (default: current session). | |
title | string | no | Title shown in trace viewer (defaults to name) |
browser_record_stop_chunk
Package the current recording chunk into a ZIP file (recording remains active)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
path | string | no | Output file path (default: chunk.zip) | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_screencast_start
Start a native video recording of the page viewport (WebDriver BiDi browsingContext.startScreencast). The browser writes the video to a file it chooses; browser_screencast_stop returns the path. One active screencast per session. Separate from browser_record_start (per-action trace recording). Fails cleanly if the browser does not support native screencast.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
audio | boolean | no | false | Also capture the page's audio (default: false) |
frameRate | integer | no | Requested video frame rate in frames per second (default: browser-chosen) | |
height | integer | no | Requested video height in pixels (default: browser-chosen) | |
mimeType | string | no | Video MIME type (e.g. "video/webm"; default: browser-chosen) | |
session | string | no | Optional: named session to run this call in (default: current session). | |
width | integer | no | Requested video width in pixels (default: browser-chosen) |
browser_screencast_stop
Stop a native screencast (WebDriver BiDi browsingContext.stopScreencast) and return the browser-written video file path. Optionally copy the file to outputPath when it is locally readable; the browser-created source file is never deleted.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
outputPath | string | no | Copy the recorded video to this local path (requires the browser's file to be locally readable) | |
screencast | string | no | Screencast id to stop (default: this session's active screencast) | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_diff_map
Compare current page state vs last map. Shows additions (+) and removals (-) since the last browser_map call.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_diff_snapshot
Compare the current accessibility snapshot vs the last one. Shows removals (-) and additions (+) since the last browser_a11y_tree or browser_diff_snapshot call; pass baseline to diff against a saved snapshot file instead.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
baseline | string | no | Path to a saved snapshot file (rendered snapshot text or raw browser_a11y_tree JSON) to diff against instead of the last snapshot | |
everything | boolean | no | false | Include all nodes (generic containers, etc.), like browser_a11y_tree |
selector | string | no | CSS selector or @ref to scope the snapshot to a subtree | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_diff_screenshot
Compare a current screenshot against a baseline image file, pixel by pixel. Reports match, changed/total pixel counts and mismatch percent; optionally writes a visual diff image.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
baseline | string | yes | Path to the baseline PNG/JPEG image to compare against | |
fullPage | boolean | no | false | Capture the full page instead of just the viewport |
output | string | no | Path to write the diff image (changed pixels in red); only written when pixels differ | |
session | string | no | Optional: named session to run this call in (default: current session). | |
threshold | number | no | 0.1 | Per-pixel color tolerance from 0 (exact) to 1 |
browser_diff_url
Compare two pages: navigates to url1, snapshots, navigates to url2, snapshots, and diffs the accessibility snapshots (optionally screenshots too). The browser is left on url2.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
everything | boolean | no | false | Include all nodes in the snapshots |
fullPage | boolean | no | false | Capture full-page screenshots (with screenshot) |
screenshot | boolean | no | false | Also compare screenshots of the two pages |
selector | string | no | CSS selector to scope both snapshots to a subtree | |
session | string | no | Optional: named session to run this call in (default: current session). | |
url1 | string | yes | First URL (a bare host gets https:// prepended) | |
url2 | string | yes | Second URL; the browser stays on this page afterwards |