Browser-automation MCP server

mcp

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Package@wdio/mcp
Latest analyzed version4.1.0
Current tool count17
Latest analysisNov 16, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed4.0.0 → 4.1.0Latest: 4.1.0
  • read5
  • write11
  • destructive1
  • unknown0

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
@wdio/mcp@4.1.0
Registry
npm
Published
Oct 30, 2026
Integrity
sha512-wpHT2c4rMFU+yFd8AKFGYwThYqXAbL+i/rrw6uNnurkzM1sChr/duLVNSqSQfep7J6Frn4EjnT/XxPWwijP6NQ==
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/webdriverio/mcp

17 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
click_elementwebdriverio-mcp:tool:click_element
Observed interface and hashes

Clicks an element. On web pages the result lists what changed (new elements with refs, or the new page). In apps it does not: take a snapshot to see the new screen. Several steps in a row: perform_actions.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "selector": {
      "description": "Ref from snapshot (e12) or selector: CSS, XPath, \"button=Exact text\", \"a*=Partial text\"",
      "type": "string"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "required": [
    "selector"
  ],
  "type": "object"
}
sha256:063032e1972f4adfb13b5fe94edabecbf9c7937005c90f6e4b900ae016c8997e

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:7852041121a6b55b1743cbc01341055bc78ed47be5bb0306045099b74ef15ae6

Interface hash: sha256:a9fddac58cef30f6604db91719f118447e167c888349e7a7004e50d5c119e2c7

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/click_element",
  "title": "Click Element",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "click_element"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:4c1c7b32aecd9817a724188c8c70f9279f2da4521aef1c2c4127552016d480b5"
}
toolwrite4.0.04.1.0
close_sessionwebdriverio-mcp:tool:close_session
Observed interface and hashes

Closes the session, or with detach: true disconnects and leaves it running. Attached sessions and Appium sessions with noReset are detached unless detach: false.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "detach": {
      "type": "boolean"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:a179cd0f11cacd1b6bb4632d5243de584042b64e5f688390f68392d16ac0c3b1

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:77234414dea3b88000cc16443c7a0ba4d25a58daf2ea4481d4031aa6324f9031

Interface hash: sha256:f645c0d1d5707e1a5c8692794292e0e29ace7a998f12c8f4bf67d818ba293794

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/close_session",
  "title": "Close Session",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "close_session"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:87943c8effded20dc09e1d115593c5f21ab4682f4417030bd5805f694646a1cf"
}
tooldestructive4.0.04.1.0
enable_toolswebdriverio-mcp:tool:enable_tools
Observed interface and hashes

Adds more tools: mocks (mock network requests or Electron APIs); cookies (read, set and delete cookies); device (emulate a phone or tablet, fake the location); extensions (install and open a browser extension); attach (launch Chrome with remote debugging, attach to a running WebDriver or Appium session); elements (raw element list with bounds); cloud-apps (upload and list mobile apps on BrowserStack, Sauce Labs, TestMu, TestingBot, Digital.ai).

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "groups": {
      "items": {
        "enum": [
          "mocks",
          "cookies",
          "device",
          "extensions",
          "attach",
          "elements",
          "cloud-apps"
        ],
        "type": "string"
      },
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "groups"
  ],
  "type": "object"
}
sha256:93a2d6347f38bda4b9077005ba5452492cdf05da5a0559aa481b45ad4952d0ac

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:885e7cf752827ce2feb27d29d7d3965ce48f0fabaafe8003e822da40e754510c

Interface hash: sha256:88b97dfa02335f17a0be07a4023d25c2fdc9f071e052ef5118ca0965011b378c

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/enable_tools",
  "title": "Enable Tools",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "enable_tools"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:13ed8a7a1f24a8d56d46ad57f73614bfe5f59e8319e201b5dab9bb7467840180"
}
toolread4.0.0No change observed
execute_scriptwebdriverio-mcp:tool:execute_script
Observed interface and hashes

Runs JavaScript in the page (`return` a value; string args that match a selector are passed as elements) or, on Appium, a "mobile: <command>" with args. Prefer the dedicated tools for clicks and typing.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "args": {
      "description": "Script arguments, or the mobile command's parameters",
      "items": {},
      "type": "array"
    },
    "script": {
      "description": "JavaScript, or \"mobile: <command>\" on Appium",
      "type": "string"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "required": [
    "script"
  ],
  "type": "object"
}
sha256:ca93997e8b52b3c4609f222171eb4241bdf763dde64161e885fe041635d925fc

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:75cec3e652171bf3196268b07c4595a8dbd4352a35d03bed4b79ab002f891801

