@extension.dev/mcp 4.2.2 → 4.4.0

package/dist/src/__tests__/fixtures/ready-contract.d.ts

@@ -0,0 +1,7 @@
+export declare function writeModernContract(projectPath: string, browser: string, overrides?: Record<string, unknown>): string;
+export declare function writeLegacyContract(projectPath: string, browser: string, overrides?: Record<string, unknown>): string;
+export declare function writeErrorContract(projectPath: string, browser: string): string;
+export declare function writeLegacyEngineState(projectPath: string, browser: string): {
+    legacyPortFile: string;
+    legacyTokenFile: string;
+};

package/dist/src/index.d.ts

@@ -8,11 +8,4 @@ export interface ToolModule {
 }
 export declare const tools: ToolModule[];
 export declare function startServer(): Promise<void>;
-/**
- * Human-facing subcommands for `extension-mcp <cmd>`. Unlike the MCP tools
- * (which must return promptly and so resume across calls), the bin blocks on
- * the device flow because there is a person watching the terminal. Returns a
- * process exit code. All console output goes to stderr so it never pollutes a
- * machine-readable stdout if a script captures it.
- */
 export declare function runCli(cmd: string, args: string[]): Promise<number>;

package/dist/src/lib/act.d.ts

@@ -1,26 +1,5 @@
-/**
- * Translate CLI-speak in an error message into the MCP tool surface
- * (fresh-eyes walk, friction #2). The CLI's hints say things like
- * "Run `extension dev --browser=chromium --allow-control` first" — correct
- * for a human at a terminal, a dead end for an agent that only has the MCP
- * tools. Rewrite flags to their tool-argument names so the hint is actionable
- * on the surface the caller is actually using. Result data is never touched —
- * only error/hint prose.
- */
 export declare function toMcpSpeak(text: string): string;
-/**
- * Run an `extension <verb> … --output json` act command and return its result
- * JSON as a string (the MCP tool payload). The CLI prints the control-channel
- * result frame to stdout (for ok and !ok alike); connection/no-session failures
- * go to stderr with a non-zero exit. Either way we return a JSON object.
- *
- * Per lockstep invariant #1 the act tools wrap the CLI verb rather than talking
- * to the control WS directly — so MCP behavior can never drift from the CLI.
- * Error PROSE is the one exception: hints are rewritten from CLI flags to MCP
- * tool arguments before returning (see toMcpSpeak).
- */
 export declare function runActVerb(args: string[], projectPath: string, timeoutMs?: number): Promise<string>;
