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

elementAction

Full-scope leased trusted pointer at one root/open-shadow DOM target. Temporary ordinary pixels are used internally to guard input, not uploaded. Hover before clicking dynamic UI. Down/up hold/release real input; always end lease. Use pointer drag for element drag or visualAction for frame/image coordinates. No replay.

API 2.3.3 · Published service contract ↗

Usage

Use the typed read or action tool permitted by the selected Pass documentation. Operation: elementAction. 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
leaseIdstring✓
requestIdstring✓
actionstring✓Values: ["hover","click","doubleClick","rightClick","down","up"]
refstring×
selectorstring×
modifiersarray×
workSessionIdstring×
Complete args schema
{
  "type": "object",
  "properties": {
    "leaseId": {
      "type": "string",
      "maxLength": 36
    },
    "requestId": {
      "type": "string",
      "maxLength": 128
    },
    "action": {
      "type": "string",
      "enum": [
        "hover",
        "click",
        "doubleClick",
        "rightClick",
        "down",
        "up"
      ]
    },
    "ref": {
      "type": "string",
      "maxLength": 160
    },
    "selector": {
      "type": "string",
      "maxLength": 1000
    },
    "modifiers": {
      "type": "array",
      "minItems": 0,
      "maxItems": 4,
      "items": {
        "type": "string",
        "enum": [
          "Alt",
          "Control",
          "Meta",
          "Shift"
        ]
      }
    },
    "workSessionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "leaseId",
    "requestId",
    "action"
  ],
  "additionalProperties": false
}

Output

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