WebDriverIO MCP Server 3.12.0

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "minLength": 1,
      "description": "Existing remote WebDriver/Appium session ID"
    },
    "provider": {
      "default": "local",
      "description": "Provider hosting the existing session (default: local). Use \"external\" for a custom W3C WebDriver endpoint.",
      "type": "string",
      "enum": [
        "local",
        "browserstack",
        "saucelabs",
        "testmu",
        "testingbot",
        "digitalai",
        "external"
      ]
    },
    "platform": {
      "type": "string",
      "enum": [
        "browser",
        "ios",
        "android"
      ],
      "description": "Existing session platform type (browser, ios, or android; Electron attachment is unsupported)."
    },
    "browser": {
      "description": "Browser for local command registration (browser platform only, default: chrome)",
      "type": "string",
      "enum": [
        "chrome",
        "firefox",
        "edge",
        "safari"
      ]
    },
    "automationName": {
      "description": "Appium automation driver for local command registration (mobile platforms only)",
      "type": "string",
      "enum": [
        "XCUITest",
        "UiAutomator2"
      ]
    },
    "webdriverConfig": {
      "description": "Existing W3C WebDriver endpoint connection (provider: \"external\" only). Defaults to 127.0.0.1:4445/.",
      "type": "object",
      "properties": {
        "protocol": {
          "default": "http",
          "type": "string"
        },
        "hostname": {
          "default": "127.0.0.1",
          "type": "string"
        },
        "port": {
          "default": 4445,
          "type": "number"
        },
        "path": {
          "default": "/",
          "type": "string"
        }
      }
    },
    "appiumConfig": {
      "description": "Appium server connection (local provider only)",
      "type": "object",
      "properties": {
        "host": {
          "type": "string"
        },
        "port": {
          "type": "number"
        },
        "path": {
          "type": "string"
        },
        "protocol": {
          "type": "string"
        }
      }
    },
    "region": {
      "default": "eu-central-1",
      "description": "Sauce Labs region (default: eu-central-1). Only used with provider: \"saucelabs\".",
      "type": "string",
      "enum": [
        "us-west-1",
        "eu-central-1",
        "apac-southeast-1"
      ]
    },
    "trace": {
      "description": "Enable trace recording for subsequent commands — produces a Playwright-compatible zip saved to .trace/ on close_session.",
      "type": "boolean"
    },
    "capabilities": {
      "description": "Capabilities used to register the correct browser or Appium command surface locally; they are not sent to the remote endpoint",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "sessionId",
    "platform"
  ]
}

{
  "title": "Attach Session",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "selector": {
      "type": "string",
      "description": "Value for the selector, in the form of css selector or xpath (\"button.my-class\" or \"//button[@class='my-class']\" or \"button=Exact text with spaces\" or \"a*=Link containing text\")"
    },
    "scrollToView": {
      "description": "Whether to scroll the element into view before clicking",
      "type": "boolean"
    },
    "timeout": {
      "description": "Maximum time to wait for element in milliseconds",
      "type": "number"
    }
  },
  "required": [
    "selector"
  ]
}

{
  "title": "Click Element",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "detach": {
      "description": "If true, disconnect without terminating; if false, terminate. When omitted, externally managed and auto-detach sessions are preserved while other sessions are terminated.",
      "type": "boolean"
    }
  }
}

{
  "title": "Close Session",
  "destructiveHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": {
      "description": "Optional cookie name to delete a specific cookie. If not provided, deletes all cookies",
      "type": "string"
    }
  }
}

{
  "title": "Delete Cookies",
  "destructiveHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "sourceSelector": {
      "type": "string",
      "description": "Source element selector to drag"
    },
    "targetSelector": {
      "description": "Target element selector to drop onto",
      "type": "string"
    },
    "x": {
      "description": "Target X offset (if no targetSelector)",
      "type": "number"
    },
    "y": {
      "description": "Target Y offset (if no targetSelector)",
      "type": "number"
    },
    "duration": {
      "description": "Drag duration in milliseconds",
      "type": "number",
      "minimum": 100,
      "maximum": 5000
    }
  },
  "required": [
    "sourceSelector"
  ]
}

{
  "title": "Drag and Drop",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "device": {
      "description": "Device preset name (e.g. \"iPhone 15\", \"Pixel 7\"). Omit to list available presets. Pass \"reset\" to restore desktop defaults.",
      "type": "string"
    }
  }
}

{
  "title": "Emulate Device",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "minLength": 1,
      "description": "JavaScript body executed in the Electron main process. Use `electron` for Electron APIs, `args` for supplied values, and `return` for a result."
    },
    "args": {
      "description": "Values made available to the script as args[0], args[1], and so on.",
      "type": "array",
      "items": {}
    }
  },
  "required": [
    "script"
  ]
}

{
  "title": "Execute Electron Main-Process Script",
  "destructiveHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "description": "JavaScript code (browser) or mobile command string like \"mobile: pressKey\" (Appium)"
    },
    "args": {
      "description": "Arguments to pass to the script. For browser: element selectors or values. For mobile commands: command-specific parameters as objects.",
      "type": "array",
      "items": {}
    }
  },
  "required": [
    "script"
  ]
}

{
  "title": "Execute Script",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "limit": {
      "default": 0,
      "description": "Maximum number of nodes to return (0 = no limit)",
      "type": "number"
    },
    "offset": {
      "default": 0,
      "description": "Number of nodes to skip for pagination",
      "type": "number"
    },
    "roles": {
      "description": "Filter by ARIA roles, e.g. [\"button\", \"link\", \"heading\"]",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

{
  "title": "Get Accessibility Tree",
  "readOnlyHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "bundleId": {
      "type": "string",
      "description": "App bundle ID (iOS) or package name (Android), e.g. \"com.example.app\""
    }
  },
  "required": [
    "bundleId"
  ]
}

{
  "title": "Get App State",
  "readOnlyHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "title": "Get Automation Contexts",
  "readOnlyHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": {
      "description": "Cookie name to retrieve a specific cookie. If omitted, returns all cookies.",
      "type": "string"
    }
  }
}

{
  "title": "Get Cookies",
  "readOnlyHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "inViewportOnly": {
      "description": "Only return elements visible in the current viewport (default: false).",
      "type": "boolean"
    },
    "includeContainers": {
      "description": "Include container elements like divs and sections (default: false)",
      "type": "boolean"
    },
    "includeBounds": {
      "description": "Include element bounding box coordinates (default: false)",
      "type": "boolean"
    },
    "limit": {
      "default": 0,
      "description": "Maximum number of elements to return (0 = no limit)",
      "type": "number"
    },
    "offset": {
      "default": 0,
      "description": "Number of elements to skip (for pagination)",
      "type": "number"
    }
  }
}

{
  "title": "Get Visible Elements",
  "readOnlyHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "title": "Get Screenshot",
  "readOnlyHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "title": "Get Browser Tabs",
  "readOnlyHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "title": "Hide Keyboard",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "port": {
      "default": 9222,
      "description": "Remote debugging port (default: 9222)",
      "type": "number"
    },
    "mode": {
      "default": "newInstance",
      "description": "newInstance: open alongside existing Chrome | freshSession: clean profile",
      "type": "string",
      "enum": [
        "newInstance",
        "freshSession"
      ]
    },
    "copyProfileFiles": {
      "description": "Copy your Default Chrome profile (cookies, logins) into the debug session.",
      "type": "boolean"
    }
  }
}

{
  "title": "Launch Chrome",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "browserstack",
        "saucelabs",
        "testmu",
        "testingbot",
        "digitalai"
      ],
      "description": "Cloud provider"
    },
    "sortBy": {
      "default": "uploaded_at",
      "description": "Sort order for results",
      "type": "string",
      "enum": [
        "app_name",
        "uploaded_at"
      ]
    },
    "organizationWide": {
      "description": "(BrowserStack only) List apps uploaded by all users in the organization. Defaults to false (own uploads only).",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of apps to return (only applies when organizationWide is true, default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "region": {
      "default": "eu-central-1",
      "description": "Sauce Labs region (default: eu-central-1)",
      "type": "string",
      "enum": [
        "us-west-1",
        "eu-central-1",
        "apac-southeast-1"
      ]
    }
  },
  "required": [
    "provider"
  ]
}

{
  "title": "List Cloud Provider Apps",
  "readOnlyHint": true,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "The URL to navigate to"
    }
  },
  "required": [
    "url"
  ]
}

{
  "title": "Navigate to URL",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "extensionData": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "path"
            },
            "path": {
              "type": "string",
              "minLength": 1,
              "description": "Path to an unpacked extension directory on the remote end."
            }
          },
          "required": [
            "type",
            "path"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "archivePath"
            },
            "path": {
              "type": "string",
              "minLength": 1,
              "description": "Path to a packaged extension archive on the remote end."
            }
          },
          "required": [
            "type",
            "path"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "base64"
            },
            "value": {
              "type": "string",
              "minLength": 1,
              "description": "Base64-encoded packaged extension archive."
            }
          },
          "required": [
            "type",
            "value"
          ]
        }
      ],
      "description": "W3C BiDi webExtension.ExtensionData: unpacked directory path, archive path, or base64 archive."
    },
    "path": {
      "type": "string",
      "minLength": 1,
      "description": "Path inside the extension package, such as options.html or popup.html. Leading slashes are ignored."
    }
  },
  "required": [
    "extensionData",
    "path"
  ]
}

