Skip to content

Chrome DevTools for coding agents

docs: correct what --screenshotFormat reduces (#2617)

Thomas Bachemc5757770b051
diff --git a/docs/configuration.md b/docs/configuration.md
index 2988679f..213c5fc4 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -186,7 +186,7 @@ The Chrome DevTools MCP server supports the following configuration option:
- **Default:** `true`
- **`--screenshotFormat`/ `--screenshot-format`**
- Override the default output format used by take_screenshot when the caller does not specify one. JPEG and WebP are ~3-5x smaller than PNG, which helps reduce context size in AI conversations. Unset preserves the existing default ("png").
+ Override the default output format used by take_screenshot when the caller does not specify one. JPEG and WebP are ~3-5x smaller than PNG, which reduces transfer and storage size. To reduce context size use --screenshotMaxWidth / --screenshotMaxHeight, since image tokens scale with dimensions rather than encoded bytes. Unset preserves the existing default ("png").
- **Type:** string
- **Choices:** `jpeg`, `png`, `webp`
- **Default:** `false`
diff --git a/src/config/mcp-options.ts b/src/config/mcp-options.ts
index 7f0c48df..adf56dbb 100644
--- a/src/config/mcp-options.ts
+++ b/src/config/mcp-options.ts
@@ -320,7 +320,7 @@ export const mcpOptions = {
screenshotFormat: {
type: 'string',
description:
- 'Override the default output format used by take_screenshot when the caller does not specify one. JPEG and WebP are ~3-5x smaller than PNG, which helps reduce context size in AI conversations. Unset preserves the existing default ("png").',
+ 'Override the default output format used by take_screenshot when the caller does not specify one. JPEG and WebP are ~3-5x smaller than PNG, which reduces transfer and storage size. To reduce context size use --screenshotMaxWidth / --screenshotMaxHeight, since image tokens scale with dimensions rather than encoded bytes. Unset preserves the existing default ("png").',
choices: ['jpeg', 'png', 'webp'] as const,
},
screenshotQuality: {