# What changed in chrome-devtools-mcp

> 69 changes in chrome-devtools-mcp 1 from its official release notes, upgrade guides and advisories: 3 breaking, 5 security, 17 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/npm/chrome-devtools-mcp/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## chrome-devtools-mcp 1

### Breaking changes

- Rejects hostname regexp groups in URL pattern options. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Rejects hostname regexp groups in URL pattern options. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Rejects unrestricted paths when an explicit workspace is configured. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)

### Security

- Client-supplied values are escaped in logs and errors. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Hardens serialization of third-party tool results. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Enforces URL policy across redirects. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Chrome DevTools for agents: daemon.pid write follows symlinks in /tmp fallback runtime directory (1.1.0) — [security advisory](https://github.com/advisories/GHSA-3PVJ-JV98-QHJQ)
- chrome-devtools-mcp: validatePath() does not canonicalize symlinks before enforcing roots (1.1.0) — [security advisory](https://github.com/advisories/GHSA-8QF9-62X2-82PP)

### New APIs and options

- Heap snapshots can now be analyzed without a browser connection. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Adds a Kimi Code plugin manifest. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Adds a flag to configure how much navigation history is retained. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Adds a method to reload configuration. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Introduces layered server configuration for live reload. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Slim mode screenshots now support a filepath. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Independent tool calls can run in parallel with a TaskRunner. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Adds opt-in matching against visible text. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Adds an option to reload configuration when the config file changes. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Adds an MCP tool for analyzing heap snapshot contexts. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Adds a truncation option for long names in heap snapshot comparisons. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- The config file is discovered in predefined locations. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- ConfigWatcher watches for changes to the configuration file. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Supports evaluating scripts from local files. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Adds a flag to reject file: URL navigations. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Adds support for truncating heap snapshot details. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Adds the ignoreCache option to performance_start_trace. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)

### Performance

- Loads heap snapshots in parallel during comparisons. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)

### Behavior and default changes

- Changes to this URL restriction can now be reloaded. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Changes to this URL restriction can now be reloaded. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Detailed diffs are paginated, and objects for each class are sorted by self size. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Heap snapshot tools now paginate by default. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Page-scoped tools can run in parallel when targeting different pages. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Adds pagination to heap snapshot comparisons. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Config defaults are resolved after merging CLI options and the config file. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Long names are truncated to 100 characters by default. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Pages opened by input actions are reported. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Returns failing audits and their DOM nodes inline. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- FFmpeg-free screencast tools are enabled by default. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Text snapshots include less StaticText noise and skip more redundant data. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)

### Tooling

- Supports emulating additional CSS media features. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Supports debugging WebMCP tools in third-party developer tools. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)

### Fixes and other changes

- Non-Error values thrown or rejected during script evaluation are surfaced. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Script evaluation is blocked while a dialog is open. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- The unsupported websocket resource type is removed from the request filter. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Navigation rejects devtools:// URLs. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- New pages reject devtools:// URLs. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- When pageSize is omitted and pageIdx is 0, pagination returns all items. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- A warning is issued when screenshot dimensions exceed the 16384px limit. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- The submitKey value is validated before typing. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- Config files now accept native JSON objects for WebSocket headers. (1.12.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.12.0)
- CLI mode honors an explicit false value. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- A healthy browser is no longer closed when a tool call outlasts 60 seconds. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- The option works when connecting to an existing browser and is passed to the target filter. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Improves config support for the CLI. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Positional values beginning with a hyphen are passed through to tools. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Allows stopping the CLI if a command fails. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Reports an unknown page ID before applying the last-page guard. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Surfaces WebMCP tool exceptions in the result. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Rounds category scores and shows unscored categories as n/a. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Reports an error when called without an active trace. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Rejects non-positive resize dimensions. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Propagates a failed responseFilePath write error instead of reporting the body unavailable. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Screencasts are recorded at the page's device pixel size. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Downscaled screenshot coordinates account for scroll offsets. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Slim responses include errors. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Rejects contradictory pagination options. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Tool calls stuck after a dead browser connection fail fast. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Rejects multiple file paths when the input accepts a single file. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Rejects named groups in URL patterns and supports partial IPv4 patterns. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)
- Rejects non-positive viewport dimensions. (1.11.0) — [release notes](https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.11.0)