> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-mcp-browser-pool-docs-pr112.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Computer Action

> Mouse, keyboard, clipboard, and screenshot controls for browser sessions

Use `computer_action` when an agent needs to interact with the browser like a user: click, type, scroll, drag, copy, paste, or inspect the screen. Pass one action for a simple operation, or batch several actions into one call to reduce latency.

<Tip>Include a `screenshot` as the last action when you need to see the result. `screenshot`, `read_clipboard`, and `get_mouse_position` return data, so they must be the last action if included.</Tip>

## Parameters

| Parameter    | Description                                               |
| ------------ | --------------------------------------------------------- |
| `session_id` | Browser session ID. Required.                             |
| `actions`    | Ordered list of one or more actions to perform. Required. |

## Action types

| Type                 | Description                                                                    |
| -------------------- | ------------------------------------------------------------------------------ |
| `click_mouse`        | Click at `x`, `y`. Supports `button`, `click_type`, `num_clicks`, `hold_keys`. |
| `move_mouse`         | Move the cursor to `x`, `y`.                                                   |
| `type_text`          | Type `text`, with optional inter-key `delay`.                                  |
| `press_key`          | Press `keys` (X11 keysym names or combos like `Ctrl+t`, `Return`).             |
| `scroll`             | Scroll at `x`, `y` by `delta_x`/`delta_y` (positive = right/down).             |
| `drag_mouse`         | Drag along a `path` of `[x, y]` points.                                        |
| `set_cursor`         | Show or hide the cursor (`hidden`).                                            |
| `sleep`              | Wait `duration_ms` between steps when the page needs time to react.            |
| `write_clipboard`    | Write `text` to the browser session clipboard.                                 |
| `read_clipboard`     | Read the browser session clipboard. Must be the last action if included.       |
| `screenshot`         | Capture the page, optionally limited to a `region`.                            |
| `get_mouse_position` | Return the current cursor position.                                            |

## Recommended flow

1. Start with `screenshot` so the agent can see the viewport and coordinate space.
2. Batch related pointer and keyboard actions together.
3. Add `sleep` between actions that trigger navigation, animation, or async UI updates.
4. End with `screenshot`, `read_clipboard`, or `get_mouse_position` only when you need returned data.

## Search from the page

```json theme={null}
{
  "session_id": "browser_abc123",
  "actions": [
    { "type": "click_mouse", "click_mouse": { "x": 420, "y": 300 } },
    { "type": "type_text", "type_text": { "text": "kernel browsers" } },
    { "type": "press_key", "press_key": { "keys": ["Return"] } },
    { "type": "sleep", "sleep": { "duration_ms": 1000 } },
    { "type": "screenshot" }
  ]
}
```

## Clipboard example

```json theme={null}
{
  "session_id": "browser_2vDb5kRmZ4nP8xQ1cA7",
  "actions": [
    { "type": "write_clipboard", "write_clipboard": { "text": "https://kernel.sh/docs" } },
    { "type": "press_key", "press_key": { "keys": ["Ctrl+l"] } },
    { "type": "press_key", "press_key": { "keys": ["Ctrl+v"] } },
    { "type": "press_key", "press_key": { "keys": ["Return"] } },
    { "type": "screenshot" }
  ]
}
```