Qatouch MCP Server

QA Touch MCP Server

Official Model Context Protocol (MCP) server for QA Touch.

QA Touch is a modern test management platform for organizing projects, test cases, test runs, execution results, defects, requirements, releases, and QA reporting. This MCP server lets MCP-compatible AI assistants interact with QA Touch through a secure, tool-based interface.

Features

• List and count QA Touch projects
• Create projects
• List and search test cases
• Create structured, bulk, exploratory, and text-template test cases
• List, count, search, and create modules
• List, count, search, and create releases/milestones
• List, count, search, and create requirements and requirement documents
• List, count, search, and create defects
• List defect statuses, severities, issue types, and environments
• List test runs, test run results, result history, and available statuses
• Update single or batch test run result statuses
• List users available for test execution
• Search across project test cases, modules, requirements, defects, and releases
• List QA Touch workspaces

Requirements

• Node.js 18+
• npm
• QA Touch API token
• QA Touch domain

Installation

Run directly with npx:

npx -y qatouch-mcp-server

Or install globally:

npm install -g qatouch-mcp-server
qatouch-mcp-server

The server requires these environment variables:

QATOUCH_DOMAIN=yourdomain
QATOUCH_API_TOKEN=yourtoken

Claude Desktop Setup

Add this server to your Claude Desktop MCP configuration.

Windows config location:

%APPDATA%\Claude\claude_desktop_config.json

macOS config location:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux config location:

~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "qatouch": {
      "command": "npx",
      "args": [
        "-y",
        "qatouch-mcp-server"
      ],
      "env": {
        "QATOUCH_DOMAIN": "yourdomain",
        "QATOUCH_API_TOKEN": "yourtoken"
      }
    }
  }
}

Restart Claude Desktop after saving the file.

Available Tools

Example Prompts

• List all QA Touch projects
• Count all QA Touch projects
• Create a project named Mobile App Regression
• Show test cases from project ABC
• Search test cases containing "login" in project ABC
• Create a login test case in project ABC under section AUTH
• Create 8 regression test cases for checkout in project ABC under section CHECKOUT
• List modules from project ABC
• Create a module named Payment Gateway in project ABC
• List releases from project ABC
• Create release "June Regression" in project ABC
• List requirements from project ABC
• Search requirements containing "password reset" in project ABC
• List requirement documents in project ABC
• Create a requirement document named Login Requirements for release REL1 in project ABC
• Create a requirement for valid login in document DOC1
• List defects from project ABC
• Show high priority defects in project ABC
• Search defects containing "timeout" in project ABC
• Create a high priority defect in project ABC for checkout payment timeout
• List test runs from project ABC
• Show test run results for test run RUN1 in project ABC
• Show result history for result RES1 in test run RUN1
• List available test run statuses
• Mark result RES1 as failed in test run RUN1 for project ABC
• Batch update TC-101 as passed and TC-102 as blocked in test run RUN1
• List testers available for project ABC
• Search project ABC for "login"
• Generate a QA status report for project ABC
• Identify unexecuted test cases in test run RUN1
• For more📖 Prompt Examples: how_to_use.txt

Development

Install dependencies:

npm install

Run the MCP server locally:

npm start

Environment variables are required when running locally:

QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken npm start

This repository currently defines only the start script in package.json.

Project Structure

src/
  api/          QA Touch API client
  config/       Environment variable validation
  tools/        MCP tool definitions and handlers
  index.js      MCP server entry point and tool registration
examples/       Prompt and client setup examples

Contributing

Contributions are welcome. See CONTRIBUTING.md for development workflow, coding standards, and pull request guidance.

License

This project is licensed under the MIT License.