v0.6.0

New tools (38 → 43)

Responsive / mobile testing

• browser_set_viewport — resize the viewport mid-session to any width×height
• browser_open — new width, height, and user_agent parameters; start a session already at mobile resolution with the correct UA string
• browser_status — now reports current viewport size

Common presets: 390×844 (iPhone 14), 375×667 (iPhone SE), 768×1024 (iPad)

File upload

• browser_upload_file — send a local file to <input type="file">; works even when the input is visually hidden

Web storage

• browser_get_storage — read all or one key from localStorage / sessionStorage
• browser_set_storage — inject tokens, flags, or fixtures into web storage
• browser_clear_storage — remove one key or clear an entire storage area

Performance timing

• devtools_performance — Navigation Timing API: TTFB, DOMContentLoaded, full load time, DNS, connect duration; optional per-resource breakdown (no BiDi required)

Other changes

• Repo installation instructions updated to use signed-by GPG keyring
• AGENTS.md updated with current architecture guide and full tool list

v0.5.2

What's changed

Documentation

• Added AGENTS.md with architecture guide and links to related MCP servers
• Added Related MCP Servers by VitexSoftware section to README
• Updated SVG icon (redesigned to teal/black chain-link + monogram style)
• Fixed manpage: version, date, repository URL (Vitexus → VitexSoftware)

CI / packaging fixes

• Drop debian:forky and ubuntu:resolute from CI matrix (broken python3-fastmcp dep chains)
• Stub fastmcp in conftest.py so unit tests pass in Debian build environments without the full dep tree
• Trim Build-Depends — python3-fastmcp is a runtime dep only
• Skip TestToolCount automatically when fastmcp is stubbed

v0.5.1 — new tools, bug fixes, docs, tests, manpage

New tools (8)

Tool	Purpose
browser_scroll	Scroll page to coords, by offset, or element into view
browser_press_key	Send enter / tab / escape / arrow / F-keys
browser_hover	Mouse hover for :hover states, tooltips, and dropdowns
browser_find_elements	Enumerate all elements matching a CSS selector
browser_accept_dialog	Accept a JS alert() / confirm() / prompt()
browser_dismiss_dialog	Dismiss a JS confirm() / prompt()
browser_get_cookies	Read all cookies for the current page
browser_set_cookie	Inject a cookie (auth tokens, session IDs)

Improvements to existing tools

• browser_open — URL is now optional (default about:blank)
• browser_navigate / browser_open — bare hostnames (e.g. example.com) get https:// prepended automatically
• browser_execute_js — returns JSON-serialised result instead of str()
• browser_wait — new condition parameter: visible (default), clickable, present, or text:<string>
• devtools_network_all — new limit= parameter to cap context-window size on busy pages

Bug fixes

• ctx.state → ctx.lifespan_context — FastMCP 2.x compatibility (all tools were broken without this)
• _resolve_geckodriver() returned None instead of the actual path when geckodriver was found on system PATH, causing Selenium to fall back to the broken selenium-manager
• driver.network AttributeError was caught by the outer handler, disabling all BiDi (including console and JS error capture) instead of just network capture

Packaging

• Manpage: debian/mcp-server-webdriver.1 with TOOLS (37), ENVIRONMENT, GECKODRIVER RESOLUTION, and USE CASES sections
• debian/rules now runs unit tests during dh_auto_test

Tests

tests/test_server.py — 21 unit tests + 20 integration tests covering:
argument parsing, --help, geckodriver resolution, URL normalisation, key map, tool registry (37 tools), and full browser integration flow

Documentation

• README: "What it does" intro + 10 use-case scenarios with tool sequences
• Manpage: all 37 tools documented with parameters and a USE CASES section

Installation

echo "deb http://repo.vitexsoftware.com trixie main" \
  | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update && sudo apt install python3-mcp-server-webdriver

Or download the .deb from this release and install directly:

sudo dpkg -i python3-mcp-server-webdriver_0.5.1-1_all.deb