feat: --slim mode for maximum token savings

README.md

@@ -73,6 +73,21 @@ Add the following config to your MCP client:
 > [!NOTE]  
 > Using `chrome-devtools-mcp@latest` ensures that your MCP client will always use the latest version of the Chrome DevTools MCP server.
 
+If you are intersted in doing only basic browser tasks, use the `--slim` mode:
+
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest", "--slim", "--headless"]
+    }
+  }
+}
+```
+
+See [Slim tool reference](./docs/slim-tool-reference.md).
+
 ### MCP Client configuration
 
 <details>
@@ -532,6 +547,10 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** boolean
   - **Default:** `true`
 
+- **`--slim`**
+  Exposes a "slim" set of 3 tools covering navigation, script execution and screenshots only. Useful for basic browser tasks.
+  - **Type:** boolean
+
 <!-- END AUTO GENERATED OPTIONS -->
 
 Pass them via the `args` property in the JSON configuration. For example:

docs/slim-tool-reference.md

@@ -0,0 +1,41 @@
+<!-- AUTO GENERATED DO NOT EDIT - run 'npm run docs' to update-->
+
+# Chrome DevTools MCP Slim Tool Reference (~368 cl100k_base tokens)
+
+- **[Navigation automation](#navigation-automation)** (1 tools)
+  - [`navigate`](#navigate)
+- **[Debugging](#debugging)** (2 tools)
+  - [`evaluate`](#evaluate)
+  - [`screenshot`](#screenshot)
+
+## Navigation automation
+
+### `navigate`
+
+**Description:** Load URL in the browser
+
+**Parameters:**
+
+- **url** (string) **(required)**: Page URL
+
+---
+
+## Debugging
+
+### `evaluate`
+
+**Description:** [`Evaluate`](#evaluate) a JavaScript function on the last loaded page
+
+**Parameters:**
+
+- **fn** (string) **(required)**: A JavaScript function to be executed on the active page
+
+---
+
+### `screenshot`
+
+**Description:** Take a [`screenshot`](#screenshot) of the active page.
+
+**Parameters:** None
+
+---