🚀 operative.sh web-eval-agent MCP Server

Let the coding agent debug itself, you've got better things to do.

🔥 Supercharge Your Debugging

operative.sh's MCP Server launches a browser-use powered agent to autonomously execute and debug web apps directly in your code editor.

⚡ Features

• 🌐 Navigate your webapp using BrowserUse (2x faster with operative backend)

• 📊 Capture network traffic - requests are intelligently filtered and returned into the context window

• 🚨 Collect console errors - captures logs & errors

• 🤖 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.

🧰 MCP Tool Reference

Key arguments

• web_eval_agent

  • url (required) – address of the running app (e.g. http://localhost:3000)

  • task (required) – natural-language description of what to test ("run through the signup flow and note any UX issues")

  • headless_browser (optional, default – set to true to hide the browser window

• setup_browser_state

  • url (optional) – page to open first (handy to land directly on a login screen)

You can trigger these tools straight from your IDE chat, for example:

🏁 Quick Start (macOS/Linux)

1. Pre-requisites (typically not needed):

• brew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• npm: (brew install npm)

• jq: brew install jq

2. Run the installer after getting an api key (free)

   • Installs playwright

   • Installs uv

   • Inserts JSON into your code editor (Cursor/Cline/Windsurf) for you!

3. Visit your favorite IDE and restart to apply the changes

4. Send a prompt in chat mode to call the web eval agent tool! e.g.

🛠️ Manual Installation

1. Get your API key at operative.sh

2. Install uv

4. Install playwright:

6. Add below JSON to your relevant code editor with api key

7. Restart your code editor

🔃 Updating

• uv cache clean

• refresh MCP server

Operative Discord Server

🛠️ Manual Installation (Mac + Cursor/Cline/Windsurf)

1. Get your API key at operative.sh

2. Install uv

3. Install playwright:

4. Add below JSON to your relevant code editor with api key

5. Restart your code editor

Manual Installation (Windows + Cursor/Cline/Windsurf)

We're refining this, please open an issue if you have any issues!

1. Do all this in your code editor terminal

2. curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

3. Get your API key at operative.sh

4. Install uv (curl -LsSf https://astral.sh/uv/install.sh | sh)

5. uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install

6. Restart code editor

🚨 Issues

• Updates aren't being received in code editors, update or reinstall for latest version: Run uv cache clean for latest

• Any issues feel free to open an Issue on this repo or in the discord!

• 5/5 - static apps without changes weren't screencasting, fixed! uv clean + restart to get fix

Changelog

• 4/29 - Agent overlay update - pause/play/stop agent run in the browser

📋 Example MCP Server Output Report

Star History

Built with <3 @ operative.sh