CloudBrowser

Show your active browsers and saved sessions in a workspace beside the conversation. Does not allocate or connect a browser. Optionally show a connected browser and its current screenshot. Use the sessionId and address from the selected browser to continue work.

{
  "type": "object",
  "properties": {
    "browserAddress": {
      "type": "string",
      "description": "Optional owned browser to inspect."
    }
  }
}

Resume an existing saved session owned by the connected account. Reuses an active browser with the label, otherwise opens one metered browser with a 180-second idle timeout, restoring cookies and storage, not tabs. Only call after the user requests resume. Never retry an ambiguous allocation or change requestId to retry. Close the returned browser when finished.

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "requestId": {
      "type": "string",
      "minLength": 16,
      "maxLength": 80,
      "description": "Unique operation ID. Repeated calls for the same operation must use the same ID."
    }
  },
  "required": [
    "label",
    "requestId"
  ]
}

Open one remote browser in the cloud with the connected CloudBrowser account. Use it only for websites and accounts that the user owns or is authorized to use, and follow their terms. Browsers open without stealth fingerprints.

{
  "type": "object",
  "properties": {
    "headless": {
      "type": "boolean",
      "description": "Indicates whether the browser should open in headless mode (true) or with GUI (false). Default false",
      "default": false
    },
    "browser": {
      "type": "number",
      "description": "Browser type: 0 = Chrome, 2 = Chromium, 3 = ChromeHeadlessShell. Default 0",
      "enum": [
        0,
        2,
        3
      ],
      "default": 0
    },
    "keepOpen": {
      "type": "number",
      "description": "Seconds of inactivity before browser closes automatically. Value 0 is never, default 300 seconds",
      "default": 300
    },
    "label": {
      "type": "string",
      "description": "Specifies the instance name, useful for recognizing it in the list of open remote desktops"
    },
    "saveSession": {
      "type": "boolean",
      "description": "If true, browser session is saved periodically and at the end, cookies and local storage, but not open tabs. Default false",
      "default": false
    },
    "recoverSession": {
      "type": "boolean",
      "description": "If true, loads the label when starting a previous session (if it exists), to know which session we save/restore. Default false",
      "default": false
    }
  },
  "required": []
}

Close a specific browser

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Address of the browser to close"
    }
  },
  "required": [
    "address"
  ]
}

Get list of active browsers

{
  "type": "object",
  "properties": {},
  "required": []
}

Start remote desktop access to a browser

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Address of the browser"
    }
  },
  "required": [
    "address"
  ]
}

Stop remote desktop access to a browser

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Address of the browser"
    }
  },
  "required": [
    "address"
  ]
}

Get list of saved sessions

{
  "type": "object",
  "properties": {},
  "required": []
}

Delete a saved session

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "Label of the session to delete"
    }
  },
  "required": [
    "label"
  ]
}

Connect to CloudBrowser browser for direct control

{
  "type": "object",
  "properties": {
    "browserAddress": {
      "type": "string",
      "description": "WebSocket URL of the CloudBrowser browser (format: ws://browser.cloudbrowser.ai/devtools/browser/[ID])"
    },
    "sessionId": {
      "type": "string",
      "description": "Unique ID for the control session"
    }
  },
  "required": [
    "browserAddress",
    "sessionId"
  ]
}

Navigate the connected browser to a URL that the user asked for. Use it only for websites and accounts that the user owns or is authorized to use, and follow their terms. Stop at logins, MFA and CAPTCHAs and hand control to the user; this tool does not solve CAPTCHAs.

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Session ID of the connected browser"
    },
    "browserAddress": {
      "type": "string",
      "description": "Optional websocket address for automatic reconnect if session state was lost"
    },
    "url": {
      "type": "string",
      "description": "URL to navigate to"
    },
    "waitUntil": {
      "type": "string",
      "description": "When to consider navigation complete",
      "enum": [
        "load",
        "domcontentloaded",
        "networkidle0",
        "networkidle2"
      ],
      "default": "load"
    }
  },
  "required": [
    "sessionId",
    "url"
  ]
}

Get the HTML content of the current page to answer the user's request about it. Use it only for websites and accounts that the user owns or is authorized to use, and follow their terms. Not for crawling or bulk data extraction from third-party websites.

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Session ID of the connected browser"
    }
  },
  "required": [
    "sessionId"
  ]
}

Click on a page element

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Session ID of the connected browser"
    },
    "selector": {
      "type": "string",
      "description": "CSS selector of the element to click"
    }
  },
  "required": [
    "sessionId",
    "selector"
  ]
}

Type text into an element

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Session ID of the connected browser"
    },
    "selector": {
      "type": "string",
      "description": "CSS selector of the element to type into"
    },
    "text": {
      "type": "string",
      "description": "Text to type"
    },
    "clear": {
      "type": "boolean",
      "description": "Clear the field before typing",
      "default": true
    }
  },
  "required": [
    "sessionId",
    "selector",
    "text"
  ]
}

Get information about elements matching a selector

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Session ID of the connected browser"
    },
    "selector": {
      "type": "string",
      "description": "CSS selector of the elements"
    }
  },
  "required": [
    "sessionId",
    "selector"
  ]
}

Take screenshot of the current page

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Session ID of the connected browser"
    },
    "fullPage": {
      "type": "boolean",
      "description": "Capture full page or viewport only",
      "default": false
    },
    "type": {
      "type": "string",
      "description": "Image format",
      "enum": [
        "png",
        "jpeg"
      ],
      "default": "png"
    }
  },
  "required": [
    "sessionId"
  ]
}

Disconnect this control session from a browser. The browser keeps running; use close_browser to stop it.

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Session ID of the browser to disconnect"
    }
  },
  "required": [
    "sessionId"
  ]
}

List the browsers that this caller has connected for direct control

{
  "type": "object",
  "properties": {},
  "required": []
}