Skip to content

Commit ca0b158

Browse files
committed
Update README to showcase both tools
1 parent 357424d commit ca0b158

File tree

1 file changed

+32
-9
lines changed

1 file changed

+32
-9
lines changed

README.md

Lines changed: 32 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,29 @@
1717
- 🚨 **Collect console errors** - captures logs & errors
1818
- 🤖 **Autonomous debugging** - the Cursor agent calls the web QA agent mcp server to test if the code it wrote works as epected end-to-end.
1919

20+
## 🧰 MCP Tool Reference
21+
22+
| Tool | Purpose |
23+
|------|---------|
24+
| `web_eval_agent` | 🤖 Automated UX evaluator that drives the browser, captures screenshots, console & network logs, and returns a rich UX report. |
25+
| `setup_browser_state` | 🔒 Opens an interactive (non-headless) browser so you can sign in once; the saved cookies/local-storage are reused by subsequent `web_eval_agent` runs. |
26+
27+
**Key arguments**
28+
29+
* `web_eval_agent`
30+
* `url` **(required)** – address of the running app (e.g. `http://localhost:3000`)
31+
* `task` **(required)** – natural-language description of what to test ("run through the signup flow and note any UX issues")
32+
* `headless_browser` *(optional, default `false`)* – set to `true` to hide the browser window
33+
34+
* `setup_browser_state`
35+
* `url` *(optional)* – page to open first (handy to land directly on a login screen)
36+
37+
You can trigger these tools straight from your IDE chat, for example:
38+
39+
```bash
40+
Evaluate my app at http://localhost:3000 – run web_eval_agent with the task "Try the full signup flow and report UX issues".
41+
```
42+
2043
## 🏁 Quick Start (macOS/Linux)
2144

2245
1. Pre-requisites (typically not needed):
@@ -113,14 +136,14 @@ We're refining this, please open an issue if you have any issues!
113136
114137
🔍 Agent Steps
115138
📍 1. Navigate → http://localhost:5173
116-
📍 2. Click Login (button index 2)
117-
📍 3. Click API Keys (button index 4)
118-
📍 4. Click Create Key (button index 9)
119-
📍 5. Type Test API Key (input index 2)
120-
📍 6. Click Done (button index 3)
121-
📍 7. Click Delete (button index 10)
122-
📍 8. Click Delete (confirm index 3)
123-
🏁 Flow tested successfully – UX felt smooth and intuitive.
139+
📍 2. Click "Login" (button index 2)
140+
📍 3. Click "API Keys" (button index 4)
141+
📍 4. Click "Create Key" (button index 9)
142+
📍 5. Type "Test API Key" (input index 2)
143+
📍 6. Click "Done" (button index 3)
144+
📍 7. Click "Delete" (button index 10)
145+
📍 8. Click "Delete" (confirm index 3)
146+
🏁 Flow tested successfully – UX felt smooth and intuitive.
124147
125148
🖥️ Console Logs (10)
126149
1. [debug] [vite] connecting…
@@ -141,7 +164,7 @@ We're refining this, please open an issue if you have any issues!
141164
142165
01:17:45.038 🤖 🏁 Flow finished – deletion verified
143166
01:17:47.038 🤖 📋 Conclusion repeated above
144-
👁️ See the Operative Control Center dashboard for live logs.
167+
👁️ See the "Operative Control Center" dashboard for live logs.
145168
```
146169

147170
## Star History

0 commit comments

Comments
 (0)