AI Cursor

QA Touch MCP Server

Connect AI assistants directly with QA Touch to manage projects, test cases, test runs, defects, requirements, releases, and QA workflows through the Model Context Protocol (MCP).


What is QA Touch MCP?

QA Touch MCP Server enables AI assistants such as Claude Desktop and other MCP-compatible clients to securely interact with your QA Touch workspace.

With natural language commands, users can:

  • Create and manage projects
  • Generate and maintain test cases
  • Execute and update test runs
  • Manage defects and requirements
  • Search QA assets instantly
  • Generate QA reports and insights

integration icon 1integration icon 2

what is Cursor AI?

Cursor AI is an AI-native code editor designed to accelerate software development by integrating advanced large language models directly into the programming environment.

Key Features

Project Management

  • List all projects
  • Create new projects
  • Count available projects

Test Case Management

  • Create structured test cases
  • Generate bulk test cases
  • Create exploratory test cases
  • Create text-template test cases
  • Search and manage test cases

Module Management

  • Create modules
  • Search modules
  • Count modules

Release Management

  • Create releases and milestones
  • Search releases
  • Count releases

Requirement Management

  • Create requirement documents
  • Create requirements
  • Search requirements
  • Count requirements

Defect Management

  • Create defects
  • Search defects
  • List defect statuses
  • List severities
  • List issue types
  • List environments

Test Run Management

  • View test runs
  • View execution results
  • View execution history
  • Update execution status
  • Batch update test results

Search across:

  • Test Cases
  • Modules
  • Requirements
  • Defects
  • Releases

  Image


Installation

Option 1: Run with NPX

npx -y qatouch-mcp-server

Option 2: Install Globally

npm install -g qatouch-mcp-server

qatouch-mcp-server

Prerequisites

Before running the MCP server, ensure you have:

RequirementVersion
Node.js18+
npmLatest
QA Touch DomainRequired
QA Touch API TokenRequired

Environment Variables

Configure the following variables:

QATOUCH_DOMAIN=yourdomain
QATOUCH_API_TOKEN=yourtoken

Example:

QATOUCH_DOMAIN=demo
QATOUCH_API_TOKEN=xxxxxxxxxxxxxxxx

Cursor AI Editor Setup

Step 1 : Click bottom Profile name Step 2 : Click Setting menu Step 3 : Sidebar Select “Tools & MCP” click the menu Step 4 : Home Tab and Home MCP Server => New MCP Server

Image   Image   Image

Configuration Example

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

Image   Image   Image   Image

Example Prompts

Example 1 - Get all projects from QA Touch and export them to a csv file with project name, project key,status and estimate time

Image   Image  

Dashboard Generate

Example 3 - Create a Rich QA analytics dashboard for Project Ecommerce store PROJECT_KEY

PROJECT_KEY replace projectkey Image   Image   Image   Image

Available Tools

Project Tools

ToolPurpose
list_projectsRetrieve projects
create_projectCreate project
count_all_projectsCount projects

Test Case Tools

ToolPurpose
list_test_casesView test cases
search_test_casesSearch test cases
create_test_caseCreate test case
create_bulk_test_casesBulk generation
create_exploratory_test_caseExploratory testing
create_text_test_caseText-based test cases

Defect Tools

ToolPurpose
list_defectsView defects
search_defectsSearch defects
create_defectCreate defect
list_defect_statusesDefect statuses
list_defect_severitiesSeverity list

Test Run Tools

ToolPurpose
list_test_runsView runs
list_test_run_resultsView results
update_test_run_result_statusUpdate result
update_test_run_results_by_codeBatch update

Example Prompts

Ask your AI assistant:

Projects

List all QA Touch projects
Create a project named Mobile App Regression

Test Cases

Show test cases from project ABC
Create a login test case in project ABC
Generate 20 checkout test cases

Test Cases Export Prompts

Test cases with pagination, exported to CSV Get all test cases from QA Touch project [PROJECT_KEY]
across all pages, then export the complete list to a CSV with all fields
(case code, title, module, type, priority, steps, etc).
Test runs with pagination, exported to CSV
Get all test run results from QA Touch project [PROJECT_KEY] for test run [TESTRUN_KEY],
paginating through all pages, then export the results to a CSV file.
Defects with pagination, exported to CSV
Get all defects from QA Touch project [PROJECT_KEY], paginating through every page,
then export them to a CSV with defect ID, summary, priority, severity, status, and reporter.
Combined multi-entity export
For QA Touch project [PROJECT_KEY]: pull all test cases (paginated) into one CSV
and all defects (paginated) into a separate CSV both as downloadable files.

Defects

Show high priority defects in project ABC
Create a payment timeout defect

Test Runs

List test runs from project ABC
Show failed test cases from RUN1

📂 Project Structure

src/
├── api/
├── config/
├── tools/
└── index.js

examples/

🤝 Contributing

Contributions are welcome.

Please follow:

  1. Fork repository
  2. Create feature branch
  3. Submit pull request
  4. Follow coding standards

📜 License

Released under the MIT License.


Need Help?

For support, documentation, and product information:

QA Touch Test Management Platform

Manage Test Cases • Test Runs • Defects • Requirements • Releases • QA Reporting

Start building smarter QA workflows with AI-powered automation today.