QA Use

v2.18.0Developer Toolsstable

Agent-first E2E testing CLI

browser-automationllm-codemcpmcp-servermcp-tools
Share:
22
Stars
0
Downloads
0
Weekly
0/5

What is QA Use?

QA Use is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agent-first e2e testing cli

Agent-first E2E testing CLI

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Agent-first E2E testing CLI

Use Cases

Agent-first E2E testing
Browser automation testing
QA workflow automation
desplega-ai

Maintainer

LicenseMIT
Languagetypescript
Versionv2.18.0
UpdatedMay 8, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @desplega.ai/qa-use

Manual Installation

npx -y @desplega.ai/qa-use

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use QA Use

QA Use is an agent-first end-to-end testing CLI and MCP server from desplega.ai that lets AI agents create, validate, and run YAML-defined browser automation tests through natural language. It provides browser control (navigate, fill forms, click, screenshot), YAML test management, API health checks, and an AI-powered assertion system — all backed by the desplega.ai cloud service. Development teams and QA engineers use it to generate test suites from prompts, run them in CI/CD pipelines, and verify pull requests automatically through Claude Code integration.

Prerequisites

  • Node.js 18 or later installed
  • A desplega.ai account and QA_USE_API_KEY (sign up at desplega.ai)
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • A web application to test (local or remote)
1

Install QA Use

Install the QA Use CLI globally via npm, or use npx to run it without installing.

npm install -g @desplega.ai/qa-use
# Or run without installing:
npx @desplega.ai/qa-use setup
2

Get your API key

Sign up at desplega.ai and copy your QA_USE_API_KEY from the account settings page. This key authenticates all browser automation sessions.

3

Configure your environment

Set the required API key via environment variable or a local JSON config file.

# Option 1: Environment variable
export QA_USE_API_KEY=your-api-key-here

# Option 2: JSON config file (.qa-use.json in project or home directory)
{
  "api_key": "your-api-key-here",
  "region": "us"
}
4

Add QA Use to your MCP client configuration

Add the server to claude_desktop_config.json so Claude can invoke test management and browser automation tools.

{
  "mcpServers": {
    "qa-use": {
      "command": "npx",
      "args": ["-y", "@desplega.ai/qa-use"],
      "env": {
        "QA_USE_API_KEY": "your-api-key-here"
      }
    }
  }
}
5

Create and run your first test

Ask Claude to generate a YAML test definition for a login flow and then run it. The test YAML can be saved and committed to your repository.

# Example test file: tests/login.yaml
name: Login Test
app_config: your-app-config-id
steps:
  - action: goto
    url: /login
  - action: fill
    target: email input
    value: [email protected]
  - action: click
    target: login button
  - action: to_be_visible
    target: dashboard

QA Use Examples

Client configuration

claude_desktop_config.json entry for QA Use with the desplega.ai API key.

{
  "mcpServers": {
    "qa-use": {
      "command": "npx",
      "args": ["-y", "@desplega.ai/qa-use"],
      "env": {
        "QA_USE_API_KEY": "qau_xxxxxxxxxxxxxxxxxxxx",
        "QA_USE_REGION": "us"
      }
    }
  }
}

Prompts to try

Example prompts for generating, running, and managing E2E tests through Claude.

- "Generate a QA Use test for the sign-up flow at https://myapp.com/register and save it as tests/signup.yaml."
- "Run the test suite in the tests/ directory and show me which tests failed."
- "Take a screenshot of https://myapp.com/dashboard after logging in as [email protected]."
- "Create an API health check that verifies https://api.myapp.com/health returns 200 every 5 minutes."
- "Validate the tests/checkout.yaml test definition and fix any syntax errors."

Troubleshooting QA Use

Browser sessions fail with 'Unauthorized' errors

Check that QA_USE_API_KEY is set correctly and that your desplega.ai account has an active subscription. Verify the key is valid by running 'npx @desplega.ai/qa-use setup' and checking the connection status.

Tests run in headless mode and fail on visible-element assertions

Headless mode is the default for cloud sessions. If your app has anti-bot measures that block headless browsers, contact desplega.ai support. Do not set QA_USE_FORCE_HEADLESS=true as that enforces headless mode.

YAML test file fails validation with schema errors

Ensure each step has a valid 'action' field. Supported actions include: goto, fill, click, to_be_visible, to_have_text, wait, and screenshot. Run 'npx @desplega.ai/qa-use validate tests/yourtest.yaml' to see specific validation errors.

Frequently Asked Questions about QA Use

What is QA Use?

QA Use is a Model Context Protocol (MCP) server that agent-first e2e testing cli It connects AI assistants to external tools and data sources through a standardized interface.

How do I install QA Use?

Install via npm with the command: npx -y @desplega.ai/qa-use. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with QA Use?

QA Use works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is QA Use free to use?

Yes, QA Use is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "qa-use": { "command": "npx", "args": ["-y", "@desplega.ai/qa-use"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use QA Use?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides