webdriverio/mcp releases

3.4.4 (2026-05-06)

3.4.3 (2026-05-06)

Bug Fixes

• xmldom: Fix type errors by importing XMLDocument, XMLElement, XMLNode from @xmldom/xmldom (c11c204)

3.4.2 (2026-05-06)

3.4.1 (2026-04-30)

Refactoring

• Add annotation support for tools to enhance metadata usage (c196da2)

Chores

• Security updates

3.4.0 (2026-04-27)

Features

• add switch_frame tool for iframe navigation (ae867a5)

Bug Fixes

• Include protocol in appium configuration for local provider (e1596df)

3.3.0 (2026-04-23)

Features

• Introduce StreamableHTTP transport at /mcp endpoint (e00e34c)
• Reintroduce tooling for a11y, app_state, contexts, cookies, tabs and screenshot querying (80e8bfa)

3.2.5 (2026-04-18)

Chores

• Patch security updates

3.2.4 (2026-04-09)

Chores

• Patch node module updates

3.2.3 (2026-04-06)

• Update undici to ^6.24.0 and add pnpm override configuration

3.2.2 (2026-04-01)

Bug Fixes

• Account for clickable attribute in tag filter validation (3918d22)

3.2.1 (2026-04-01)

Bug Fixes

• Add support for external BrowserStack Local tunnel handling and dynamic connection configurations (ef016bd)

3.2.0 (2026-04-01)

Features

• Integrate auto-start BrowserStack Local tunnel on session start & management (5827a99)

Bug Fixes

• Handle existing BrowserStack tunnel gracefully in start method (0084513)

3.1.1 (2026-03-30)

Bug Fixes

• Add .js extensions to type imports for ESM compatibility (0dbc8b4)

3.1.0 (2026-03-30)

Features

• Add BrowserStack Local binary resource with supporting and enhance session handling (447e266)
• Introduce BrowserStack provider and tools (2904997)

3.0.0 (2026-03-30)

⚠ BREAKING CHANGES

• Consolidated session management tooling into 1 single tool.
• Deleted tools: get_visible_element, get_accessibility_tree, get_cookie, get_tabs, get_app_state, etc. The READ tooling is mainly resources going forward.

Features

• Initial commit for v3.0.0 (37831d1)
• Re-add get_elements tool for retrieving interactable page elements (e0d94c7)

Bug Fixes

• Address issues with session management and code generation of new session tool (9864253)
• Remove ResourceTemplate usage and simplify resource handlers (59f83a5)
• Use z.coerce to correctly manage booleans with OpenCode and Codex (ff37196)

Refactoring

• Refine session lifecycle handling and simplify logic (4a301fe)
• Separate MCP resources from tools (e1be10f)

2.5.3 (2026-03-20)

Bug Fixes

• Add authentication step for MCP Registry publishing (610e364)
• Change mcp-publisher installation method (94d1d11)

2.5.2 (2026-03-20)

Features

• Add launch_chrome tool for launching Chrome with remote debugging (eab139c)

2.5.1 (2026-03-20)

Security updates:

• Bump fast-xml-parser to 5.5.7, add fast-xml-builder and path-expression-matcher, and update strnum to 2.2.1
• Bump hono to version 4.12.8
• Bump undici versions to 6.24.1 and 7.24.5
• Bump minimatch versions
• Bump basic-ftp to 5.2.0

2.5.0 (2026-03-18)

Bug Fixes

• Use correct abstraction for attach_browser, start_app_session, start_browser tools (9cebdbd)

Refactoring

• Mark tool errors with isError flag for consistent error detection and handling throughout the codebase (186a03a)
• Separate session steps (in JSON) and code generation (in JS) in Resources (ad7ff03)

2.4.1 (2026-03-17)

Features

• implement session step recording, history lifecycle, and WebdriverIO code generation (6c41763)

Bug Fixes

• Use browser.$() for element instead of $() (630201b)

2.4.0 (2026-03-17)

Features

• add attach_browser tool for CDP port connection (5ad9923)
• add emulate_device tool with BiDi guard and restore support (49e8b77)
• add userDataDir param to attach_browser (default: /tmp/chrome-debug) (7204dd0)

2.3.1 (2026-03-12)

Features

• Default browser tool to headless mode and improve script usage guidance (4ba256b)

2.3.0 (2026-02-24)

Features

• allow custom appium capabilities in start_app_session (5d8f91e)
• allow start_browser custom capabilities (8f10b60)
• Enhance browser snapshot scripts with predefined selectors and removed noisy properties (fd38790)

2.2.1 (2026-02-08)

Bug Fixes

• Improve XML node comparison logic for cross-traversal compatibility (11e8291)

2.2.0 (2026-02-05)

Features

• Add snapshot subpath export and include lightweight element utilities (e6afa09)
• Add browser accessibility tree support and improve element handling (97a4a0f)
• Rework mobile locator generation (7e290e1)

Refactoring

• Modularize and clean up locator generation and XML parsing components (e09e9aa)

2.1.0 (2026-01-27)

Performance

• Use uniform field structures for TOON tabular format across tools and scripts (1b70736)

2.0.0 (2026-01-23)

⚠ BREAKING CHANGES

• Removed deprecated tools (find_element, getElementText, longPress, isDisplayed, clickViaText, etc.) and unused utilities (mobile-selectors, get_orientation, lock_device, etc.).

Features

• Add execute_script tool for running browser JavaScript and Appium mobile commands (ade4484)
• Add navigationUrl support to startBrowserTool and default dimensions (bae7ca7)
• Add newCommandTimeout support to session configuration (ce09399)
• Simplify tools and consolidate functionality (ae66bc4)

Refactoring

• Rename scripts for clarity and update imports (adaa015)
• Simplify cookies.tool handling and update object structures (80291ec)

1.6.1 (2026-01-22)

Performance

• Add image processing for screenshots with sharp (e396b0a)

1.6.0 (2026-01-22)

Features

• Add pagination support to get-visible-elements and get-accessibility-tree (90517e0)

Performance

• Clean up mobile selectors and introduce includeBounds options, decrease token size (187e84b)

1.5.1 (2026-01-20)

Refactoring

• Replace tool argument exports with unified tool definitions (93a0f4e)

1.5.0 (2026-01-20)

Features

• Add utility for cleaning objects and enhance element visibility tool (c85de0a)

1.4.1 (2026-01-07)

Bug Fixes

• Fix release pipeline (570f2ee)
• Remove pnpm version from release workflow (2344fe6)
• Use correct project naming for package.json (0a79f1f)

Features

• Add ESLint, TypeScript checking, and Husky for linting; update dependencies (30ccbc5)
• Add GitHub Actions for manual npm publishing, update naming, and improve documentation (6f54819)
• Migrate to pnpm instead of npm/shrinkwrap (b402fc0)