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

eval

Run a user-authorized JavaScript expression in this tab using the existing native page evaluator. Full/control Pass only; may read or change the authenticated page. Tracked MCP evaluation always awaits Promises; detached evaluation is a separate low-level CDP call, not this tracked operation. Async IIFEs are awaited; return a compact serializable value. Do not access credentials or broaden the user task. JS-generated input is not trusted input. navigates:true waits for navigation; timeoutMs bounds that wait, NOT arbitrary script execution. A timeout or lost response may leave effects applied: inspect, never automatically retry.

API 2.3.3 · Published service contract ↗

Usage

Use the typed read or action tool permitted by the selected Pass documentation. Operation: eval. A target tabId is required.

Use sym_pass_docs for the chosen Pass. Only its live supported operations and current capabilityRevision are callable.

Operation arguments

FieldTypeRequiredDescription
expressionstring✓
awaitPromiseboolean×Tracked MCP eval awaits completion; use the low-level tab CDP operation for explicit detached evaluation. Values: [true]
navigatesboolean×
timeoutMsinteger×
workSessionIdstring×
Complete args schema
{
  "type": "object",
  "properties": {
    "expression": {
      "type": "string",
      "maxLength": 250000,
      "minLength": 1
    },
    "awaitPromise": {
      "type": "boolean",
      "enum": [
        true
      ],
      "description": "Tracked MCP eval awaits completion; use the low-level tab CDP operation for explicit detached evaluation."
    },
    "navigates": {
      "type": "boolean"
    },
    "timeoutMs": {
      "type": "integer",
      "minimum": 1,
      "maximum": 15000
    },
    "workSessionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "expression"
  ],
  "additionalProperties": false
}

Output

Output is operation- and device-dependent. Read the selected Pass’s current documentation and inspect the returned envelope.