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

sym_browser

An individual browser operation on an authorised Browser Pass, subject to its scope, native schema, session and permission validation. 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: no additional tool-discovery scope. 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",
          "maxLength": 80
        },
        "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

Published REST routes
[
  {
    "method": "POST",
    "path": "/v1/passes/{id}/invoke"
  }
]