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

| Tool | Description | | ---- | ----------- | | count_all_projects | Get the total number of QA Touch projects available for the domain | | count_defects | Get the total number of defects available for a QA Touch project | | count_modules | Get the total number of modules available for a QA Touch project | | count_releases | Get the total number of releases available for a QA Touch project | | count_requirements | Get the total number of requirements available for a QA Touch project | | count_test_cases | Get the total number of test cases available for a QA Touch project | | count_test_runs | Get the total number of test runs available for a QA Touch project | | create_bulk_test_cases | Create multiple QA Touch test cases from a scenario | | create_defect | Create a QA Touch defect with priority and issue summary | | create_exploratory_test_case | Create a QA Touch exploratory-session test case without structured steps | | create_module | Create a module in a QA Touch project | | create_project | Create a new QA Touch project | | create_release | Create a new release or milestone in a QA Touch project | | create_requirement | Create a requirement in a QA Touch project requirement document | | create_requirement_document | Create a requirement document in a QA Touch project | | create_test_case | Create a QA Touch test case with structured steps | | create_text_test_case | Create a QA Touch test case using the text template endpoint | | list_defect_environments | List all environments available for QA Touch defects | | list_defect_issue_types | List all issue types available for QA Touch defects | | list_defect_severities | List all severities available for QA Touch defects | | list_defect_statuses | List all statuses available for QA Touch defects | | list_defects | Get all defects from a project | | list_modules | Get all modules from a project | | list_projects | Retrieve all QA Touch projects | | list_releases | Get all releases from a project | | list_requirement_documents | List requirement documents for a QA Touch project | | list_requirements | Get all requirements from a project | | list_test_cases | Get all test cases from a project | | list_test_run_available_users | List users available for testing in a QA Touch project | | list_test_run_result_history | List history for a QA Touch test run result | | list_test_run_results | List all results for a QA Touch test run | | list_test_run_statuses | List all statuses available for QA Touch test runs | | list_test_runs | Get all test runs from a project | | list_workspace | List all QA Touch workspaces available for the domain | | search_defects | Fetch defects for a project and search issue summary | | search_modules | Fetch modules for a project and search module name | | search_project | Search test cases, modules, requirements, defects, and releases in a project | | search_releases | Fetch releases for a project and search milestone name | | search_requirements | Fetch requirements for a project and search title and description | | search_test_cases | Fetch all test cases for a project and search test case title and description | | update_test_run_result_status | Update the status of a single QA Touch test run result | | update_test_run_results_by_code | Batch update QA Touch test run result statuses by test case code |

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.