Skip to main content
Glama
README.md
<div align="center">
  <img src="logo.png" alt="QA Agent Pro Logo" width="200"/>
  <h1>๐Ÿ•ต๏ธ QA Agent Pro</h1>
  <p><strong>The "AI Tester" for Claude & Cursor</strong></p>
</div>

> **Stop testing manually. Let AI do the boring work.**

**QA Agent Pro** is a Model Context Protocol (MCP) server that gives your AI (Claude, Cursor, etc.) **eyes and hands** to browse the web. It turns your AI into a tireless QA Engineer that can test your website 24/7.

## ๐Ÿš€ Why QA Agent Pro?

- **๐Ÿ“ฑ Mobile Simulation:** Test your responsive design on iPhone, Pixel, or iPad views instantly.
- **๐Ÿšจ Bug Hunter:** Automatically captures hidden JavaScript errors (Console Logs) that break your app.
- **๐Ÿ“ธ Visual Proof:** Takes screenshots of every step, so you have evidence of what works (and what doesn't).
- **โšก Zero Config:** Connects to Claude Desktop in seconds.

## ๐Ÿ› ๏ธ Capabilities (Tools)

Your AI gains these superpowers:

1.  `navigate(url)`: Open any website in a real Chrome browser.
2.  `click(selector)` & `type(selector, text)`: Interact like a real user.
3.  `set_viewport(width, height, mobile)`: **[PREMIUM]** Simulate mobile devices.
4.  `get_console_logs()`: **[PREMIUM]** Extract error logs for debugging.
5.  `screenshot(name)`: Capture visual evidence.

## ๐Ÿ“ฆ Installation

1.  Clone this repo:
    ```bash
    git clone https://github.com/yourusername/qa-agent-mcp.git
    cd qa-agent-mcp
    ```
2.  Install & Build:
    ```bash
    npm install && npm run build
    ```
3.  Add to Claude Desktop Config:
    ```json
    {
      "mcpServers": {
        "qa-agent": {
          "command": "node",
          "args": ["/absolute/path/to/qa-agent-mcp/build/index.js"]
        }
      }
    }
    ```

## ๐Ÿ’ฐ Pricing & Licensing

This tool is available for:
- **Personal Use:** Free for open source projects.
- **Commercial License:** $49 (Lifetime access).

[![Buy License](https://img.shields.io/badge/Buy_License-$29-green?style=for-the-badge)](https://samuverse7.gumroad.com/l/fjhfd)

> **Corporate/Agency Use:** If you are using this tool to test client websites or commercial products, you must purchase a license.

## ๐Ÿงช Try the Demo

Run the included verification script to see the agent in action (Mobile + Desktop test):

```bash
node build/verify-qa.js
```

---
*Built with โค๏ธ by [Your Name]*

TDQS

A3.5/5.0

Scored across 7 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap: click, get_console_logs, get_text, navigate, screenshot, set_viewport, and type all target specific, non-overlapping browser automation tasks. An agent can easily tell them apart based on their unique functions.

Naming Consistency5/5

All tool names follow a consistent verb_noun or verb pattern with snake_case: click, get_console_logs, get_text, navigate, screenshot, set_viewport, and type. This predictable naming scheme makes the set easy to understand and use.

Tool Count5/5

With 7 tools, the count is well-scoped for a QA/browser automation server. Each tool earns its place by covering essential actions like navigation, interaction, and debugging without being overwhelming or too sparse.

Completeness4/5

The toolset covers core QA workflows: navigation, interaction (click, type), content retrieval (get_text, get_console_logs), and configuration (set_viewport, screenshot). Minor gaps exist, such as missing tools for handling alerts or cookies, but agents can work around these with the provided tools.

Maintenance

ActivityInactive
ResponsivenessNo issues