brave-mcp 1.7.0 → 1.7.1

package/README.md

@@ -1,16 +1,62 @@
 # Brave DevTools for agents
 
-[![npm brave-mcp package](https://img.shields.io/npm/v/brave-mcp.svg)](https://npmjs.org/package/brave-mcp)
+**Full Chrome DevTools MCP parity, rebuilt for Brave.**
 
-Brave DevTools for agents (`brave-mcp`) lets your coding agent (such as Antigravity, Claude, Cursor or Copilot)
-control and inspect a live Brave browser. It acts as a Model-Context-Protocol
-(MCP) server, giving your AI coding assistant access to the full power of
-Brave DevTools for reliable automation, in-depth debugging, and performance analysis.
-A [CLI](docs/cli.md) is also provided for use without MCP.
+[![CI](https://github.com/triuzzi/brave-devtools-mcp/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/triuzzi/brave-devtools-mcp/actions/workflows/run-tests.yml)
+[![npm](https://img.shields.io/npm/v/brave-mcp.svg?logo=npm)](https://www.npmjs.com/package/brave-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/brave-mcp.svg?logo=npm)](https://www.npmjs.com/package/brave-mcp)
+[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-active-5B5BD6)](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.triuzzi%2Fbrave-mcp)
+[![npm provenance](https://img.shields.io/badge/npm-provenance-2E7D32)](https://registry.npmjs.org/-/npm/v1/attestations/brave-mcp@1.7.1)
+[![upstream](https://img.shields.io/badge/upstream-0%20commits%20behind-brightgreen)](https://github.com/triuzzi/brave-devtools-mcp/compare/ChromeDevTools:main...main)
+[![license](https://img.shields.io/github/license/triuzzi/brave-devtools-mcp)](./LICENSE)
 
-This Brave port tracks [ChromeDevTools/chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp) and preserves its complete tool surface.
+![Brave DevTools MCP: full Chrome DevTools MCP parity, rebuilt for Brave](./docs/assets/social-preview.png)
 
-## [Tool reference](./docs/tool-reference.md) | [Changelog](./CHANGELOG.md) | [Contributing](./CONTRIBUTING.md) | [Troubleshooting](./docs/troubleshooting.md) | [Design Principles](./docs/design-principles.md)
+`brave-mcp` gives Claude Code, Codex, Cursor, OpenCode, and other MCP clients direct access to Brave for browser automation, network and console debugging, performance analysis, screenshots, accessibility inspection, and memory profiling. A standalone [`brave-devtools`](docs/cli.md) CLI is included too.
+
+## Install in one command
+
+### Claude Code
+
+```bash
+claude mcp add brave-devtools --scope user -- npx -y brave-mcp@latest
+```
+
+### Cursor
+
+```bash
+cursor --add-mcp '{"name":"brave-devtools","command":"npx","args":["-y","brave-mcp@latest"]}'
+```
+
+### Codex
+
+```bash
+codex mcp add brave-devtools -- npx -y brave-mcp@latest
+```
+
+### OpenCode
+
+```bash
+opencode mcp add brave-devtools -- npx -y brave-mcp@latest
+```
+
+Restart your client, then try this prompt:
+
+> Open my app in Brave. Find console errors and failed network requests, inspect the accessibility tree, run Lighthouse, and explain the highest-impact issue.
+
+## Why use this instead of Chrome DevTools MCP?
+
+| Capability                               | `brave-mcp`                             | `chrome-devtools-mcp`                |
+| ---------------------------------------- | --------------------------------------- | ------------------------------------ |
+| Browser launched and discovered natively | Brave Release, Beta, and Nightly        | Chrome Stable, Beta, Dev, and Canary |
+| Attach to an existing browser            | Brave profiles, HTTP, or WebSocket      | Chrome profiles, HTTP, or WebSocket  |
+| Upstream DevTools features               | Full parity; currently 0 commits behind | Source implementation                |
+| Usage telemetry                          | Disabled by default                     | Enabled by default                   |
+| Standalone CLI                           | `brave-devtools`                        | `chrome-devtools`                    |
+
+Use [Chrome DevTools MCP](https://github.com/ChromeDevTools/chrome-devtools-mcp) when your target browser is Chrome. Use `brave-mcp` when your target browser is Brave and you want Brave-native discovery, profiles, channels, naming, and privacy defaults without giving up upstream features.
+
+## [Tool reference](./docs/tool-reference.md) | [Changelog](./CHANGELOG.md) | [Contributing](./CONTRIBUTING.md) | [Troubleshooting](./docs/troubleshooting.md) | [Design principles](./docs/design-principles.md)
 
 ## Key features
 

package/build/src/WaitForHelper.js

@@ -71,7 +71,7 @@ export class WaitForHelper {
         this.#stableDomTimeout = 3000 * cpuTimeoutMultiplier;
         this.#stableDomFor = 100 * cpuTimeoutMultiplier;
         this.#expectNavigationIn = 100 * cpuTimeoutMultiplier;
-        this.#navigationTimeout = 3000 * networkTimeoutMultiplier;
+        this.#navigationTimeout = Math.max(page.getDefaultNavigationTimeout(), 3000 * networkTimeoutMultiplier);
         this.#page = page;
         this.#initialUrl = page.url();
     }

package/build/src/telemetry/flagUtils.js

@@ -3,8 +3,9 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { toSnakeCase } from '../utils/string.js';
+import { DevTools } from '../third_party/index.js';
 import { stripUnderscoreBeforeNumber } from './transformation.js';
+const { StringUtilities } = DevTools.Platform;
 /**
  * For enums, log the value as uppercase.
  * We're going to have an enum for such flags with choices represented
@@ -30,7 +31,7 @@ export function computeFlagUsage(args, options) {
     const usage = {};
     for (const [flagName, config] of Object.entries(options)) {
         const value = args[flagName];
-        const snakeCaseName = stripUnderscoreBeforeNumber(toSnakeCase(flagName));
+        const snakeCaseName = stripUnderscoreBeforeNumber(StringUtilities.toSnakeCase(flagName));
         // If there isn't a default value provided for the flag,
         // we're going to log whether it's present on the args user
         // provided or not. If there is a default value, we only log presence
@@ -59,7 +60,7 @@ export function computeFlagUsage(args, options) {
 export function getPossibleFlagMetrics(options) {
     const metrics = [];
     for (const [flagName, config] of Object.entries(options)) {
-        const snakeCaseName = stripUnderscoreBeforeNumber(toSnakeCase(flagName));
+        const snakeCaseName = stripUnderscoreBeforeNumber(StringUtilities.toSnakeCase(flagName));
         // _present is always a possible metric
         metrics.push({
             name: `${snakeCaseName}_present`,

package/build/src/third_party/THIRD_PARTY_NOTICES

@@ -854,7 +854,7 @@ License: MIT
 
 Name: devtools-frontend
 URL: https://github.com/ChromeDevTools/devtools-frontend
-Version: b89284cbca3d602273b868f7183ddfc0e1e7c983
+Version: 7da4b7eeaea404a21118cd937b23a5c57c367229
 License: Apache-2.0
 
 // Copyright 2014 The Chromium Authors

package/build/src/third_party/bundled-packages.json

@@ -6,5 +6,5 @@
   "semver": "7.8.5",
   "yargs": "18.1.0",
   "puppeteer-core": "25.5.0",
-  "https://github.com/ChromeDevTools/devtools-frontend": "b89284cbca3d602273b868f7183ddfc0e1e7c983"
+  "https://github.com/ChromeDevTools/devtools-frontend": "7da4b7eeaea404a21118cd937b23a5c57c367229"
 }

package/build/src/third_party/index.js

@@ -82989,11 +82989,6 @@ const UIStrings$1h = {
 };
 const str_$1g = registerUIStrings('core/sdk/sdk-meta.ts', UIStrings$1h);
 const i18nLazyString$j = getLazilyComputedLocalizedString.bind(undefined, str_$1g);
-registerSettingExtension({
-    settingName: 'pause-on-uncaught-exception',
-    settingType: "boolean" ,
-    defaultValue: false,
-});
 registerSettingExtension({
     category: "DEBUGGER" ,
     title: i18nLazyString$j(UIStrings$1h.disableJavascript),
@@ -88522,6 +88517,8 @@ function registerCommands(inspectorBackend) {
     inspectorBackend.registerCommand("Page.setTouchEmulationEnabled", [{ "name": "enabled", "type": "boolean", "optional": false, "description": "Whether the touch event emulation should be enabled.", "typeRef": null }, { "name": "configuration", "type": "string", "optional": true, "description": "Touch/gesture events configuration. Default: current platform.", "typeRef": "Page.SetTouchEmulationEnabledRequestConfiguration" }], [], "Toggles mouse event-based touch event emulation.");
     inspectorBackend.registerEnum("Page.StartScreencastRequestFormat", { Jpeg: "jpeg", Png: "png" });
     inspectorBackend.registerCommand("Page.startScreencast", [{ "name": "format", "type": "string", "optional": true, "description": "Image compression format.", "typeRef": "Page.StartScreencastRequestFormat" }, { "name": "quality", "type": "number", "optional": true, "description": "Compression quality from range [0..100].", "typeRef": null }, { "name": "maxWidth", "type": "number", "optional": true, "description": "Maximum screenshot width.", "typeRef": null }, { "name": "maxHeight", "type": "number", "optional": true, "description": "Maximum screenshot height.", "typeRef": null }, { "name": "everyNthFrame", "type": "number", "optional": true, "description": "Send every n-th frame.", "typeRef": null }], [], "Starts sending each frame using the `screencastFrame` event.");
+    inspectorBackend.registerCommand("Page.startScreenRecording", [{ "name": "audio", "type": "boolean", "optional": true, "description": "", "typeRef": null }, { "name": "maxWidth", "type": "number", "optional": true, "description": "Maximum frame width in pixels.", "typeRef": null }, { "name": "maxHeight", "type": "number", "optional": true, "description": "Maximum frame height in pixels.", "typeRef": null }, { "name": "frameRate", "type": "number", "optional": true, "description": "Maximum frame rate in frames per second.", "typeRef": null }], ["stream"], "Starts screencast video recording.");
+    inspectorBackend.registerCommand("Page.stopScreenRecording", [], ["stream"], "Stops screencast video recording.");
     inspectorBackend.registerCommand("Page.stopLoading", [], [], "Force the page stop all navigations and pending resource fetches.");
     inspectorBackend.registerCommand("Page.crash", [], [], "Crashes renderer on the IO thread, generates minidumps.");
     inspectorBackend.registerCommand("Page.close", [], [], "Tries to close page, running its beforeunload hooks, if any.");
@@ -88824,7 +88821,7 @@ function registerCommands(inspectorBackend) {
     inspectorBackend.registerType("WebAudio.AudioParam", [{ "name": "paramId", "type": "string", "optional": false, "description": "", "typeRef": "WebAudio.GraphObjectId" }, { "name": "nodeId", "type": "string", "optional": false, "description": "", "typeRef": "WebAudio.GraphObjectId" }, { "name": "contextId", "type": "string", "optional": false, "description": "", "typeRef": "WebAudio.GraphObjectId" }, { "name": "paramType", "type": "string", "optional": false, "description": "", "typeRef": "WebAudio.ParamType" }, { "name": "rate", "type": "string", "optional": false, "description": "", "typeRef": "WebAudio.AutomationRate" }, { "name": "defaultValue", "type": "number", "optional": false, "description": "", "typeRef": null }, { "name": "minValue", "type": "number", "optional": false, "description": "", "typeRef": null }, { "name": "maxValue", "type": "number", "optional": false, "description": "", "typeRef": null }]);
     inspectorBackend.registerEnum("WebAuthn.AuthenticatorProtocol", { U2f: "u2f", Ctap2: "ctap2" });
     inspectorBackend.registerEnum("WebAuthn.Ctap2Version", { Ctap2_0: "ctap2_0", Ctap2_1: "ctap2_1", Ctap2_2: "ctap2_2" });
-    inspectorBackend.registerEnum("WebAuthn.AuthenticatorTransport", { Usb: "usb", Nfc: "nfc", Ble: "ble", Cable: "cable", Internal: "internal" });
+    inspectorBackend.registerEnum("WebAuthn.AuthenticatorTransport", { Usb: "usb", Nfc: "nfc", Ble: "ble", Cable: "cable", Hybrid: "hybrid", SmartCard: "smart-card", Internal: "internal" });
     inspectorBackend.registerEvent("WebAuthn.credentialAdded", ["authenticatorId", "credential"]);
     inspectorBackend.registerEvent("WebAuthn.credentialDeleted", ["authenticatorId", "credentialId"]);
     inspectorBackend.registerEvent("WebAuthn.credentialUpdated", ["authenticatorId", "credential"]);
@@ -92330,6 +92327,11 @@ const generatedProperties = [
         "runtime_flag_status": "stable"
     },
     {
+        "devtools_keywords": [
+            "none",
+            "move",
+            "no-drag"
+        ],
         "name": "app-region"
     },
     {
@@ -96467,7 +96469,8 @@ const generatedProperties = [
             "inline",
             "both",
             "mandatory",
-            "proximity"
+            "proximity",
+            "pair"
         ],
         "name": "scroll-snap-type"
     },
@@ -97382,6 +97385,10 @@ const generatedProperties = [
         "name": "will-change"
     },
     {
+        "devtools_keywords": [
+            "none",
+            "move"
+        ],
         "inherited": true,
         "keywords": [
             "none",
@@ -97719,6 +97726,13 @@ const generatedPropertyValues = {
             "none"
         ]
     },
+    "app-region": {
+        "values": [
+            "none",
+            "move",
+            "no-drag"
+        ]
+    },
     "appearance": {
         "values": [
             "auto",
@@ -99998,7 +100012,8 @@ const generatedPropertyValues = {
             "inline",
             "both",
             "mandatory",
-            "proximity"
+            "proximity",
+            "pair"
         ]
     },
     "scroll-target-group": {
@@ -100512,8 +100527,7 @@ const generatedPropertyValues = {
     "window-drag": {
         "values": [
             "none",
-            "move",
-            "no-drag"
+            "move"
         ]
     },
     "word-break": {
@@ -101050,9 +101064,6 @@ class CSSMetadata {
             if (Boolean(runtimeFlagStatus) && runtimeFlagStatus !== 'stable') {
                 continue;
             }
-            if (!CSS.supports(propertyName, 'initial')) {
-                continue;
-            }
             this.#values.push(propertyName);
             if (property.inherited) {
                 this.#inherited.add(propertyName);
@@ -101091,7 +101102,7 @@ class CSSMetadata {
         }
         const commonKeywordSet = new Set(CommonKeywords);
         for (const propertyName of this.#longhands.keys()) {
-            if (propertyName === 'all' || propertyValueSets.has(propertyName)) {
+            if (propertyName === 'all' || propertyName in generatedPropertyValues) {
                 continue;
             }
             const longhands = this.#longhands.get(propertyName);
@@ -101099,6 +101110,10 @@ class CSSMetadata {
                 continue;
             }
             const values = new Array();
+            const propertyValueSet = propertyValueSets.get(propertyName);
+            if (propertyValueSet) {
+                values.push(...propertyValueSet);
+            }
             for (const longhand of longhands) {
                 const longhandValues = propertyValueSets.get(longhand);
                 if (!longhandValues) {
@@ -101119,11 +101134,6 @@ class CSSMetadata {
                     }
                 }
             }
-            for (const commonKeyword of CommonKeywords) {
-                if (!values.has(commonKeyword) && CSS.supports(propertyName, commonKeyword)) {
-                    values.add(commonKeyword);
-                }
-            }
             this.#propertyValues.set(propertyName, [...values]);
         }
         for (const name of this.#valuesSet) {
@@ -107348,6 +107358,11 @@ const pauseOnCaughtExceptionSettingDescriptor = {
     type: "boolean" ,
     defaultValue: false,
 };
+const pauseOnUncaughtExceptionSettingDescriptor = {
+    name: 'pause-on-uncaught-exception',
+    type: "boolean" ,
+    defaultValue: false,
+};
 
 // Copyright 2020 The Chromium Authors
 class IOModel extends SDKModel {
@@ -121307,7 +121322,8 @@ class DebuggerModel extends SDKModel {
         settings.resolve(pauseOnCaughtExceptionSettingDescriptor)
             .addChangeListener(this.pauseOnExceptionStateChanged, this);
         this.#skipAllPausesSetting.addChangeListener(this.skipAllPausesChanged, this);
-        settings.moduleSetting('pause-on-uncaught-exception').addChangeListener(this.pauseOnExceptionStateChanged, this);
+        settings.resolve(pauseOnUncaughtExceptionSettingDescriptor)
+            .addChangeListener(this.pauseOnExceptionStateChanged, this);
         settings.moduleSetting('disable-async-stack-traces').addChangeListener(this.asyncStackTracesStateChanged, this);
         settings.moduleSetting('breakpoints-active').addChangeListener(this.breakpointsActiveChanged, this);
         if (!target.suspended()) {
@@ -121463,7 +121479,7 @@ class DebuggerModel extends SDKModel {
         const settings = this.target().targetManager().settings;
         const pauseOnCaughtEnabled = settings.resolve(pauseOnCaughtExceptionSettingDescriptor).get();
         let state;
-        const pauseOnUncaughtEnabled = settings.moduleSetting('pause-on-uncaught-exception').get();
+        const pauseOnUncaughtEnabled = settings.resolve(pauseOnUncaughtExceptionSettingDescriptor).get();
         if (pauseOnCaughtEnabled && pauseOnUncaughtEnabled) {
             state = "all" ;
         }
@@ -121673,6 +121689,10 @@ class DebuggerModel extends SDKModel {
             this.resume();
             return;
         }
+        if (this.#skipAllPausesSetting.get()) {
+            this.resume();
+            return;
+        }
         const pausedDetails = new DebuggerPausedDetails(this, callFrames, reason, auxData, breakpointIds, asyncStackTrace, asyncStackTraceId);
         if (this.continueToLocationCallback) {
             const callback = this.continueToLocationCallback;
@@ -121876,6 +121896,8 @@ class DebuggerModel extends SDKModel {
         settings.resolve(pauseOnCaughtExceptionSettingDescriptor)
             .removeChangeListener(this.pauseOnExceptionStateChanged, this);
         this.#skipAllPausesSetting.removeChangeListener(this.skipAllPausesChanged, this);
+        settings.resolve(pauseOnUncaughtExceptionSettingDescriptor)
+            .removeChangeListener(this.pauseOnExceptionStateChanged, this);
         settings.moduleSetting('disable-async-stack-traces').removeChangeListener(this.asyncStackTracesStateChanged, this);
     }
     async suspendModel() {
@@ -168000,7 +168022,7 @@ const NativeFunctions = [
     },
     {
         name: "importNode",
-        signatures: [["node", "?options"], ["node", "?deep"]]
+        signatures: [["node", "?options"]]
     },
     {
         name: "queryCommandEnabled",

package/build/src/tools/pwa.js

@@ -98,6 +98,10 @@ export const launchPwa = defineTool({
     handler: async (request, response, context) => {
         const { manifestId, url } = request.params;
         const page = await context.launchPWA({ manifestId, url });
+        if (url) {
+            const expectedUrl = new URL(url).href;
+            await page.waitForFunction(requestedUrl => globalThis.location.href === requestedUrl, { timeout: 30_000 }, expectedUrl);
+        }
         response.appendResponseLine(`Launched PWA with manifest ID: ${manifestId} (${page.url()})`);
         response.setIncludePages(true);
     },

package/build/src/version.js

@@ -5,6 +5,6 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const VERSION = '1.7.0';
+export const VERSION = '1.7.1';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-mcp",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "MCP server and CLI for Brave DevTools",
   "type": "module",
   "bin": {

package/build/src/utils/string.js

@@ -1,37 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Converts a given string to snake_case.
- * This function handles camelCase, PascalCase, and acronyms, including transitions between letters and numbers.
- * It uses Unicode-aware regular expressions (`\p{L}`, `\p{N}`, `\p{Lu}`, `\p{Ll}` with the `u` flag)
- * to correctly process letters and numbers from various languages.
- *
- * @param text The input string to convert to snake_case.
- * @returns The snake_case version of the input string.
- */
-export function toSnakeCase(text) {
-    if (!text) {
-        return '';
-    }
-    // First, handle case-based transformations to insert underscores correctly.
-    // 1. Add underscore between a letter and a number.
-    //    e.g., "version2" -> "version_2"
-    // 2. Add underscore between an uppercase letter sequence and a following uppercase+lowercase sequence.
-    //    e.g., "APIFlags" -> "API_Flags"
-    // 3. Add underscore between a lowercase/number and an uppercase letter.
-    //    e.g., "lastName" -> "last_Name", "version_2Update" -> "version_2_Update"
-    // 4. Replace sequences of non-alphanumeric with a single underscore
-    // 5. Remove any leading or trailing underscores.
-    const result = text
-        .replace(/(\p{L})(\p{N})/gu, '$1_$2') // 1
-        .replace(/(\p{Lu}+)(\p{Lu}\p{Ll})/gu, '$1_$2') // 2
-        .replace(/(\p{Ll}|\p{N})(\p{Lu})/gu, '$1_$2') // 3
-        .toLowerCase()
-        .replace(/[^\p{L}\p{N}]+/gu, '_') // 4
-        .replace(/^_|_$/g, ''); // 5
-    return result;
-}
-//# sourceMappingURL=string.js.map