Interface hash: sha256:70162e0ac826330d88717ba7d3924fd92674fc6f6f2f7bca537109c35cd0191f

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/execute_script",
  "title": "Execute Script",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "execute_script"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:59a4e99a2d262d574d57ead4b8e12ffe96a23a4bf45206f3d79b2289e7294d0c"
}
toolwrite4.0.04.1.0
get_screenshotwebdriverio-mcp:tool:get_screenshot
Observed interface and hashes

Takes a screenshot of the current page or screen and returns a base64-encoded image, resized and compressed for model context limits.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:4c6f44e9e8d350be1c01e64ef92ac63d514e97e349a13271a91f6159b7c2af93

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:f656f4d13579887446835445c28c22be0719354452f8193014e57904d67d04c8

Interface hash: sha256:74ff9f3e672182a20ceed2e880115a04d534672f16ac3995c504f65ada85b4f9

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/get_screenshot",
  "title": "Get Screenshot",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "get_screenshot"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:78674f3920f78c23b08d3053b8b9382a633a49f99232853f419333816933b153"
}
toolread4.0.04.1.0
get_tabswebdriverio-mcp:tool:get_tabs
Observed interface and hashes

Lists all browser tabs with handle, title, URL, and which is active. Use before switch_tab to find the target handle or index. Browser-only.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:4c6f44e9e8d350be1c01e64ef92ac63d514e97e349a13271a91f6159b7c2af93

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:fa00507420063d99c2e6d9de178f2a3d4787e278500d080b733ebc0695431aa6

Interface hash: sha256:d5f18068058631d6654b1c87757742db1c74fe0375262940412e15c915219935

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/get_tabs",
  "title": "Get Browser Tabs",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "get_tabs"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:e9b96ad6f65c30a2103d29f058918e34098b8d1c24799bfb54b42a32f453582e"
}
toolread4.0.04.1.0
navigatewebdriverio-mcp:tool:navigate
Observed interface and hashes

Loads a URL in the current tab and waits for the page load event. Resets page state — DOM, JS runtime, timers, and frame context are destroyed. Use instead of clicking links when the target URL is known.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    },
    "url": {
      "description": "The URL to navigate to",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}
sha256:b360a97b02cdfcde3f22b0cf14d76a6f97b9784e6349e11d60f2e30122eb3036

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:dee5de8ae72fd11b957eb121adef9c6a7465c1e3456d93e518d9b89c281f9ea8

Interface hash: sha256:78f36d6f7f2caa07af1b0120590c312f2153cda4737239450acd3de25de2eee2

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/navigate",
  "title": "Navigate to URL",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "navigate"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:3c0e2f70209b0d4e4c5bc33ec8ffe737f80180bf2f448e4a70dcefe0b218ae6a"
}
toolwrite4.0.04.1.0
perform_actionswebdriverio-mcp:tool:perform_actions
Observed interface and hashes