{
  "title": "Open Web Extension",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "orientation": {
      "type": "string",
      "enum": [
        "PORTRAIT",
        "LANDSCAPE"
      ],
      "description": "Device orientation"
    }
  },
  "required": [
    "orientation"
  ]
}

{
  "title": "Rotate Device",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "direction": {
      "type": "string",
      "enum": [
        "up",
        "down"
      ],
      "description": "Scroll direction"
    },
    "pixels": {
      "default": 500,
      "description": "Number of pixels to scroll",
      "type": "number"
    }
  },
  "required": [
    "direction"
  ]
}

{
  "title": "Scroll Page",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Cookie name"
    },
    "value": {
      "type": "string",
      "description": "Cookie value"
    },
    "domain": {
      "description": "Cookie domain (defaults to current domain)",
      "type": "string"
    },
    "path": {
      "description": "Cookie path (defaults to \"/\")",
      "type": "string"
    },
    "expiry": {
      "description": "Expiry date as Unix timestamp in seconds",
      "type": "number"
    },
    "httpOnly": {
      "description": "HttpOnly flag",
      "type": "boolean"
    },
    "secure": {
      "description": "Secure flag",
      "type": "boolean"
    },
    "sameSite": {
      "description": "SameSite attribute",
      "type": "string",
      "enum": [
        "strict",
        "lax",
        "none"
      ]
    }
  },
  "required": [
    "name",
    "value"
  ]
}

{
  "title": "Set Cookie",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude coordinate"
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude coordinate"
    },
    "altitude": {
      "description": "Altitude in meters (optional)",
      "type": "number"
    }
  },
  "required": [
    "latitude",
    "longitude"
  ]
}

{
  "title": "Set Geolocation",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "selector": {
      "type": "string",
      "description": "Value for the selector, in the form of css selector or xpath (\"button.my-class\" or \"//button[@class='my-class']\")"
    },
    "value": {
      "type": "string",
      "description": "Text to enter into the element"
    },
    "scrollToView": {
      "description": "Whether to scroll the element into view before typing",
      "type": "boolean"
    },
    "timeout": {
      "description": "Maximum time to wait for element in milliseconds",
      "type": "number"
    }
  },
  "required": [
    "selector",
    "value"
  ]
}

