Interaction
Interaction — MCP tools exposed to agents.
19 tools in this group.
browser_check
Check a checkbox or radio button. Idempotent — does nothing if already checked.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the checkbox or radio button |
browser_click
Click an element by CSS selector. Waits for element to be visible, stable, and enabled.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the element to click |
browser_dblclick
Double-click an element by CSS selector or @ref
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector or @ref for the element to double-click |
browser_drag
Drag from one element to another
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
source | string | yes | CSS selector or @ref for the source element | |
target | string | yes | CSS selector or @ref for the target element |
browser_fill
Clear an input field and type new text. Waits for element to be editable, clears existing value, then types. Use this instead of browser_type when you want to replace the field contents.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the input element | |
text | string | yes | The text to fill in |
browser_focus
Focus an element by CSS selector or @ref
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector or @ref for the element to focus |
browser_hover
Hover over an element by CSS selector
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the element to hover over |
browser_keys
Press a key or key combination (e.g., "Enter", "Control+a", "Shift+Tab")
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
keys | string | yes | Key or key combination to press (e.g., "Enter", "Control+a", "Shift+ArrowDown") |
browser_mouse_click
Click at coordinates or at the current mouse position. If x and y are provided, moves the mouse there first.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
button | number | no | 0 | Mouse button (0=left, 1=middle, 2=right). Default: 0 |
x | number | no | X coordinate to click at | |
y | number | no | Y coordinate to click at |
browser_mouse_down
Press a mouse button down at the current position
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
button | number | no | 0 | Mouse button (0=left, 1=middle, 2=right). Default: 0 |
browser_mouse_move
Move the mouse to specific coordinates
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
x | number | yes | X coordinate | |
y | number | yes | Y coordinate |
browser_mouse_up
Release a mouse button at the current position
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
button | number | no | 0 | Mouse button (0=left, 1=middle, 2=right). Default: 0 |
browser_press
Press a key or key combination on a specific element or the focused element. If selector is given, clicks the element first to focus it, then presses the key.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | yes | Key or key combination to press (e.g., "Enter", "Control+a", "Escape") | |
selector | string | no | CSS selector for the element to focus before pressing (optional, defaults to currently focused element) |
browser_scroll
Scroll the page or a specific element
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
amount | number | no | 3 | Number of scroll increments (default: 3) |
direction | string | no | "down" | Scroll direction: up, down, left, right (default: down) (one of: up, down, left, right) |
selector | string | no | CSS selector for element to scroll to (optional, defaults to viewport center) |
browser_scroll_into_view
Scroll an element into view, centering it on screen
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the element to scroll into view |
browser_select
Select an option in a <select> element by value
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the <select> element | |
value | string | yes | The value to select |
browser_type
Type text into an element by CSS selector. Waits for element to be visible, stable, enabled, and editable.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the element to type into | |
text | string | yes | The text to type |
browser_uncheck
Uncheck a checkbox. Idempotent — does nothing if already unchecked.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector | string | yes | CSS selector for the checkbox |
browser_upload
Set files on an input[type=file] element
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
files | array | yes | Array of absolute file paths to upload | |
selector | string | yes | CSS selector for the file input element |