Runs several actions in one call, e.g. fill a form and submit it, on the page or app screen, and returns what each one changed on web pages. Steps the current session does not support are rejected before any step runs. Stops at the first failure, when a step loads a new page, or before a key press that follows a click, select, check or uncheck that changed the page (continue with the new refs). value is the text for fill, the option for select and the keys for press.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "actions": {
      "items": {
        "properties": {
          "action": {
            "enum": [
              "click",
              "fill",
              "select",
              "check",
              "uncheck",
              "press"
            ],
            "type": "string"
          },
          "selector": {
            "description": "Ref (e12) or selector",
            "type": "string"
          },
          "times": {
            "description": "press only: repeat count",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "minItems": 1,
      "type": "array"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "required": [
    "actions"
  ],
  "type": "object"
}
sha256:71ddbfd9c7c10906dea20ae3ae3ef29d99fc3e2d72bfad99a4d6af78d2c27928

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:223bd364c8588a1ff07a62422de218cf36bfcbbadd85f5c1b4405092fab50768

Interface hash: sha256:ca2e5bc318c85c70eb7effba19122de1bb9dac6fa4c4b19903496a4526e53f1f

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/perform_actions",
  "title": "Perform Actions",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "perform_actions"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:caa3864b8648137d019d22d61f9efcf6c06dc9522a77ba5af4b3032ba9d0fc2b"
}
toolwrite4.0.04.1.0
press_keywebdriverio-mcp:tool:press_key
Observed interface and hashes

Presses a key or combination in the focused element, e.g. Enter, Tab, Escape, Control+a. The result lists what changed on the page. Several steps in a row: perform_actions.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "keys": {
      "description": "Key or combination",
      "type": "string"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    },
    "times": {
      "description": "Press it this many times, e.g. to move a slider",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}
sha256:7ee00524ea9d059760182939dbd0cc712bf9c775fcd2e239205b2352a806a8db

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:39a2700da0b8761d87a70b799ada46e41c796f1517627f82b3d3ca30de98653d

Interface hash: sha256:119ea339a8b6c95c28f260e4714f60192c3004a70cf2f21444671444cdfc51bc

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/press_key",
  "title": "Press Key",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "press_key"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:18db6fab0c83966da41a0f424d8cc5316cd4436f63da868dba73761782e5e96a"
}
toolwrite4.0.04.1.0
query_docswebdriverio-mcp:tool:query_docs
Observed interface and hashes

Search the official WebdriverIO documentation and return the most relevant excerpts with page, section and source URL. Use before answering any question about WebdriverIO APIs, configuration, services, reporters, selectors, or debugging. Query with 2-3 distinctive keywords, never a sentence: "appium setup", "devtools trace.zip" and "allure reporter" each return the right page first, while "how do I wire up appium in my config file" does not. A word can also collide with an unrelated page — `wire` matches Wire Protocol — so if a query misses, retry with the exact page title, which beats any paraphrase. Set fullPage for the whole page. To browse instead, read wdio://docs/index for every page title and its slug, then wdio://docs/page/{slug} for one page in full. Cite the `path` of any page you rely on.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "fullPage": {
      "description": "Return the full matched pages instead of excerpts",
      "type": "boolean"
    },
    "limit": {
      "default": 5,
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "2-3 distinctive keywords: an API name, config key, page title or feature (e.g. \"appium setup\", \"devtools trace.zip\", \"browserstack capabilities\"). A sentence dilutes the ranking.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
sha256:5bd299fe10cbe373f313c3ab4987748ad459e77ec36e30071c1cf41ebe7974fb

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:6067fcd8b33ab627dbaf3ac12eb77f74e2802f71237e8acbc1a0d2675b61eb52

Interface hash: sha256:b4fd2ebfe879b87f42384f8baaf499c0c3d85f348c4fccd824c0f6af69ebb83b

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/query_docs",
  "title": "Query WebdriverIO Docs",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "query_docs"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:086714905e68e1af85b03bcb0e45d965910eb5655f8d133e3b346369db2172f9"
}
toolread4.0.0No change observed
scrollwebdriverio-mcp:tool:scroll
Observed interface and hashes

Scrolls the page vertically by a pixel amount. Browser-only — for mobile scrolling use swipe. Only supports up/down; no horizontal scrolling.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "direction": {
      "description": "Scroll direction",
      "enum": [
        "up",
        "down"
      ],
      "type": "string"
    },
    "pixels": {
      "default": 500,
      "description": "Number of pixels to scroll",
      "type": "number"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "required": [
    "direction"
  ],
  "type": "object"
}
sha256:1e7e0aabc4e9d10fae0bd31bdf4580ae1a7e04720df08e4a62b8abe2e1de8589

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:c3bdbbfbcee81d826e4a45ac5db9819276f1623fd3e458f488215528687b71f6

Interface hash: sha256:9a65e741a27d1165bb6995fe9134bb552c13260060873e6d9b088690e67fce45

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/scroll",
  "title": "Scroll Page",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "scroll"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:9413222c2d80867f30c3870f2f8c126e3cf4e41582da2ee851380d9f862a0ffb"
}
toolwrite4.0.04.1.0
select_optionwebdriverio-mcp:tool:select_option
Observed interface and hashes

Selects an option of a <select> by its text. The result lists what changed on the page. Several steps in a row: perform_actions.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "selector": {
      "description": "Ref from snapshot (e12) or selector of the <select>",
      "type": "string"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    },
    "value": {
      "description": "Option text",
      "type": "string"
    }
  },
  "required": [
    "selector",
    "value"
  ],
  "type": "object"
}
sha256:fa82e9f80682209d48a35c775612c25fe0acb6e5a1a2369fe73ae64f13c18798

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:efcf8329eb24a0038384372cceaf6526d1795818fe75d88f15a1dc27e095f65f