-/** Shared input fields for act tools. */
 export interface ActArgs {
     projectPath: string;
     browser?: string;
@@ -29,5 +8,4 @@ export interface ActArgs {
     tab?: number;
     timeout?: number;
 }
-/** Build the trailing CLI flags common to act verbs. */
 export declare function commonFlags(args: ActArgs): string[];

package/dist/src/lib/browser-family.d.ts

@@ -0,0 +1,5 @@
+export declare const CHROMIUM_FAMILY: ReadonlySet<string>;
+export declare const GECKO_FAMILY: ReadonlySet<string>;
+export declare const WEBKIT_FAMILY: ReadonlySet<string>;
+export declare function isChromiumFamily(browser: string): boolean;
+export declare function isGeckoFamily(browser: string): boolean;

package/dist/src/lib/exec.d.ts

@@ -4,17 +4,6 @@ export interface CliResult {
     stdout: string;
     stderr: string;
 }
-/**
- * Resolve how to invoke the `extension` CLI for a given project.
- *
- * Preference order:
- * 1. The project's own `node_modules/.bin/extension` — the version the project
- *    pinned is the single source of behavior for that project (lockstep
- *    invariant), and spawning it needs no network.
- * 2. `npx extension@<pinned>` — pinned to the extension-develop version this
- *    package vendors, never a floating `latest`, so MCP behavior stays
- *    reproducible even without a project-local install.
- */
 export declare function resolveExtensionInvocation(projectDir?: string): {
     command: string;
     prefixArgs: string[];

package/dist/src/lib/launch-flags.d.ts

@@ -0,0 +1,43 @@
+export declare const LAUNCH_FLAG_SCHEMA: {
+    readonly profile: {
+        readonly type: "string";
+        readonly description: "Browser profile path, or \"false\" to reuse the default user profile. Omit for a fresh throwaway profile.";
+    };
+    readonly startingUrl: {
+        readonly type: "string";
+        readonly description: "URL the browser opens on launch";
+    };
+    readonly chromiumBinary: {
+        readonly type: "string";
+        readonly description: "Path to a custom Chromium-based binary (overrides browser)";
+    };
+    readonly geckoBinary: {
+        readonly type: "string";
+        readonly description: "Path to a custom Gecko/Firefox binary (overrides browser)";
+    };
+    readonly host: {
+        readonly type: "string";
+        readonly description: "Dev server bind host. Use 0.0.0.0 for Docker or devcontainers. Defaults to 127.0.0.1";
+    };
+    readonly publicHost: {
+        readonly type: "string";
+        readonly description: "Connectable host the browser dials for HMR and reload when it differs from the bind host";
+    };
+    readonly extensions: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: "Companion extension paths or store URLs to load alongside the project";
+    };
+};
+export interface LaunchFlagArgs {
+    profile?: string;
+    startingUrl?: string;
+    chromiumBinary?: string;
+    geckoBinary?: string;
+    host?: string;
+    publicHost?: string;
+    extensions?: string[];
+}
+export declare function launchFlagArgs(args: LaunchFlagArgs): string[];

package/dist/src/lib/session-browser.d.ts

@@ -2,6 +2,5 @@ export interface ResolvedBrowser {
     browser: string;
     source: "explicit" | "session" | "contract" | "fallback";
 }
-/** Browsers with a live session for this project (registry + disk contracts). */
 export declare function knownSessionBrowsers(projectPath: string): string[];
 export declare function resolveSessionBrowser(projectPath: string, explicit: string | undefined, fallback?: string): ResolvedBrowser;

package/dist/src/lib/validate-input.d.ts

@@ -2,10 +2,5 @@ export interface InputIssue {
     path: string;
     message: string;
 }
-/**
- * Validate tools/call arguments against a tool inputSchema. Returns an empty
- * array when the args are acceptable.
- */
 export declare function validateToolInput(inputSchema: Record<string, unknown>, args: Record<string, unknown>): InputIssue[];
-/** Frozen-style error envelope for input validation failures. */
 export declare function inputValidationError(toolName: string, issues: InputIssue[]): string;

package/dist/src/tools/build.d.ts

@@ -24,6 +24,26 @@ export declare const schema: {
                 default: boolean;
                 description: string;
             };
+            zipFilename: {
+                type: string;
+                description: string;
+            };
+            polyfill: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            silent: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            mode: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
         };
         required: string[];
     };
@@ -33,4 +53,8 @@ export declare function handler(args: {
     browser?: string;
     zip?: boolean;
     zipSource?: boolean;
+    zipFilename?: string;
+    polyfill?: boolean;
+    silent?: boolean;
+    mode?: "development" | "production" | "none";
 }): Promise<string>;

package/dist/src/tools/dev.d.ts

