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

visualAction

Trusted pointer using fresh single-use snapshot IMAGE pixel x/y, never OS coordinates. Unique requestId: 8..128 alphanumeric/underscore/hyphen. down held until up/end/expiry; drag to:{x,y} uses same image. No replay after unknown outcome; inspect/new capture. Tab/document/frames/scroll/viewport/DPR must match. Delivery is not application success.

API 2.3.3 · Published service contract ↗

Usage

Use the typed read or action tool permitted by the selected Pass documentation. Operation: visualAction. 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✓
snapshotIdstring✓
requestIdstring✓
actionstring✓Values: ["hover","click","doubleClick","rightClick","down","up","drag"]
xnumber✓
ynumber✓
toobject×
modifiersarray×
workSessionIdstring×
Complete args schema
{
  "type": "object",
  "properties": {
    "leaseId": {
      "type": "string",
      "maxLength": 36
    },
    "snapshotId": {
      "type": "string",
      "maxLength": 36
    },
    "requestId": {
      "type": "string",
      "maxLength": 128
    },
    "action": {
      "type": "string",
      "enum": [
        "hover",
        "click",
        "doubleClick",
        "rightClick",
        "down",
        "up",
        "drag"
      ]
    },
    "x": {
      "type": "number",
      "minimum": 0,
      "maximum": 8192
    },
    "y": {
      "type": "number",
      "minimum": 0,
      "maximum": 8192
    },
    "to": {
      "type": "object",
      "properties": {
        "x": {
          "type": "number",
          "minimum": 0,
          "maximum": 8192
        },
        "y": {
          "type": "number",
          "minimum": 0,
          "maximum": 8192
        }
      },
      "required": [
        "x",
        "y"
      ],
      "additionalProperties": false
    },
    "modifiers": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Alt",
          "Control",
          "Meta",
          "Shift"
        ]
      },
      "minItems": 0,
      "maxItems": 4
    },
    "workSessionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "leaseId",
    "snapshotId",
    "requestId",
    "action",
    "x",
    "y"
  ],
  "additionalProperties": false
}

Output

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