playwright-e2e-mcp 0.7.0 → 0.8.0

package/README.md

@@ -17,6 +17,12 @@ Your Playwright test fails. Your AI finds out why, fixes it, and proves the fix
 
 </p>
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/xsignon-secure/E2E/main/docs/demo.gif" alt="An agent runs the failing checkout test, suggest-fix proposes a locator proven on the page at failure, and the applied fix is re-run and verified green" width="760">
+</p>
+
+<p align="center">⭐ <b>If it saves you a debugging session, <a href="https://github.com/xsignon-secure/E2E">a star</a> helps other Playwright users find it.</b></p>
+
 <p align="center">
   <a href="#getting-started">Getting started</a> ·
   <a href="#tools">Tools</a> ·
@@ -56,9 +62,11 @@ red at HEAD ─▶ bisect-failure (runs it across git history, names the breakin
 - **Fixes are proven, not guessed.** Every fix is re-run before it's kept, and undone if the test is still red.
 - **Honest.** It won't paper over a real bug to make a test pass.
 - **Works on CI failures too.** Load a CI job's report and traces and get the same diagnosis and fixes.
+- **TypeScript and Python.** Works on `@playwright/test` suites and on `pytest-playwright` ones, with the same failure diagnosis and traces.
 - **Flakiness with evidence.** Names the flaky test, whether it's a race, shared state or test order, and the seed that reproduces it.
-- **Lean.** Finding and fixing a broken locator took about **5,300 tokens** versus about **7,400**
-  with Playwright MCP plus a shell ([benchmark](#benchmark)).
+- **Lean.** With the `core` tool set, finding and fixing a broken locator took about **5,500 tokens**
+  versus about **7,900** with Playwright MCP plus a shell. All 19 tools add about 16k tokens of
+  definitions to every request, so load only the [profiles](#configuration) you use ([benchmark](#benchmark)).
 - **Free and open source.** MIT, no account, no API key, no telemetry. Every tool is free; an optional paid Pro only adds hosted CI history.
 
 ## 🚀 What only this MCP does
@@ -101,12 +109,16 @@ keeps your suite green.
 | 🛡️ | "Did that fix cheat?" | Compares the changed tests with git and blocks a fix that passes by deleting assertions or skipping tests. |
 | 🧊 | "Quarantine this flaky test" | Keeps it running and reported, stops it failing the build, with an owner and an expiry date. |
 | 🔐 | "Test the page after login" | Works behind sign-in with saved sessions, headers and click/fill steps, in Chromium, Firefox or WebKit, and can record or replay network traffic from a HAR file. |
+| 🗂️ | "Check the page that opens in a new tab" | Follows popups and new tabs with a `switchTab` step and lists every open tab. |
+| 🔒 | "Look, but don't change anything" | `blockWrites` stops POST, PUT, PATCH and DELETE requests from reaching the real backend while the AI inspects a page. |
+| 🐍 | "Run my pytest suite" | Runs `pytest-playwright` projects with the same tools: failures with the test's own file and line, the code frame and the trace. |
 | 🤖 | "Do it in CI" | A [GitHub Action and `ci` command](#ci-github-action-and-ci-command) post the diagnosis, flaky verdict and fix diffs on your PR. |
 
 ## Requirements
 
 - Node.js 22 or newer
-- A project that uses `@playwright/test`, with a browser installed (`npx playwright install chromium`)
+- A project that uses `@playwright/test`, with a browser installed (`npx playwright install chromium`),
+  or a Python project that uses `pytest-playwright` ([see below](#python-projects-pytest-playwright))
 - Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex, Gemini CLI or any other MCP client
 
 ## Getting started
@@ -117,7 +129,7 @@ other servers alone:
 
 ```bash
 npx -y playwright-e2e-mcp init            # --client all | cursor,vscode … · --dry-run
-npx -y playwright-e2e-mcp doctor          # checks Node, Playwright, browsers and client setup
+npx -y playwright-e2e-mcp doctor          # checks Node, Playwright, browsers, client setup and updates
 ```
 
 **Or let your agent do it.** Paste this into any coding agent:
@@ -177,6 +189,9 @@ Click [Install in Cursor](https://cursor.com/en/install-mcp?name=playwright-e2e&
 or go to **Settings → MCP → Add new MCP server** and paste the standard config. For one
 project only, put it in `.cursor/mcp.json`.
 
+Only fixing failing tests? [Install the core tools only](https://cursor.com/en/install-mcp?name=playwright-e2e&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInBsYXl3cmlnaHQtZTJlLW1jcCIsIi0tdG9vbHM9Y29yZSJdfQ==): the seven-tool fix loop
+(`--tools=core`), about 5k tokens of tool definitions instead of 16k.
+
 </details>
 
 <details>
@@ -258,8 +273,8 @@ Running and fixing your own tests needs your project, so use the local install f
 | --- | --- |
 | Skill only, any agent | `npx skills add xsignon-secure/E2E` |
 | MCP Registry | `io.github.xsignon-secure/E2E` ([listing](https://registry.modelcontextprotocol.io/)); registry-aware clients find it there |
-| Straight from GitHub, no npm | `npx -y github:xsignon-secure/E2E#v0.7.0` (pin a release tag) |
-| Release tarball | `npm install -D https://github.com/xsignon-secure/E2E/releases/download/v0.7.0/playwright-e2e-mcp-0.7.0.tgz` |
+| Straight from GitHub, no npm | `npx -y github:xsignon-secure/E2E#v0.8.0` (pin a release tag) |
+| Release tarball | `npm install -D https://github.com/xsignon-secure/E2E/releases/download/v0.8.0/playwright-e2e-mcp-0.8.0.tgz` |
 | Docker | `docker run -i --rm -v "$PWD:/work" ghcr.io/xsignon-secure/playwright-e2e-mcp` (published on each release; see [Development](docs/development.md#docker)) |
 | Local checkout | `"command": "node", "args": ["/path/to/E2E/dist/index.js"]` |
 
@@ -276,6 +291,70 @@ Run my Playwright tests and fix whatever fails.
 Your agent should run the suite, read the failure, and propose a fix it has re-run. To check the
 setup without your own tests, ask it to run `examples/sample-test.spec.ts` from this repo.
 
+### Updating
+
+How you get a new release depends on how you installed it:
+
+| Installed with | To update |
+| --- | --- |
+| `npx -y playwright-e2e-mcp` (the setup above, and what `init` writes) | Restart your MCP client. npx (npm 10, which comes with Node 22) asks npm for the latest version on each launch and fetches it. |
+| `npm install -D playwright-e2e-mcp` in the project | `npm install -D playwright-e2e-mcp@latest` |
+| `npm install -g playwright-e2e-mcp` | `npm install -g playwright-e2e-mcp@latest` |
+| GitHub Action `uses: xsignon-secure/E2E@v0.x.y` | Change the tag (Dependabot's `github-actions` updates do it for you) |
+| Docker | `docker pull ghcr.io/xsignon-secure/playwright-e2e-mcp:latest` |
+| Claude Desktop bundle (`.mcpb`) | Download the new bundle from the [latest release](https://github.com/xsignon-secure/E2E/releases/latest) and open it |
+| Git clone | `git pull && npm ci` |
+| Agent skill copied by `init` or `npx skills add` | Run the same command again |
+
+`npx -y playwright-e2e-mcp doctor` tells you whether a newer version is out and prints the
+command for your setup. Upgrade notes for each release are on the
+[releases page](https://github.com/xsignon-secure/E2E/releases).
+
+## Python projects (pytest-playwright)
+
+The same server works on Python suites. When the project has no Node Playwright but has a
+`pytest.ini`, a `[tool.pytest…]` table in `pyproject.toml`, `setup.cfg` / `tox.ini` pytest
+settings or a `conftest.py`, the tools run `python -m pytest` instead:
+
+- **`run-test`** runs the suite, a file, `tests/test_cart.py::TestCart::test_add` or
+  `tests/test_cart.py:42` (the test at that line). `grep` becomes `-k`, `browser` becomes
+  `--browser`, `retries` uses pytest-rerunfailures. Failures that finished are kept even when
+  the run is killed.
+- **`get-failure`** shows the message, the code frame, expected vs actual and, from the trace
+  pytest-playwright keeps (`--tracing retain-on-failure` is added for you), the failed action,
+  the DOM at failure, network and console.
+- **`list-tests`**, **`analyze-history`**, **`quarantine`** and the **`ci`** command work as for Node.
+- Not yet for Python: **`suggest-fix`** points at the DOM at failure but does not patch `.py`
+  files, **`diagnose-flaky`** says so and suggests re-running, and **`audit-tests`**,
+  **`check-test-change`** and **`generate-e2e-test`** read and write TypeScript/JavaScript specs
+  only. The page tools (`inspect-page`, `validate-selector`, …) launch the browser with Node
+  Playwright, so they need `@playwright/test` installed in the project.
+
+Results come from a small pytest plugin the server loads with `-p` from its temp folder; nothing
+is installed in your project. It uses your Python: `PW_MCP_PYTHON`, else `.venv`, `venv` or `env`
+in the project, else `python3` / `python`.
+
+```bash
+pip install pytest-playwright && playwright install chromium
+```
+
+## What's new in 0.8
+
+- **Python suites:** projects that use `pytest-playwright` work with `run-test`, `get-failure`
+  and `list-tests`, traces included ([details](#python-projects-pytest-playwright)).
+- **Popups and new tabs:** a `switchTab` step follows the page into a popup or new tab, and
+  results list every open tab.
+- **Look without changing anything:** `blockWrites` (or `PW_MCP_BLOCK_WRITES=1`) stops the page
+  tools from sending POST, PUT, PATCH or DELETE requests to a real backend.
+- **Crashed runs still report:** when Playwright dies before writing its report, the failures
+  that finished are kept and the run is marked partial.
+- **Stricter heal guard:** an assertion inside a `try` whose `catch` swallows the error is
+  blocked, and a web-first assertion without `await` is flagged.
+- **MCP 2026-07-28:** the new stateless protocol revision, cache hints, a server icon, the agent
+  skill served over the Skills extension, and a Server Card for discovery.
+- **Update check:** `doctor` says when a newer version is out and how to update
+  ([Updating](#updating)).
+
 ## What's new in 0.7
 
 - **Log in once, safely:** `save-login` signs in (2FA codes included) with secrets read from the
@@ -333,8 +412,8 @@ Every argument and example output is in the **[tool reference](docs/tools.md)**.
 MCP tool annotations (`readOnlyHint`, `destructiveHint`, …), so clients can show accurate safety
 prompts.
 
-**Only need the fix loop?** `--tools=core` (or `PW_MCP_TOOLS=core`) exposes six tools and cuts the
-tool-definition context by about three quarters. Other profiles: `triage`, `inspect`, `author`.
+**Only need the fix loop?** `--tools=core` (or `PW_MCP_TOOLS=core`) exposes seven tools and cuts the
+tool-definition context by about three quarters ([one-click core install for Cursor](https://cursor.com/en/install-mcp?name=playwright-e2e&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInBsYXl3cmlnaHQtZTJlLW1jcCIsIi0tdG9vbHM9Y29yZSJdfQ==)). Other profiles: `triage`, `inspect`, `author`.
 
 <details>
 <summary><b>Typical workflow</b></summary>
@@ -393,13 +472,17 @@ steps:
   - uses: actions/setup-node@v6
     with: { node-version: 24 }
   - run: npm ci && npx playwright install --with-deps chromium
-  - uses: xsignon-secure/E2E@v0.7.0
+  - uses: xsignon-secure/E2E@v0.8.0
     with:
       flaky-runs: 3      # 0 skips the flaky verdict
       suggest: 2         # suggest-fix diffs for the first 2 failures
       # args: --browser chromium tests/checkout
 ```
 
+A complete, ready-to-copy workflow is available in [`examples/github-actions/playwright-e2e.yml`](examples/github-actions/playwright-e2e.yml), including artifact upload and commented options for `guard: true` and Pro Cloud.
+
+**GitLab CI:** [`examples/gitlab-ci/playwright-e2e.yml`](examples/gitlab-ci/playwright-e2e.yml) runs the heal guard on merge requests, the same `ci` diagnosis, and posts the report as a merge request comment when you give it a project access token. Any other CI (Jenkins, CircleCI, AWS CodeBuild) works the same way: run `npx -y playwright-e2e-mcp ci --output e2e-report.md` and keep the file.
+
 Inputs: `project-root`, `args`, `flaky-runs`, `suggest`, `comment`, `review`,
 `verify-fixes`, `guard`, `pro-key`, `pro-url`, `fail-on-failure`, `version`, `github-token`. Outputs: `exit-code`,
 `report`, `guard`.
@@ -423,9 +506,14 @@ npx -y playwright-e2e-mcp guard --base origin/main   # exit 1 on BLOCK; --strict
 | Environment variable | Default | Purpose |
 | --- | --- | --- |
 | `PW_MCP_PROJECT_ROOT` | server cwd | Default project root for every tool |
-| `PW_MCP_TOOLS` | all | Which tools to expose, as tool names and/or profiles, comma separated (same as the `--tools=` flag). Profiles: `core` (run, status, failure, fix, flaky, heal guard, list), `triage` (run, status, failure, CI report, flaky, history, test audit, bisect, quarantine, heal guard, list), `inspect` (page, selector, accessibility, performance, visual, login), `author` (list, page, selector, generate, run, login, heal guard). All nineteen tool definitions cost about 14k tokens of context per request; `core` costs about 4k (11k and 2.6k with `PW_MCP_OUTPUT_SCHEMAS=0`) |
+| `PW_MCP_TOOLS` | all | Which tools to expose, as tool names and/or profiles, comma separated (same as the `--tools=` flag). Profiles: `core` (run, status, failure, fix, flaky, heal guard, list), `triage` (run, status, failure, CI report, flaky, history, test audit, bisect, quarantine, heal guard, list), `inspect` (page, selector, accessibility, performance, visual, login), `author` (list, page, selector, generate, run, login, heal guard). All nineteen tool definitions cost about 16k tokens of context per request; `core` costs about 5k (12k and 2.6k with `PW_MCP_OUTPUT_SCHEMAS=0`) |
 | `PW_MCP_OUTPUT_SCHEMAS` | on | `0` leaves the output schemas out of the tool list to save context. Results still carry `structuredContent` (see [Structured results](docs/tools.md#structured-results)) |
+| `PW_MCP_PROTOCOL` | both | `legacy` stops offering the stateless 2026-07-28 MCP revision, for a client that trips over it. By default 2026 clients get it and 2025 clients get the old handshake |
+| `PW_MCP_NO_UPDATE_CHECK` | off | `1` stops `doctor` from asking npm whether a newer version is out (same as `doctor --offline`) |
+| `PW_MCP_SKILLS` | on | `0` stops serving the bundled agent skill over the MCP Skills extension (`skill://playwright-e2e-mcp/SKILL.md`) |
 | `PW_MCP_STORAGE_STATE` | — | Default `storageState` file (inside the project) for the page tools |
+| `PW_MCP_PYTHON` | project venv, then `python3` | The Python that runs a pytest-playwright suite |
+| `PW_MCP_BLOCK_WRITES` | off | `1` makes the page tools abort POST, PUT, PATCH and DELETE requests that no mock answers (same as `blockWrites: true`), so steps run against a real environment cannot change its data |
 | `PW_MCP_SHUFFLE_SEEDS` | random | Comma-separated seeds for `diagnose-flaky`'s `order` pass, to replay the orders a diagnosis reported |
 | `PW_MCP_LOGIN_ENV` | — | Extra environment variables `save-login` may type through `{{env:NAME}}`, comma separated. Without it only `E2E_*`, `TEST_*`, `PW_*`, `PLAYWRIGHT_*` and `LOGIN_*` are allowed |
 | `PW_MCP_PRO_KEY` / `PW_MCP_PRO_URL` | — | Optional, paid: Pro key and Pro Cloud address. CI runs are uploaded with `playwright-e2e-mcp upload` (or the Action's `pro-key` / `pro-url` inputs) and `analyze-history` merges them with local runs. Unset (the default), nothing is ever sent anywhere |
@@ -461,16 +549,21 @@ on a storefront page and fixes it two ways: with this server (`run-test` → `su
 apply) and with Playwright MCP plus a shell (`playwright test`, `browser_navigate` +
 `browser_snapshot`, edit, re-run). Latest result ([full output](bench/RESULTS.md)):
 
-| Step | playwright-e2e-mcp | Playwright MCP + shell |
-| --- | ---: | ---: |
-| Tool definitions (sent with every request) | 4,565 | 4,726 |
-| Run the failing test | 246 | 325 |
-| Find the element / propose the fix | 260 | 2,286 |
-| Apply + verify (re-run) | 257 | 34 |
-| **Total for one fix** | 5,328 | 7,371 |
-
-Tokens are characters ÷ 4. The Playwright MCP route is a lower bound: it assumes the agent
-picks the right locator from the snapshot on the first try, which the server does for it here.
+| Step | playwright-e2e-mcp (`core` tools) | playwright-e2e-mcp (all tools) | Playwright MCP + shell |
+| --- | ---: | ---: | ---: |
+| Tool definitions (sent with every request) | 4,826 | 16,121 | 5,225 |
+| Run the failing test | 244 | 244 | 323 |
+| Find the element / propose the fix | 232 | 232 | 2,286 |
+| Apply + verify (re-run) | 230 | 230 | 34 |
+| **Total for one fix** | 5,532 | 16,827 | 7,868 |
+
+Tokens are characters ÷ 4. The work itself (run, diagnose, fix, verify) takes about 700 tokens
+here versus about 2,600 with Playwright MCP, but tool definitions are sent with every request:
+with all 19 tools loaded they outweigh that saving, so set `PW_MCP_TOOLS=core` (or another
+profile) when you only fix failing tests. The Playwright MCP route is a lower bound: it assumes
+the agent picks the right locator from the snapshot on the first try, which the server does for
+it here. Run 2026-10-28 with 0.7.0 and Playwright 1.64.1; re-run with
+`npm run build && node bench/token-benchmark.mjs`.
 
 ## Demo
 
@@ -483,7 +576,7 @@ A real `run-test` call served over stdio by `npx -y playwright-e2e-mcp` against
 
 - **MIT licensed.** Use it, change it, ship it in commercial work; no fees, no feature held back. The optional Pro plan adds a hosted service (CI run history across machines), not tools; nothing here needs it.
 - **No account, no API key, no sign-up.** `npx -y playwright-e2e-mcp init` is the whole setup.
-- **No telemetry.** It never phones home; your tests, traces and run history stay on your machine unless you set a Pro key and upload them.
+- **No telemetry.** It never phones home; your tests, traces and run history stay on your machine unless you set a Pro key and upload them. The only other request is `doctor` asking npm for the latest version number when you run it (`--offline` or `PW_MCP_NO_UPDATE_CHECK=1` skips it).
 - **Free dependencies only:** the MCP SDK (Apache-2.0), zod (MIT), axe-core (MPL-2.0) and the Playwright your project already has (Apache-2.0).
 - **Free to host yourself**, too: the HTTP bridge deploys to a free Vercel account (see [Hosted endpoint](docs/hosted-endpoint.md)).
 
@@ -495,6 +588,7 @@ browsing and this server for running, diagnosing and fixing the suite. They work
 
 - [Tool reference](docs/tools.md): every argument, example outputs, edge cases handled
 - [Hosted endpoint](docs/hosted-endpoint.md): the HTTP bridge for ChatGPT and claude.ai connectors
+- [Architecture](ARCHITECTURE.md): how the server is built and the design decisions behind it
 - [Security](SECURITY.md): the security model and how to report a vulnerability
 - [Development](docs/development.md): building, tests, Docker, signing and releasing
 - [Contributing](CONTRIBUTING.md) · [Code of conduct](CODE_OF_CONDUCT.md)

package/dist/cli/doctor.d.ts

@@ -9,6 +9,7 @@
  * Exit codes: 0 nothing failed (warnings allowed), 1 a check failed,
  * 2 bad arguments.
  */
+import { type UpdateCheckOptions } from '../utils/update-check.js';
 export declare const DOCTOR_USAGE: string;
 /** Oldest Node major the server supports. */
 export declare const MIN_NODE_MAJOR = 22;
@@ -26,6 +27,16 @@ export interface DoctorReport {
     checks: DoctorCheck[];
     ok: boolean;
 }
-export declare function runDoctorChecks(projectRoot: string, home?: string): Promise<DoctorReport>;
+/**
+ * The running version against the latest on npm. A newer release is a
+ * warning with the upgrade commands; an unreachable registry is not a
+ * problem with the setup, so it stays `ok` and says it could not check.
+ */
+export declare function versionCheck(options?: UpdateCheckOptions): Promise<DoctorCheck>;
+export interface DoctorOptions {
+    /** Options for the npm version check; `{ offline: true }` skips it. */
+    update?: UpdateCheckOptions;
+}
+export declare function runDoctorChecks(projectRoot: string, home?: string, options?: DoctorOptions): Promise<DoctorReport>;
 export declare function renderDoctorReport(report: DoctorReport): string;
 export declare function runDoctor(argv: string[], out?: (text: string) => void): Promise<number>;

package/dist/cli/doctor.js

@@ -17,6 +17,7 @@ import { parseArgs } from 'node:util';
 import { detectProject, findTestFiles } from '../utils/project-detector.js';
 import { SERVER_VERSION } from '../server.js';
 import { SERVER_NAME, SKILL_NAME } from './init.js';
+import { checkForUpdate, UPGRADE_HINT } from '../utils/update-check.js';
 export const DOCTOR_USAGE = [
     'Usage: playwright-e2e-mcp doctor [options]',
     '',
@@ -25,8 +26,11 @@ export const DOCTOR_USAGE = [
     '',
     '  --project-root <dir>   project directory (default: cwd)',
     '  --json                 print the checks as JSON',
+    '  --offline              skip asking npm whether a newer version exists',
+    '                         (also PW_MCP_NO_UPDATE_CHECK=1)',
     '',
 ].join('\n');
+const REPO_URL = 'https://github.com/xsignon-secure/E2E';
 /** Oldest Node major the server supports. */
 export const MIN_NODE_MAJOR = 22;
 /** Where each client keeps its project-scoped MCP config (see init). */
@@ -100,8 +104,31 @@ function browserChecks(root, playwrightPackage) {
     }
     return [{ name: 'Browsers', status: 'ok', detail: `installed: ${installed.join(', ')}${missing.length ? ` (not installed: ${missing.join(', ')})` : ''}` }];
 }
-export async function runDoctorChecks(projectRoot, home = os.homedir()) {
-    const checks = [nodeCheck()];
+/**
+ * The running version against the latest on npm. A newer release is a
+ * warning with the upgrade commands; an unreachable registry is not a
+ * problem with the setup, so it stays `ok` and says it could not check.
+ */
+export async function versionCheck(options = {}) {
+    const status = await checkForUpdate(SERVER_VERSION, options);
+    switch (status.state) {
+        case 'outdated':
+            return {
+                name: 'Version',
+                status: 'warn',
+                detail: `${status.current} is running; ${status.latest} is out (release notes: ${REPO_URL}/releases/tag/v${status.latest})`,
+                fix: UPGRADE_HINT,
+            };
+        case 'current':
+            return { name: 'Version', status: 'ok', detail: `${status.current} (latest)` };
+        case 'ahead':
+            return { name: 'Version', status: 'ok', detail: `${status.current} (newer than npm's ${status.latest})` };
+        default:
+            return { name: 'Version', status: 'ok', detail: `${status.current} (did not check for updates: ${status.reason})` };
+    }
+}
+export async function runDoctorChecks(projectRoot, home = os.homedir(), options = {}) {
+    const checks = [nodeCheck(), await versionCheck(options.update)];
     const detection = await detectProject(projectRoot);
     const root = detection.root;
     if (!detection.configPath) {
@@ -178,6 +205,9 @@ export function renderDoctorReport(report) {
         : warned
             ? `Ready, with ${warned} suggestion${warned === 1 ? '' : 's'} above.`
             : 'Everything is ready.');
+    // Only on a working setup: asking for a star while the tools can't run is no help to anyone.
+    if (!failed)
+        lines.push('', `Like it? A star helps other Playwright users find it: ${REPO_URL}`);
     return `${lines.join('\n')}\n`;
 }
 export async function runDoctor(argv, out = (t) => process.stdout.write(t)) {
@@ -186,14 +216,14 @@ export async function runDoctor(argv, out = (t) => process.stdout.write(t)) {
         ({ values } = parseArgs({
             args: argv,
             strict: true,
-            options: { 'project-root': { type: 'string' }, json: { type: 'boolean' } },
+            options: { 'project-root': { type: 'string' }, json: { type: 'boolean' }, offline: { type: 'boolean' } },
         }));
     }
     catch (err) {
         out(`doctor: ${err.message}\n\n${DOCTOR_USAGE}`);
         return 2;
     }
-    const report = await runDoctorChecks(path.resolve(values['project-root'] ?? '.'));
+    const report = await runDoctorChecks(path.resolve(values['project-root'] ?? '.'), os.homedir(), { update: { offline: values.offline } });
     out(values.json ? `${JSON.stringify(report, null, 2)}\n` : renderDoctorReport(report));
     return report.ok ? 0 : 1;
 }

package/dist/cli/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"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"}

package/dist/discovery.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Who this server is and how clients find it, for the 2026-07-28 MCP
+ * revision and its official extensions:
+ *
+ * - `SERVER_IDENTITY`: the `serverInfo` every result and `server/discover`
+ *   carry (title, description, website, icons), so clients can show the
+ *   server properly instead of a bare package name.
+ * - `CACHE_HINTS`: `ttlMs` / `cacheScope` for the cacheable list results
+ *   (SEP-2549). The tool, prompt and resource lists only change when the
+ *   package is upgraded or restarted with other options, so clients may
+ *   keep them for an hour instead of asking again on every turn.
+ * - `buildServerCard` / `buildAiCatalog`: the Server Card extension
+ *   (SEP-2127) for the HTTP bridge, served at `<mcp-url>/server-card` and
+ *   linked from `/.well-known/ai-catalog.json`, so registries and IDEs can
+ *   discover and configure the hosted endpoint before connecting.
+ *
+ * The values here must agree with server.json (the MCP Registry entry) and
+ * with what `server/discover` returns; a test checks both.
+ */
+import type { CacheHint } from '@modelcontextprotocol/server';
+/** The MCP Registry name (package.json `mcpName`, server.json `name`). */
+export declare const REGISTRY_NAME = "io.github.xsignon-secure/E2E";
+export declare const REPOSITORY_URL = "https://github.com/xsignon-secure/E2E";
+/** Display metadata shared by serverInfo, the Server Card and server.json. */
+export declare const SERVER_IDENTITY: {
+    readonly title: 'Playwright E2E MCP';
+    /** At most 100 characters: the Server Card and registry limit. */
+    readonly description: 'Diagnose and fix Playwright tests (TS, pytest): CI reports, traces, verified fixes, flaky verdicts.';
+    readonly websiteUrl: "https://github.com/xsignon-secure/E2E#readme";
+    readonly icons: readonly [{
+        readonly src: 'https://raw.githubusercontent.com/xsignon-secure/E2E/main/docs/logo.png';
+        readonly mimeType: 'image/png';
+        readonly sizes: readonly ['400x400'];
+    }];
+};
+/** One hour: list results only change on an upgrade or a restart. */
+export declare const LIST_TTL_MS: number;
+/**
+ * Cache hints for the cacheable results. `private` because the bridge serves
+ * a different tool list with and without a token, so a shared cache must not
+ * hand one caller's list to another.
+ */
+export declare const CACHE_HINTS: Record<'tools/list' | 'prompts/list' | 'resources/list' | 'resources/templates/list' | 'server/discover', CacheHint>;
+export declare const SERVER_CARD_SCHEMA = "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json";
+export declare const SERVER_CARD_MEDIA_TYPE = "application/mcp-server-card+json";
+export declare const AI_CATALOG_MEDIA_TYPE = "application/ai-catalog+json";
+export interface ServerCardOptions {
+    /** Absolute URL of the streamable-HTTP endpoint, e.g. https://host/api/mcp. */
+    endpoint: string;
+    version: string;
+    /** Whether the endpoint wants `Authorization: Bearer <token>` for the full tool set. */
+    tokenProtected: boolean;
+    /** The protocol versions the endpoint serves (what server/discover reports). */
+    protocolVersions: string[];
+}
+/** The Server Card (SEP-2127) for one hosted endpoint. Public metadata only. */
+export declare function buildServerCard(options: ServerCardOptions): Record<string, unknown>;
+/** The AI Catalog (`/.well-known/ai-catalog.json`) pointing at the card. */
+export declare function buildAiCatalog(cardUrl: string, host: string): Record<string, unknown>;
+/** CORS headers the Server Card discovery spec requires on both documents. */
+export declare const DISCOVERY_CORS_HEADERS: Record<string, string>;

package/dist/discovery.js

@@ -0,0 +1,108 @@
+/**
+ * Who this server is and how clients find it, for the 2026-07-28 MCP
+ * revision and its official extensions:
+ *
+ * - `SERVER_IDENTITY`: the `serverInfo` every result and `server/discover`
+ *   carry (title, description, website, icons), so clients can show the
+ *   server properly instead of a bare package name.
+ * - `CACHE_HINTS`: `ttlMs` / `cacheScope` for the cacheable list results
+ *   (SEP-2549). The tool, prompt and resource lists only change when the
+ *   package is upgraded or restarted with other options, so clients may
+ *   keep them for an hour instead of asking again on every turn.
+ * - `buildServerCard` / `buildAiCatalog`: the Server Card extension
+ *   (SEP-2127) for the HTTP bridge, served at `<mcp-url>/server-card` and
+ *   linked from `/.well-known/ai-catalog.json`, so registries and IDEs can
+ *   discover and configure the hosted endpoint before connecting.
+ *
+ * The values here must agree with server.json (the MCP Registry entry) and
+ * with what `server/discover` returns; a test checks both.
+ */
+/** The MCP Registry name (package.json `mcpName`, server.json `name`). */
+export const REGISTRY_NAME = 'io.github.xsignon-secure/E2E';
+export const REPOSITORY_URL = 'https://github.com/xsignon-secure/E2E';
+/** Display metadata shared by serverInfo, the Server Card and server.json. */
+export const SERVER_IDENTITY = {
+    title: 'Playwright E2E MCP',
+    /** At most 100 characters: the Server Card and registry limit. */
+    description: 'Diagnose and fix Playwright tests (TS, pytest): CI reports, traces, verified fixes, flaky verdicts.',
+    websiteUrl: `${REPOSITORY_URL}#readme`,
+    icons: [
+        {
+            src: 'https://raw.githubusercontent.com/xsignon-secure/E2E/main/docs/logo.png',
+            mimeType: 'image/png',
+            sizes: ['400x400'],
+        },
+    ],
+};
+/** One hour: list results only change on an upgrade or a restart. */
+export const LIST_TTL_MS = 60 * 60 * 1000;
+/**
+ * Cache hints for the cacheable results. `private` because the bridge serves
+ * a different tool list with and without a token, so a shared cache must not
+ * hand one caller's list to another.
+ */
+export const CACHE_HINTS = {
+    'tools/list': { ttlMs: LIST_TTL_MS, cacheScope: 'private' },
+    'prompts/list': { ttlMs: LIST_TTL_MS, cacheScope: 'private' },
+    'resources/list': { ttlMs: LIST_TTL_MS, cacheScope: 'private' },
+    'resources/templates/list': { ttlMs: LIST_TTL_MS, cacheScope: 'private' },
+    'server/discover': { ttlMs: LIST_TTL_MS, cacheScope: 'private' },
+};
+export const SERVER_CARD_SCHEMA = 'https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json';
+export const SERVER_CARD_MEDIA_TYPE = 'application/mcp-server-card+json';
+export const AI_CATALOG_MEDIA_TYPE = 'application/ai-catalog+json';
+/** The Server Card (SEP-2127) for one hosted endpoint. Public metadata only. */
+export function buildServerCard(options) {
+    return {
+        $schema: SERVER_CARD_SCHEMA,
+        name: REGISTRY_NAME,
+        version: options.version,
+        description: SERVER_IDENTITY.description,
+        title: SERVER_IDENTITY.title,
+        websiteUrl: SERVER_IDENTITY.websiteUrl,
+        repository: { url: REPOSITORY_URL, source: 'github' },
+        icons: SERVER_IDENTITY.icons,
+        remotes: [
+            {
+                type: 'streamable-http',
+                url: options.endpoint,
+                ...(options.tokenProtected
+                    ? {
+                        headers: [
+                            {
+                                name: 'Authorization',
+                                description: 'Bearer token for this deployment (or sign in with OAuth when the client supports it).',
+                                isRequired: true,
+                                isSecret: true,
+                                value: 'Bearer {token}',
+                                variables: { token: { description: 'The deployment token (PW_MCP_HTTP_TOKEN)', isRequired: true, isSecret: true } },
+                            },
+                        ],
+                    }
+                    : {}),
+                supportedProtocolVersions: [...options.protocolVersions],
+            },
+        ],
+    };
+}
+/** The AI Catalog (`/.well-known/ai-catalog.json`) pointing at the card. */
+export function buildAiCatalog(cardUrl, host) {
+    return {
+        specVersion: '1.0',
+        entries: [
+            {
+                identifier: `urn:air:${host}:mcp:playwright-e2e-mcp`,
+                type: SERVER_CARD_MEDIA_TYPE,
+                url: cardUrl,
+            },
+        ],
+    };
+}
+/** CORS headers the Server Card discovery spec requires on both documents. */
+export const DISCOVERY_CORS_HEADERS = {
+    'access-control-allow-origin': '*',
+    'access-control-allow-methods': 'GET',
+    'access-control-allow-headers': 'Content-Type, If-None-Match',
+    'access-control-expose-headers': 'ETag',
+};
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -53,6 +53,15 @@ export interface McpHttpHandlerOptions {
 export declare const MIN_TOKEN_LENGTH = 16;
 /** Tokens shorter than this still work, with a warning to use a longer one. */
 export declare const RECOMMENDED_TOKEN_LENGTH = 32;
+/**
+ * Public discovery documents (Server Card extension, SEP-2127): the card at
+ * `<mcp-url>/server-card` and the AI Catalog at
+ * `/.well-known/ai-catalog.json`. They hold only public metadata (no tools,
+ * no secrets), so they are served before authentication, with open CORS.
+ * Vercel rewrites both paths to the function with `mcp_route` set.
+ * Returns undefined for every other request.
+ */
+export declare function discoveryResponse(request: Request, mcpPath: string, tokenProtected: boolean): Response | undefined;
 /** Build the fetch-shaped MCP handler backed by a fresh server per request. */
 export declare function createMcpHttpHandler(options?: McpHttpHandlerOptions): McpHttpHandler;
 /**