@@ -1,9 +1,51 @@
+import { type LaunchFlagArgs } from "../lib/launch-flags";
 export declare const schema: {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
+            allowControl: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            allowEval: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            profile: {
+                readonly type: "string";
+                readonly description: "Browser profile path, or \"false\" to reuse the default user profile. Omit for a fresh throwaway profile.";
+            };
+            startingUrl: {
+                readonly type: "string";
+                readonly description: "URL the browser opens on launch";
+            };
+            chromiumBinary: {
+                readonly type: "string";
+                readonly description: "Path to a custom Chromium-based binary (overrides browser)";
+            };
+            geckoBinary: {
+                readonly type: "string";
+                readonly description: "Path to a custom Gecko/Firefox binary (overrides browser)";
+            };
+            host: {
+                readonly type: "string";
+                readonly description: "Dev server bind host. Use 0.0.0.0 for Docker or devcontainers. Defaults to 127.0.0.1";
+            };
+            publicHost: {
+                readonly type: "string";
+                readonly description: "Connectable host the browser dials for HMR and reload when it differs from the bind host";
+            };
+            extensions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Companion extension paths or store URLs to load alongside the project";
+            };
             projectPath: {
                 type: string;
                 description: string;
@@ -22,12 +64,7 @@ export declare const schema: {
                 default: boolean;
                 description: string;
             };
-            allowControl: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-            allowEval: {
+            polyfill: {
                 type: string;
                 default: boolean;
                 description: string;
@@ -41,6 +78,7 @@ export declare function handler(args: {
     browser?: string;
     port?: number;
     noBrowser?: boolean;
+    polyfill?: boolean;
     allowControl?: boolean;
     allowEval?: boolean;
-}): Promise<string>;
+} & LaunchFlagArgs): Promise<string>;

package/dist/src/tools/doctor.d.ts

@@ -0,0 +1,22 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectPath: {
+                type: string;
+                description: string;
+            };
+            browser: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handler(args: {
+    projectPath: string;
+    browser?: string;
+}): Promise<string>;

package/dist/src/tools/preview.d.ts

@@ -1,9 +1,41 @@
+import { type LaunchFlagArgs } from "../lib/launch-flags";
 export declare const schema: {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
+            profile: {
+                readonly type: "string";
+                readonly description: "Browser profile path, or \"false\" to reuse the default user profile. Omit for a fresh throwaway profile.";
+            };
+            startingUrl: {
+                readonly type: "string";
+                readonly description: "URL the browser opens on launch";
+            };
+            chromiumBinary: {
+                readonly type: "string";
+                readonly description: "Path to a custom Chromium-based binary (overrides browser)";
+            };
+            geckoBinary: {
+                readonly type: "string";
+                readonly description: "Path to a custom Gecko/Firefox binary (overrides browser)";
+            };
+            host: {
+                readonly type: "string";
+                readonly description: "Dev server bind host. Use 0.0.0.0 for Docker or devcontainers. Defaults to 127.0.0.1";
+            };
+            publicHost: {
+                readonly type: "string";
+                readonly description: "Connectable host the browser dials for HMR and reload when it differs from the bind host";
+            };
+            extensions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Companion extension paths or store URLs to load alongside the project";
+            };
             projectPath: {
                 type: string;
                 description: string;
@@ -13,6 +45,15 @@ export declare const schema: {
                 enum: string[];
                 default: string;
             };
+            port: {
+                type: string;
+                description: string;
+            };
+            noBrowser: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
         };
         required: string[];
     };
@@ -20,4 +61,6 @@ export declare const schema: {
 export declare function handler(args: {
     projectPath: string;
     browser?: string;
-}): Promise<string>;
+    port?: number;
+    noBrowser?: boolean;
+} & LaunchFlagArgs): Promise<string>;

package/dist/src/tools/start.d.ts

@@ -1,9 +1,41 @@
+import { type LaunchFlagArgs } from "../lib/launch-flags";
 export declare const schema: {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
+            profile: {
+                readonly type: "string";
+                readonly description: "Browser profile path, or \"false\" to reuse the default user profile. Omit for a fresh throwaway profile.";
+            };
+            startingUrl: {
+                readonly type: "string";
+                readonly description: "URL the browser opens on launch";
+            };
+            chromiumBinary: {
+                readonly type: "string";
+                readonly description: "Path to a custom Chromium-based binary (overrides browser)";
+            };
+            geckoBinary: {
+                readonly type: "string";
+                readonly description: "Path to a custom Gecko/Firefox binary (overrides browser)";
+            };
+            host: {
+                readonly type: "string";
+                readonly description: "Dev server bind host. Use 0.0.0.0 for Docker or devcontainers. Defaults to 127.0.0.1";
+            };
+            publicHost: {
+                readonly type: "string";
+                readonly description: "Connectable host the browser dials for HMR and reload when it differs from the bind host";
+            };
+            extensions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Companion extension paths or store URLs to load alongside the project";
+            };
             projectPath: {
                 type: string;
                 description: string;
@@ -18,6 +50,15 @@ export declare const schema: {
                 default: boolean;
                 description: string;
             };
+            port: {
+                type: string;
+                description: string;
+            };
+            noBrowser: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
         };
         required: string[];
     };
@@ -26,4 +67,6 @@ export declare function handler(args: {
     projectPath: string;
     browser?: string;
     polyfill?: boolean;
-}): Promise<string>;
+    port?: number;
+    noBrowser?: boolean;
+} & LaunchFlagArgs): Promise<string>;

