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 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:

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:

{
  "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:

> 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

# .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