SymDocs
Passes MCP
All productsSym Workspace APISym Passes MCP
Supportjoinsym.com ↗
Sym Passes MCP

sym_browser_act

Full-scope browser operations: open/select a separate Chrome window with workWindow, create or close tabs, manage work sessions, downloads and user-selected uploads, batch actions, cursor/diagnostics and scoped CDP. newTab creates a tab, NOT a new window; use workWindow mode own for a separate window. Current Pass documentation supplies supported verbs, required tab/session arguments and exact schemas. No automatic replay after uncertainty. Eval feedback v1 supports awaited JSON results, settled JavaScript errors, retained work sessions and bounded batches with explicit stop-on-error behavior.

API 2.3.3 · Published service contract ↗

Permissions

Discovery scopes: browser:read, browser:act. Subject to discoveryScopes; execution still checks actual grant, account, Pass and resource authority.

Arguments

FieldTypeRequiredDescription
passIdstring✓
requestIdstring✓
operationobject✓
Complete input schema
{
  "type": "object",
  "properties": {
    "passId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.-]{1,128}$"
    },
    "requestId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.-]{1,128}$"
    },
    "operation": {
      "type": "object",
      "properties": {
        "verb": {
          "type": "string",
          "enum": [
            "workWindow",
            "beginWorkSession",
            "endWorkSession",
            "resolvePageRef",
            "focusWindow",
            "closeTab",
            "download",
            "downloadStatus",
            "cancelDownload",
            "requestFileUpload",
            "fileUploadStatus",
            "waitFor",
            "cursor",
            "detach",
            "identity",
            "ping",
            "update",
            "cdp",
            "act",
            "recoverWindow",
            "click",
            "type",
            "navigate",
            "activate",
            "newTab",
            "eval",
            "dialog",
            "elementAction",
            "beginInteraction",
            "endInteraction",
            "visualScreenshot",
            "visualAction",
            "safeScreenshot",
            "frameClick",
            "frames",
            "find",
            "scroll",
            "fill",
            "selectOption",
            "setChecked",
            "waitState",
            "pressKey",
            "releaseKeys",
            "pointer",
            "media",
            "tabControl"
          ]
        },
        "profile": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "tabId": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "args": {
          "default": {},
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "capabilityRevision": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "required": [
        "verb",
        "profile",
        "capabilityRevision"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "passId",
    "requestId",
    "operation"
  ],
  "additionalProperties": false
}

Returns

open-object; see responseContract.payloads and live/version-specific contract

Output schema
{
  "type": "object",
  "properties": {
    "result": {
      "description": "Native operation value; eval returns its JSON value under result.value."
    },
    "documentation": {
      "description": "Browser verb docs returns documentation instead of result.",
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "encoding": {
      "type": "string",
      "const": "base64"
    },
    "format": {
      "type": "string",
      "enum": [
        "png",
        "jpeg"
      ]
    },
    "width": {
      "type": "number"
    },
    "height": {
      "type": "number"
    },
    "asset": {
      "description": "Private screenshot metadata; image bytes travel in MCP image content.",
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "imageDelivery": {
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "status": {}
  },
  "additionalProperties": {},
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "result": {
          "description": "Native operation value; eval returns its JSON value under result.value."
        },
        "documentation": {
          "description": "Browser verb docs returns documentation instead of result.",
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        "encoding": {
          "type": "string",
          "const": "base64"
        },
        "format": {
          "type": "string",
          "enum": [
            "png",
            "jpeg"
          ]
        },
        "width": {
          "type": "number"
        },
        "height": {
          "type": "number"
        },
        "asset": {
          "description": "Private screenshot metadata; image bytes travel in MCP image content.",
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        "imageDelivery": {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        }
      },
      "additionalProperties": {},
      "not": {
        "required": [
          "error"
        ]
      }
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string"
        },
        "status": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "result": false,
        "documentation": false,
        "encoding": false,
        "format": false,
        "width": false,
        "height": false,
        "asset": false,
        "imageDelivery": false
      },
      "required": [
        "error",
        "status"
      ],
      "additionalProperties": {}
    }
  ]
}

REST equivalents

No REST equivalent is declared for this tool. Invoke it through your authorized MCP connection.