Aqua MCP Server

A Model Context Protocol server for Aqua Cloud — connect Claude and other MCP-capable AI assistants to your Aqua test management platform.

Manage requirements, defects, test cases, and test scenarios in natural language: create items, update statuses, add test steps, link relationships, search projects, and more — 26 tools in total.

Quick Start

Claude Code

claude mcp add aqua \
  --env AQUA_URL=https://your-instance.aqua-cloud.io/aquaWebNG \
  --env AQUA_USER=your-username \
  --env AQUA_PASS=your-password \
  --env AQUA_PROJECT_ID=123 \
  -- npx -y @aqua-cloud/mcp-server

Claude Desktop

Add to your claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "aqua": {
      "command": "npx",
      "args": ["-y", "@aqua-cloud/mcp-server"],
      "env": {
        "AQUA_URL": "https://your-instance.aqua-cloud.io/aquaWebNG",
        "AQUA_USER": "your-username",
        "AQUA_PASS": "your-password",
        "AQUA_PROJECT_ID": "123"
      }
    }
  }
}

Claude Desktop users can alternatively install the one-click extension: download aqua.mcpb, then double-click it (or drag it into Claude Desktop → Settings → Extensions).

Configuration

| Variable | Required | Description | | --- | --- | --- | | AQUA_URL | yes | Your Aqua instance base URL, e.g. https://app.aqua-cloud.io/aquaWebNG | | AQUA_USER | yes | Aqua username | | AQUA_PASS | yes | Aqua password | | AQUA_PROJECT_ID | no | Default project for project-scoped tools |

What can it do?

• Items — create, read, update requirements, defects, test cases, and test scenarios; statuses, fields, assignments, comments
• Test management — read and add test steps, link items (e.g. test case ⇄ requirement), inspect item history
• Search — filtered project listings and global search across all projects
• Attachments — list, upload, download, delete
• Embedded images — images in rich-text descriptions are surfaced per item and can be downloaded locally for the assistant to view (downloadImages parameter)
• Projects — list projects and users, switch the active project
• Built-in guide — an aqua-guide MCP prompt that teaches the assistant how to use the tools effectively

Ask your assistant things like:

"Create a defect in project 123: login button unresponsive on Safari, high priority."

"List all open requirements assigned to me and add a test case for each."

Requirements

• Node.js ≥ 20.6.0
• An Aqua Cloud account with API access

Prefer a CLI?

The same functionality is available as a command-line tool — @aqua-cloud/cli — for AI agents that work better with shell commands than MCP.

License

Proprietary software © aqua cloud GmbH. See the LICENSE file for terms. Use requires a valid Aqua Cloud subscription.

Support

• Email: [email protected]
• Documentation: docs.aqua-cloud.io