Interface hash: sha256:0a2a9a8e98a08195d8f89eb189bc53058cb32f32ed6a386079956a42fbc21026

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/select_option",
  "title": "Select Option",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "select_option"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:04015aaef667bca73dd92ce4d6b44eaf1ed5bcdd32abaef8cc62190c5714e466"
}
toolwrite4.0.04.1.0
set_valuewebdriverio-mcp:tool:set_value
Observed interface and hashes

Replaces the text of an input or textarea. On web pages the result lists what changed (new elements with refs, or the new page). In apps it does not: take a snapshot to see the new screen. To fill several fields or fill and then click, use one perform_actions call.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "selector": {
      "description": "Ref from snapshot (e12) or selector: CSS, XPath, \"button=Exact text\", \"a*=Partial text\"",
      "type": "string"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    },
    "value": {
      "description": "Text to enter into the element",
      "type": "string"
    }
  },
  "required": [
    "selector",
    "value"
  ],
  "type": "object"
}
sha256:19d36b03590b0a6ca5d803d6e70f53e9f664c2502736173cd4c880db9d27ad3c

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:87b07efae3cee0f6acaa348b6f92468f70c276a097551b32f981f93beb64e4eb

Interface hash: sha256:d3460331c2d9db770697827cde1c9fcafc7f858aca9c4e17d0611b3890017b69

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/set_value",
  "title": "Set Input Value",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "set_value"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:89521e27ed80c30b261535dfa36ef92d486400fecb7ae803ced1d6cca85baba2"
}
toolwrite4.0.04.1.0
snapshotwebdriverio-mcp:tool:snapshot
Observed interface and hashes

The page or app screen as an accessibility tree with refs, e.g. `button "Save" [ref=e3]`. Pass refs to perform_actions for several steps, or to click_element/set_value/select_option for one. Default: interactive elements only, plain text is dropped; full: true shows it. find returns only the parts of the page that contain the text (with their refs); full: true includes all text; viewport: true limits it to what is on screen (not together with find).

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "find": {
      "description": "Text to look for",
      "type": "string"
    },
    "full": {
      "description": "Include text, not just interactive elements",
      "type": "boolean"
    },
    "scope": {
      "description": "Only below this ref or selector",
      "type": "string"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    },
    "viewport": {
      "description": "Only what is on screen",
      "type": "boolean"
    }
  },
  "type": "object"
}
sha256:9c0ec4637526b5326bcc2f261b2539ba277e6066a75ed2b292381c1893b987af

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:c835908b9ab8e2946ca6e9d02ce07c06bfc957dabc84a2b712b7e775221dc5c2

Interface hash: sha256:ca5432e74818d95949f564c5417c937e0e1135895c04270ddef7a31b84522133

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/snapshot",
  "title": "Page Snapshot",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "snapshot"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:f8ab7fc0df7cc76b47f7d78b84fb9fca23e7abffe188e6efad45f36e5f778d42"
}
toolread4.0.04.1.0
start_sessionwebdriverio-mcp:tool:start_session
Observed interface and hashes

