npm package: @fasttest-ai/qa-agent
Description: FastTest Agent — MCP server that turns your coding agent into a QA engineer. Test, explore, and break web apps using Playwright.
Author: FastTest AI
Latest version: 1.0.4

# FastTest Agent

An MCP server that turns your coding agent into a QA engineer. Test, explore, and break web apps using Playwright -- driven entirely by your AI's reasoning.

```
npx -y @fasttest-ai/qa-agent install
```

## What it does

FastTest Agent is a [Model Context Protocol](https://modelcontextprotocol.io/) server that gives coding agents (Claude Code, Cursor, Windsurf, VS Code Copilot, Codex) the ability to:

- **Test** web applications by driving a real browser
- **Explore** apps to discover pages, forms, and flows
- **Heal** broken CSS selectors automatically
- **Save** tests as reusable suites for CI/CD replay and in editor replay
- **Break** apps with adversarial inputs (chaos mode)

The MCP server provides browser tools and structured prompts.

## How it works

```
Your IDE (Claude Code, Cursor, etc.)
  │
  ├── Reasoning (your coding agent)
  │
  └── Tools (this MCP server)
        ├── browser_navigate, browser_click, browser_fill, ...
        ├── test, explore, chaos, vibe_shield
        ├── heal (selector self-repair)
        └── save_suite, run (cloud features)
```

1. You say "test the login flow"
2. The `test` tool navigates to the URL, captures a page snapshot, and returns testing instructions
3. Your coding agent reads the snapshot and drives browser tools to execute tests
4. Results are reported inline. Optionally, save as a suite for CI/CD.

## Installation

Works with Claude Code, Cursor, Windsurf, VS Code Copilot, Codex, and Antigravity:

```bash
npx -y @fasttest-ai/qa-agent install
```

The installer auto-detects your IDE and configures the MCP server.

### Manual setup

If your IDE isn't detected, add this to your MCP configuration:

```json
{
  "mcpServers": {
    "fasttest": {
      "command": "npx",
      "args": ["-y", "@fasttest-ai/qa-agent"]
    }
  }
}
```

## Quick start

Once installed, just ask your coding agent:

```
"Test the login flow"
"Explore my app and find all testable flows"
"Break my signup page"
```

## Tools

### Browser tools (16)

Direct Playwright wrappers for page interaction:

| Tool                                     | Description                                                   |
| ---------------------------------------- | ------------------------------------------------------------- |
| `browser_navigate`                       | Navigate to a URL                                             |
| `browser_click`                          | Click an element                                              |
| `browser_fill`                           | Fill a form field                                             |
| `browser_fill_form`                      | Fill multiple fields at once                                  |
| `browser_screenshot`                     | Capture a screenshot                                          |
| `browser_snapshot`                       | Get the accessibility tree                                    |
| `browser_assert`                         | Run assertions (visible, hidden, text, URL, count, attribute) |
| `browser_wait`                           | Wait for an element or timeout                                |
| `browser_press_key`                      | Press keyboard keys                                           |
| `browser_evaluate`                       | Execute JavaScript                                            |
| `browser_console_logs`                   | Get console log messages                                      |
| `browser_save_session`                   | Save cookies/localStorage                                     |
| `browser_restore_session`                | Restore a saved session                                       |
| `browser_go_back` / `browser_go_forward` | History navigation                                            |
| `browser_handle_dialog`                  | Accept/dismiss alerts                                         |
| `browser_file_upload`                    | Upload files                                                  |
| `browser_drag`                           | Drag and drop                                                 |
| `browser_resize`                         | Resize viewport                                               |
| `browser_tabs`                           | Manage browser tabs                                           |
| `browser_network_requests`               | List captured network requests                                |

### Domain tools (14)

Higher-level tools that return structured prompts for your coding agent:

| Tool              | Description                                                         |
| ----------------- | ------------------------------------------------------------------- |
| `test`            | Test a web app (navigates, snapshots, returns testing instructions) |
| `explore`         | Discover pages, forms, and flows                                    |
| `chaos`           | Adversarial testing for stability and edge cases                    |
| `vibe_shield`     | One-command safety net: explore, generate tests, run regressions    |
| `heal`            | Fix broken CSS selectors using multiple strategies                  |
| `setup`           | Authenticate with FastTest cloud (device auth flow)                 |
| `save_suite`      | Save tests as a reusable suite                                      |
| `update_suite`    | Update existing test cases                                          |
| `run`             | Execute a saved test suite                                          |
| `status`          | Check execution status                                              |
| `cancel`          | Cancel a running execution                                          |
| `list_projects`   | List QA projects                                                    |
| `list_suites`     | List test suites                                                    |
| `health`          | Check backend connectivity                                          |
| `healing_history` | View selector healing patterns                                      |

## Cloud features (optional)

FastTest Agent works fully offline with browser tools. For persistent test suites, CI/CD replay, regression tracking, and a dashboard, connect to [FastTest Cloud](https://fasttest.ai):

```
> Use the setup tool to connect to FastTest cloud
```

This opens a browser for secure device authentication. Once connected:

- `save_suite` persists tests for replay
- `run` executes suites and tracks regressions
- `vibe_shield` on subsequent calls shows what broke since last run
- CI runner (`fasttest-ci`) runs suites in GitHub Actions

### CI/CD usage

```yaml
# .github/workflows/tests.yml
- name: Run FastTest suite
  run: npx -y @fasttest-ai/qa-agent ci --api-key ${{ secrets.FASTTEST_API_KEY }} --suite-id ${{ vars.SUITE_ID }}
```

Use `{{VAR_NAME}}` placeholders in test steps for secrets (passwords, API keys). The runner resolves them from environment variables at execution time.

## CLI flags

```
--api-key <key>     Organization API key
--base-url <url>    Cloud API URL (default: https://api.fasttest.ai)
--headed            Show browser window (debug mode)
--browser <type>    chromium | firefox | webkit (default: chromium)
```

## License

Apache-2.0

node /Users/rajat/reposs/afbp/local-skill/dist/install.js uninstall --ide claude-code
node /Users/rajat/reposs/afbp/local-skill/dist/install.js install --ide claude-code