package/dist/src/tools/uninstall-browser.d.ts

@@ -0,0 +1,24 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            browser: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            all: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handler(args: {
+    browser?: string;
+    all?: boolean;
+}): Promise<string>;

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "4.2.2",
-  "description": "MCP server that lets AI agents build, run, inspect, and publish browser extensions. 28 tools for scaffolding, live DOM inspection, log streaming, and store-ready builds across Chrome, Edge, and Firefox.",
+  "version": "4.4.0",
+  "description": "MCP server that lets AI agents (Claude Code, Claude Desktop, Cursor, Copilot, Codex) build, run, inspect, and publish browser extensions. 30 tools for scaffolding, live DOM inspection, log streaming, and store-ready builds across Chrome, Edge, Firefox, Safari, and every Chromium- or Gecko-based browser (Brave, Opera, Vivaldi, Yandex, Waterfox, LibreWolf). Powered by extension.dev and Extension.js.",
+  "mcpName": "io.github.extensiondev/mcp",
   "license": "MIT",
   "author": {
     "name": "Cezar Augusto",
@@ -16,10 +17,11 @@
   "bugs": {
     "url": "https://github.com/extensiondev/mcp/issues"
   },
-  "homepage": "https://github.com/extensiondev/mcp#readme",
+  "homepage": "https://extension.dev",
   "engines": {
     "node": ">=20.18"
   },
+  "packageManager": "pnpm@10.19.0",
   "exports": {
     ".": {
       "types": "./dist/module.d.ts",
@@ -35,16 +37,31 @@
     "dist",
     "bin",
     "claude",
+    ".claude-plugin",
+    "server.json",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "watch": "rslib build --watch",
+    "compile": "rslib build",
+    "build": "pnpm run compile",
+    "start": "node bin/extension-mcp.js",
+    "test": "vitest run",
+    "prepack": "node scripts/readme-logo-width.mjs npm",
+    "postpack": "node scripts/readme-logo-width.mjs github",
+    "prepublishOnly": "pnpm run test && pnpm run compile"
+  },
   "publishConfig": {
     "access": "public",
+    "provenance": true,
     "registry": "https://registry.npmjs.org"
   },
   "keywords": [
     "mcp",
+    "mcp-server",
     "model-context-protocol",
     "ai-agent",
     "agents",
@@ -52,23 +69,28 @@
     "claude-code",
     "claude-desktop",
     "cursor",
+    "github-copilot",
+    "codex",
     "browser-extension",
     "chrome-extension",
     "firefox-addon",
+    "edge-extension",
+    "safari-web-extension",
     "manifest-v3",
     "webextension",
     "cross-browser",
     "developer-tools",
-    "extension.dev"
+    "extension.dev",
+    "extension.js"
   ],
   "dependencies": {
     "@extension.dev/core": "^0.2.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "browser-extension-manifest-fields": "^2.2.9",
     "cross-spawn": "^7.0.6",
-    "extension-create": "^4.0.8",
-    "extension-develop": "^4.0.8",
-    "extension-install": "^4.0.8",
+    "extension-create": "^4.0.11",
+    "extension-develop": "^4.0.11",
+    "extension-install": "^4.0.11",
     "ws": "^8.20.0"
   },
   "devDependencies": {
@@ -77,13 +99,5 @@
     "@types/ws": "^8.18.1",
     "typescript": "6.0.2",
     "vitest": "^4.1.3"
-  },
-  "scripts": {
-    "clean": "rm -rf dist",
-    "watch": "rslib build --watch",
-    "compile": "rslib build",
-    "build": "pnpm run compile",
-    "start": "node bin/extension-mcp.js",
-    "test": "vitest run"
   }
-}
+}

package/server.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+  "name": "io.github.extensiondev/mcp",
+  "description": "Build, run, inspect, and publish browser extensions from any MCP client. 30 tools, 11 browsers.",
+  "repository": {
+    "url": "https://github.com/extensiondev/mcp",
+    "source": "github"
+  },
+  "websiteUrl": "https://extension.dev",
+  "version": "4.4.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@extension.dev/mcp",
+      "version": "4.4.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}