{
  "title": "Set Input Value",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "provider": {
      "default": "local",
      "description": "Session provider (default: local). Use \"external\" to connect to an externally managed W3C WebDriver endpoint. \"digitalai\" requires DIGITALAI_CLOUD_URL + DIGITALAI_ACCESS_KEY env vars.",
      "type": "string",
      "enum": [
        "local",
        "browserstack",
        "saucelabs",
        "testmu",
        "testingbot",
        "digitalai",
        "external"
      ]
    },
    "platform": {
      "type": "string",
      "enum": [
        "browser",
        "electron",
        "ios",
        "android"
      ],
      "description": "Session platform type"
    },
    "browser": {
      "description": "Browser to launch (required for browser platform)",
      "type": "string",
      "enum": [
        "chrome",
        "firefox",
        "edge",
        "safari"
      ]
    },
    "browserVersion": {
      "description": "Browser version (cloud providers only, default: latest)",
      "type": "string"
    },
    "electronRootDir": {
      "description": "Project root used by the Electron standalone service for Electron Builder/Electron Forge discovery. Electron-only.",
      "type": "string",
      "minLength": 1
    },
    "electronDeeplinkScheme": {
      "description": "URI scheme allowed by trigger_electron_deeplink, without \":\" (for example, \"myapp\"). Electron-only and optional unless triggering deeplinks.",
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9+.-]*$"
    },
    "os": {
      "description": "Operating system for cloud provider browser sessions (e.g. \"Windows\", \"Mac\", \"macOS\", \"Linux\"). BrowserStack: sets bstack:options.os separately. TestMu/Sauce Labs/TestingBot: combined with osVersion into W3C platformName. Digital.ai: combined with osVersion into the digitalai:osName capability (e.g. \"Mac OS Sequoia\", \"Windows 10\") — required for the grid to match a node. Browser platform only.",
      "type": "string"
    },
    "osVersion": {
      "description": "OS version for cloud provider browser sessions (e.g. \"11\", \"15\", \"Monterey\"). BrowserStack: sets bstack:options.osVersion separately. TestMu/Sauce Labs/TestingBot: combined with os into W3C platformName. Digital.ai: combined with os into digitalai:osName. Browser platform only.",
      "type": "string"
    },
    "app": {
      "description": "App URL (bs://... for BrowserStack, storage:filename= for Sauce Labs, lt://... for TestMu, tb://... for TestingBot, cloud:<package-or-bundle> for Digital.ai mobile sessions)",
      "type": "string"
    },
    "reporting": {
      "description": "Cloud provider reporting labels (project, build, session)",
      "type": "object",
      "properties": {
        "project": {
          "type": "string"
        },
        "build": {
          "type": "string"
        },
        "session": {
          "type": "string"
        }
      }
    },
    "headless": {
      "description": "Run browser in headless mode (default: true)",
      "type": "boolean"
    },
    "windowWidth": {
      "default": 1920,
      "description": "Browser window width",
      "type": "number",
      "minimum": 400,
      "maximum": 3840
    },
    "windowHeight": {
      "default": 1080,
      "description": "Browser window height",
      "type": "number",
      "minimum": 400,
      "maximum": 2160
    },
    "deviceName": {
      "description": "Mobile device/emulator/simulator name (required for ios/android)",
      "type": "string"
    },
    "deviceQuery": {
      "description": "Digital.ai device selection query for dynamic allocation, e.g. \"@os='android' and @version='14' and @name='.*Pixel.*'\". Only used with provider: \"digitalai\" mobile sessions; if omitted, one is built from deviceName/platformVersion.",
      "type": "string"
    },
    "platformVersion": {
      "description": "OS version for mobile sessions (e.g., \"17.0\", \"14\"). Mobile (ios/android) only.",
      "type": "string"
    },
    "appPath": {
      "description": "Path to app file (.app/.apk/.ipa)",
      "type": "string"
    },
    "automationName": {
      "description": "Automation driver",
      "type": "string",
      "enum": [
        "XCUITest",
        "UiAutomator2"
      ]
    },
    "autoGrantPermissions": {
      "description": "Auto-grant app permissions (default: true)",
      "type": "boolean"
    },
    "autoAcceptAlerts": {
      "description": "Auto-accept alerts (default: true)",
      "type": "boolean"
    },
    "autoDismissAlerts": {
      "description": "Auto-dismiss alerts (default: false)",
      "type": "boolean"
    },
    "appWaitActivity": {
      "description": "Activity to wait for on Android launch",
      "type": "string"
    },
    "udid": {
      "description": "Unique Device Identifier for iOS real device",
      "type": "string"
    },
    "noReset": {
      "description": "Preserve app data between sessions",
      "type": "boolean"
    },
    "fullReset": {
      "description": "Uninstall app before/after session",
      "type": "boolean"
    },
    "newCommandTimeout": {
      "default": 300,
      "description": "Appium command timeout in seconds",
      "type": "number",
      "minimum": 0
    },
    "trace": {
      "description": "Enable trace recording — produces a Playwright-compatible zip saved to .trace/ on close_session, playable at player.vibium.dev.",
      "type": "boolean"
    },
    "attach": {
      "description": "Attach to existing Chrome instead of launching",
      "type": "boolean"
    },
    "attachConfig": {
      "description": "Chrome remote debugging connection (attach mode only, defaults: port 9222, host localhost)",
      "type": "object",
      "properties": {
        "port": {
          "default": 9222,
          "type": "number"
        },
        "host": {
          "default": "localhost",
          "type": "string"
        }
      }
    },
    "webdriverConfig": {
      "description": "Existing W3C WebDriver endpoint connection (provider: \"external\" only). Defaults to 127.0.0.1:4445/.",
      "type": "object",
      "properties": {
        "protocol": {
          "default": "http",
          "type": "string"
        },
        "hostname": {
          "default": "127.0.0.1",
          "type": "string"
        },
        "port": {
          "default": 4445,
          "type": "number"
        },
        "path": {
          "default": "/",
          "type": "string"
        }
      }
    },
    "appiumConfig": {
      "description": "Appium server connection (local provider only)",
      "type": "object",
      "properties": {
        "host": {
          "type": "string"
        },
        "port": {
          "type": "number"
        },
        "path": {
          "type": "string"
        },
        "protocol": {
          "type": "string"
        }
      }
    },
    "region": {
      "default": "eu-central-1",
      "description": "Sauce Labs region (default: eu-central-1). Only used with provider: \"saucelabs\".",
      "type": "string",
      "enum": [
        "us-west-1",
        "eu-central-1",
        "apac-southeast-1"
      ]
    },
    "tunnel": {
      "description": "Enable local tunnel routing (cloud providers only, default: false). true = auto-start tunnel before session and stop on close. \"external\" = tunnel already running externally.",
      "anyOf": [
        {
          "type": "string",
          "const": "external"
        },
        {
          "type": "boolean"
        }
      ]
    },
    "tunnelName": {
      "description": "Tunnel identifier name. With tunnel: \"external\" this must match the running tunnel. With tunnel: true a unique name is auto-generated if not provided.",
      "type": "string"
    },
    "browserstackLocal": {
      "description": "Deprecated: use \"tunnel\" instead. Enable BrowserStack Local tunnel routing.",
      "anyOf": [
        {
          "type": "string",
          "const": "external"
        },
        {
          "type": "boolean"
        }
      ]
    },
    "saucelabsLocal": {
      "description": "Deprecated: use \"tunnel\" instead. Enable Sauce Connect tunnel routing.",
      "anyOf": [
        {
          "type": "string",
          "const": "external"
        },
        {
          "type": "boolean"
        }
      ]
    },
    "testmuLocal": {
      "description": "Deprecated: use \"tunnel\" instead. Enable TestMu Tunnel routing.",
      "anyOf": [
        {
          "type": "string",
          "const": "external"
        },
        {
          "type": "boolean"
        }
      ]
    },
    "navigationUrl": {
      "description": "URL to navigate to after starting",
      "type": "string"
    },
    "capabilities": {
      "description": "Additional capabilities to merge. For Electron, configure the official service under \"wdio:electronServiceOptions\" (for example appBinaryPath, appEntryPoint, appArgs, logDir, or captureRendererLogs).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "platform"
  ]
}