Starts a browser, Electron app or mobile app session (closes the active one unless onExisting: "keep"). Browsers run headless at 1280x800 by default; pass navigationUrl to open a page right away. attach: true connects to a running Chrome via CDP.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "app": {
      "description": "Cloud app URL from upload_app (bs://, storage:filename=, lt://, tb://, cloud:<name>)",
      "type": "string"
    },
    "appPath": {
      "description": "Mobile: local .app/.apk/.ipa",
      "type": "string"
    },
    "appWaitActivity": {
      "description": "Android launch activity to wait for",
      "type": "string"
    },
    "appiumConfig": {
      "description": "Local Appium server",
      "properties": {
        "host": {
          "type": "string"
        },
        "path": {
          "type": "string"
        },
        "port": {
          "type": "number"
        },
        "protocol": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "attach": {
      "description": "Attach to a running Chrome (attachConfig, default localhost:9222)",
      "type": "boolean"
    },
    "attachConfig": {
      "properties": {
        "host": {
          "default": "localhost",
          "type": "string"
        },
        "port": {
          "default": 9222,
          "type": "number"
        }
      },
      "type": "object"
    },
    "autoAcceptAlerts": {
      "description": "Mobile, default true",
      "type": "boolean"
    },
    "autoDismissAlerts": {
      "type": "boolean"
    },
    "autoGrantPermissions": {
      "description": "Mobile, default true",
      "type": "boolean"
    },
    "automationName": {
      "enum": [
        "XCUITest",
        "UiAutomator2"
      ],
      "type": "string"
    },
    "browser": {
      "description": "Required for platform browser",
      "enum": [
        "chrome",
        "firefox",
        "edge",
        "safari"
      ],
      "type": "string"
    },
    "browserVersion": {
      "description": "Cloud only",
      "type": "string"
    },
    "browserstackLocal": {
      "anyOf": [
        {
          "const": "external",
          "type": "string"
        },
        {
          "type": "boolean"
        }
      ],
      "description": "Deprecated: tunnel"
    },
    "capabilities": {
      "additionalProperties": {},
      "description": "Extra capabilities to merge, e.g. \"wdio:electronServiceOptions\"",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "deviceName": {
      "description": "Mobile: device, emulator or simulator name (required)",
      "type": "string"
    },
    "deviceQuery": {
      "description": "Digital.ai mobile device query",
      "type": "string"
    },
    "electronDeeplinkScheme": {
      "description": "Electron: URI scheme (no \":\") allowed for trigger_electron_deeplink",
      "pattern": "^[A-Za-z][A-Za-z0-9+.-]*$",
      "type": "string"
    },
    "electronRootDir": {
      "description": "Electron: project root for Builder/Forge discovery",
      "minLength": 1,
      "type": "string"
    },
    "fullReset": {
      "type": "boolean"
    },
    "headless": {
      "type": "boolean"
    },
    "name": {
      "description": "Name for this session, unique among live sessions. Target it from other tools with session: <name>.",
      "minLength": 1,
      "type": "string"
    },
    "navigationUrl": {
      "description": "URL to open after starting",
      "type": "string"
    },
    "networkLogs": {
      "description": "Local Chromium performance log capture (default from WDIO_MCP_NETWORK_LOGS or \"none\")",
      "enum": [
        "none",
        "failures",
        "all"
      ],
      "type": "string"
    },
    "newCommandTimeout": {
      "default": 300,
      "description": "Appium, seconds",
      "minimum": 0,
      "type": "number"
    },
    "noReset": {
      "type": "boolean"
    },
    "onExisting": {
      "default": "close",
      "description": "close (default) replaces the active session. keep is an explicit opt-in to run this session alongside the existing ones; the new session is NOT made the default when one exists, so target it with session: <name>.",
      "enum": [
        "close",
        "keep"
      ],
      "type": "string"
    },
    "os": {
      "description": "Cloud browser OS, provider-native, passed as-is: BrowserStack \"OS X\"/\"Windows\", Sauce Labs and TestMu \"macOS\"/\"Windows\", TestingBot \"SEQUOIA\"/\"WIN11\"",
      "type": "string"
    },
    "osVersion": {
      "description": "Cloud browser OS version, provider-native: BrowserStack and TestMu \"Sequoia\", Sauce Labs \"15\", Windows \"11\"; omit for TestingBot",
      "type": "string"
    },
    "platform": {
      "enum": [
        "browser",
        "electron",
        "ios",
        "android"
      ],
      "type": "string"
    },
    "platformVersion": {
      "description": "Mobile OS version, e.g. \"17.0\"",
      "type": "string"
    },
    "provider": {
      "default": "local",
      "description": "Default local. Cloud providers read credentials from env. external: a W3C WebDriver endpoint (webdriverConfig).",
      "enum": [
        "local",
        "browserstack",
        "saucelabs",
        "testmu",
        "testingbot",
        "digitalai",
        "external"
      ],
      "type": "string"
    },
    "region": {
      "default": "eu-central-1",
      "description": "Sauce Labs only",
      "enum": [
        "us-west-1",
        "eu-central-1",
        "apac-southeast-1"
      ],
      "type": "string"
    },
    "reporting": {
      "description": "Cloud reporting labels",
      "properties": {
        "build": {
          "type": "string"
        },
        "project": {
          "type": "string"
        },
        "session": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "saucelabsLocal": {
      "anyOf": [
        {
          "const": "external",
          "type": "string"
        },
        {
          "type": "boolean"
        }
      ],
      "description": "Deprecated: tunnel"
    },
    "testmuLocal": {
      "anyOf": [
        {
          "const": "external",
          "type": "string"
        },
        {
          "type": "boolean"
        }
      ],
      "description": "Deprecated: tunnel"
    },
    "trace": {
      "description": "Save a Playwright-compatible trace zip to .trace/ on close_session",
      "type": "boolean"
    },
    "tunnel": {
      "anyOf": [
        {
          "const": "external",
          "type": "string"
        },
        {
          "type": "boolean"
        }
      ],
      "description": "Cloud: true starts a tunnel, \"external\" uses a running one"
    },
    "tunnelName": {
      "type": "string"
    },
    "udid": {
      "description": "iOS real device UDID",
      "type": "string"
    },
    "webdriverConfig": {
      "description": "provider external only",
      "properties": {
        "hostname": {
          "default": "127.0.0.1",
          "type": "string"
        },
        "path": {
          "default": "/",
          "type": "string"
        },
        "port": {
          "default": 4445,
          "type": "number"
        },
        "protocol": {
          "default": "http",
          "type": "string"
        }
      },
      "type": "object"
    },
    "windowHeight": {
      "default": 800,
      "maximum": 2160,
      "minimum": 400,
      "type": "number"
    },
    "windowWidth": {
      "default": 1280,
      "maximum": 3840,
      "minimum": 400,
      "type": "number"
    }
  },
  "required": [
    "platform"
  ],
  "type": "object"
}
sha256:662cdc90966047530d1ec4fb9a5d0f5ad003568b65a7b0ac1a72a02fed3aa229

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:7f0ea2beb1e014a51801da6469440959fae3bdb294f7f11fe5f6ca25bcc228d2

Interface hash: sha256:35b86f66489c81f229f55b8047038f020b14b4345c8e12f48fd0d50cc7ba03fe

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/start_session",
  "title": "Start Session",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "start_session"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:c75104eb16e4246322681a37ef32c0b9821c79f9e159b19f0600411c3d4e6819"
}
toolwrite4.0.04.1.0
switch_framewebdriverio-mcp:tool:switch_frame
Observed interface and hashes

Switches into an iframe (ref or selector), or back to the top page when selector is omitted. Later tools act inside the frame until you switch back. Returns the frame's elements.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "selector": {
      "description": "Ref or selector of the iframe; omit for the top page",
      "type": "string"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:1808e649e5c532f0b6c2bc34f151c50e54d78be3caec5a1cfddda7a5d4ead5d2

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:a17d2e590ab91400ba77c4f9f167cceac4e93c0fffc54085c604442708e4dafd

Interface hash: sha256:9b55e6eac6e3cc69df256840979ff7f8830fee2023e6597d62624af5c304396f

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/switch_frame",
  "title": "Switch Frame",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "switch_frame"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:1d9b08f4e32fe9525be6bc5b52d2f336ffe4c343cbfad69355e854ffa7167b57"
}
toolwrite4.0.04.1.0
switch_tabwebdriverio-mcp:tool:switch_tab
Observed interface and hashes

Switches to a tab by handle or 0-based index (see get_tabs). Later tools act on that tab.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "handle": {
      "description": "Window handle to switch to",
      "type": "string"
    },
    "index": {
      "description": "0-based tab index to switch to",
      "maximum": 9007199254740991,
      "minimum": 0,
      "type": "integer"
    },
    "session": {
      "description": "Target session: map name or sessionId. Omit to use the default session.",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:03a188ce0db1873a1c7b983e4ef18c50723d9750503a43c8cb097ed1df4043bb

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:01df06ff558f7b46e5298a41bb5699f60dfb7cad7637ddd76f4688e3ef5e8a6a

Interface hash: sha256:662f9bcf5fb24688c1269680ed5eb382132ab641a64860e06c66f68be7b2a37d

Other observed Modelara metadata
{
  "id": "mcp:@wdio/mcp/switch_tab",
  "title": "Switch Browser Tab",
  "source": {
    "type": "mcp",
    "server": "@wdio/mcp",
    "operation": "switch_tab"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:a9a584f45492f0156c0736c90386afaafe9eebcc169955e8c9cd56c52f516a75"
}
toolwrite4.0.04.1.0

STATIC COMPARISONS

Release history

2 release transitions
  1. 0 added0 removed15 schema0 write0 destructive0 unknown

    Nov 16, 2026· Pending human review

  2. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 16, 2026· Automated static analysis