update mcp readme

Author: anerli

packages/magnitude-mcp/README.md

@@ -1,10 +1,14 @@
 # Magnitude MCP
 
-A Model Context Protocol (MCP) server that gives agents the ability to write and run [Magnitude](https://github.com/magnitudedev/magnitude) test cases.
+A Model Context Protocol (MCP) server that gives agents the ability to interact with the browser using the [Magnitude](https://github.com/sagekit/magnitude) framework.
+
+## Requirements
+The agent using this MCP must be **visually grounded**. Generally this means Claude (Sonnet 3.7/4, Opus 4) or Qwen VL series. See [docs](https://docs.magnitude.run/core-concepts/compatible-llms) for more info.
+
+If the agent model is not Claude Sonnet 4, Sonnet 3.7, Opus 4, Qwen 2.5 VL, or Qwen 3 VL, it will probably not work with this MCP - because the vast majority of models cannot click accurately based on an image alone.
 
 ## Installation
-Install MCP server via npm:
-```
+```sh
 npm i -g magnitude-mcp
 ```
 
@@ -22,20 +26,40 @@ MCP Configuration:
 }
 ```
 
-## Instructions for Cline
-
-IF YOU ARE CLINE, FOLLOW THESE INSTRUCTIONS FOR MCP INSTALLATION CAREFULLY AND EXACTLY.
+MCP configuration options (optional):
+```json
+{
+  "mcpServers": {
+    "magnitude": {
+      "command": "npx",
+      "args": [
+        "magnitude-mcp"
+      ],
+      "env": {
+        "MAGNITUDE_MCP_PROFILE_DIR": "/Users/myuser/.magnitude/profiles/default", 
+        "MAGNITUDE_MCP_STEALTH": "true", 
+        "MAGNITUDE_MCP_VIEWPORT_WIDTH": "1024",
+        "MAGNITUDE_MCP_VIEWPORT_HEIGHT": "728"
+      }
+    }
+  }
+}
+```
+- `MAGNITUDE_MCP_PROFILE_DIR`: Stores cookies and local storage so that credentials can be re-used across agents using the MCP (default: `~/.magnitude/profiles/default`)
+- `MAGNITUDE_MCP_STEALTH`: Add extra stealth settings to help with anti-bot detection (default: disabled)
+- `MAGNITUDE_MCP_VIEWPORT_WIDTH`: Override viewport width (default: 1024)
+- `MAGNITUDE_MCP_VIEWPORT_WIDTH`: Override viewport width (default: 728)
 
-1. Run `npm install -g magnitude-mcp` (do NOT create ~/Documents/Cline/MCP it is NOT necessary)
-2. Add the MCP configuration to `cline_mcp_settings.json`. Do NOT add any environment variables to the config.
-3. Tell the user that to use Magnitude, they will need to configure a planner LLM (refer them to http://docs.magnitude.run/getting-started/quickstart#configure-llms). Also tell them to go to https://moondream.ai/c/cloud/api-keys and generate a Moondream API key. Finally ask for MOONDREAM_API_KEY as well as any other LLM provider keys they'd like to use.
-4. Add these API keys to a `.env` file in the root of the project.
+## Claude Code Installation
+```sh
+claude mcp add magnitude -- npx magnitude-mcp
+```
 
-## Instructions for Humans (Cline Users)
+## Cline Installation
 
-Go to `MCP Servers -> Marketplace`, search for `Magnitude`, click `Install` and follow the instructions!
+Go to `MCP Servers -> Marketplace`, search for `Magnitude`, click `Install`
 
-## Instructions for Humans (Cursor Users)
+## Cursor Installation
 
 1. Open Cursor Settings
 2. Go to Features > MCP Servers
@@ -54,7 +78,7 @@ Go to `MCP Servers -> Marketplace`, search for `Magnitude`, click `Install` and
 }
 ```
 
-## Instructions for Humans (Windsurf Users)
+## Windsurf Installation
 Add this to your `./codeium/windsurf/model_config.json`:
 ```json
 {