{
  "title": "Start Session",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "direction": {
      "type": "string",
      "enum": [
        "up",
        "down",
        "left",
        "right"
      ],
      "description": "Swipe direction"
    },
    "duration": {
      "description": "Swipe duration in milliseconds (default: 500)",
      "type": "number",
      "minimum": 100,
      "maximum": 5000
    },
    "percent": {
      "description": "Percentage of screen to swipe (0-1, default: 0.5 for up/down, 0.95 for left/right)",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    }
  },
  "required": [
    "direction"
  ]
}

{
  "title": "Swipe Screen",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Context name to switch to (e.g., \"NATIVE_APP\", \"WEBVIEW_com.example.app\", or use index from wdio://session/current/contexts resource)"
    }
  },
  "required": [
    "context"
  ]
}

{
  "title": "Switch Context",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "selector": {
      "description": "CSS/XPath selector for the iframe element. Omit to switch back to the top-level frame.",
      "type": "string"
    }
  }
}

{
  "title": "Switch Frame",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "handle": {
      "description": "Window handle to switch to",
      "type": "string"
    },
    "index": {
      "description": "0-based tab index to switch to",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  }
}

{
  "title": "Switch Browser Tab",
  "destructiveHint": false,
  "idempotentHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "selector": {
      "description": "Element selector (CSS, XPath, accessibility ID, or UiAutomator)",
      "type": "string"
    },
    "x": {
      "description": "X coordinate for screen tap (if no selector provided)",
      "type": "number"
    },
    "y": {
      "description": "Y coordinate for screen tap (if no selector provided)",
      "type": "number"
    }
  }
}

{
  "title": "Tap Element",
  "destructiveHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Deeplink URI to trigger through the Electron service."
    }
  },
  "required": [
    "url"
  ]
}

{
  "title": "Trigger Electron Deeplink",
  "destructiveHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "browserstack",
        "saucelabs",
        "testmu",
        "testingbot",
        "digitalai"
      ],
      "description": "Cloud provider"
    },
    "path": {
      "type": "string",
      "description": "Absolute path to the .apk or .ipa file"
    },
    "customId": {
      "description": "Optional custom ID for the app (used to reference it later)",
      "type": "string"
    },
    "region": {
      "default": "eu-central-1",
      "description": "Sauce Labs region (default: eu-central-1)",
      "type": "string",
      "enum": [
        "us-west-1",
        "eu-central-1",
        "apac-southeast-1"
      ]
    }
  },
  "required": [
    "provider",
    "path"
  ]
}

{
  "title": "Upload App to Cloud Provider",
  "destructiveHint": false
}