{
  "markdown": "# QA Touch MCP Server\n\nOfficial Model Context Protocol (MCP) server for QA Touch.\n\nQA 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.\n\nQA Touch - Claude Skills Repository - https://github.com/qatouch/qatouch-claude-skills\n\n## Features\n\n- List and count QA Touch projects\n- Create projects\n- List and search test cases\n- Create structured, bulk, exploratory, and text-template test cases\n- List, count, search, and create modules\n- List, count, search, and create releases/milestones\n- List, count, search, and create requirements and requirement documents\n- List, count, search, and create defects\n- List defect statuses, severities, issue types, and environments\n- List test runs, test run results, result history, and available statuses\n- Update single or batch test run result statuses\n- List users available for test execution\n- Search across project test cases, modules, requirements, defects, and releases\n- List QA Touch workspaces\n\n## Requirements\n\n- Node.js 18+\n- npm\n- QA Touch API token\n- QA Touch domain\n\n## Installation\n\nRun directly with `npx`:\n\n```bash\nnpx -y qatouch-mcp-server\n```\n\nOr install globally:\n\n```bash\nnpm install -g qatouch-mcp-server\nqatouch-mcp-server\n```\n\nThe server requires these environment variables:\n\n```bash\nQATOUCH_DOMAIN=yourdomain\nQATOUCH_API_TOKEN=yourtoken\n```\n\n## Claude Desktop Setup\n\nAdd this server to your Claude Desktop MCP configuration.\n\nWindows config location:\n\n```text\n%APPDATA%\\Claude\\claude_desktop_config.json\n```\n\nmacOS config location:\n\n```text\n~/Library/Application Support/Claude/claude_desktop_config.json\n```\n\nLinux config location:\n\n```text\n~/.config/Claude/claude_desktop_config.json\n```\n\nConfiguration:\n\n```json\n{\n  \"mcpServers\": {\n    \"qatouch\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"qatouch-mcp-server\"\n      ],\n      \"env\": {\n        \"QATOUCH_DOMAIN\": \"yourdomain\",\n        \"QATOUCH_API_TOKEN\": \"yourtoken\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving the file.\n\n## Available Tools\n\n| Tool | Description |\n| ---- | ----------- |\n| `count_all_projects` | Get the total number of QA Touch projects available for the domain |\n| `count_defects` | Get the total number of defects available for a QA Touch project |\n| `count_modules` | Get the total number of modules available for a QA Touch project |\n| `count_releases` | Get the total number of releases available for a QA Touch project |\n| `count_requirements` | Get the total number of requirements available for a QA Touch project |\n| `count_test_cases` | Get the total number of test cases available for a QA Touch project |\n| `count_test_runs` | Get the total number of test runs available for a QA Touch project |\n| `create_bulk_test_cases` | Create multiple QA Touch test cases from a scenario |\n| `create_defect` | Create a QA Touch defect with priority and issue summary |\n| `create_exploratory_test_case` | Create a QA Touch exploratory-session test case without structured steps |\n| `create_module` | Create a module in a QA Touch project |\n| `create_project` | Create a new QA Touch project |\n| `create_release` | Create a new release or milestone in a QA Touch project |\n| `create_requirement` | Create a requirement in a QA Touch project requirement document |\n| `create_requirement_document` | Create a requirement document in a QA Touch project |\n| `create_test_run_with_modules` | Create a new test run by selecting one or more module keys |\n| `create_test_case` | Create a QA Touch test case with structured steps |\n| `create_text_test_case` | Create a QA Touch test case using the text template endpoint |\n| `import_test_cases` | Import test cases into a QA Touch project using a CSV file |\n| `list_defect_environments` | List all environments available for QA Touch defects |\n| `list_defect_issue_types` | List all issue types available for QA Touch defects |\n| `list_defect_severities` | List all severities available for QA Touch defects |\n| `list_defect_statuses` | List all statuses available for QA Touch defects |\n| `list_defects` | Get all defects from a project |\n| `list_modules` | Get all modules from a project |\n| `list_projects` | Retrieve all QA Touch projects |\n| `list_releases` | Get all releases from a project |\n| `list_requirement_documents` | List requirement documents for a QA Touch project |\n| `list_requirements` | Get all requirements from a project |\n| `list_test_cases` | Get all test cases from a project |\n| `list_test_run_available_users` | List users available for testing in a QA Touch project |\n| `list_test_run_result_history` | List history for a QA Touch test run result |\n| `list_test_run_results` | List all results for a QA Touch test run |\n| `list_test_run_statuses` | List all statuses available for QA Touch test runs |\n| `list_test_runs` | Get all test runs from a project |\n| `list_workspace` | List all QA Touch workspaces available for the domain |\n| `search_defects` | Fetch defects for a project and search issue summary |\n| `search_modules` | Fetch modules for a project and search module name |\n| `search_project` | Search test cases, modules, requirements, defects, and releases in a project |\n| `search_releases` | Fetch releases for a project and search milestone name |\n| `search_requirements` | Fetch requirements for a project and search title and description |\n| `search_test_cases` | Fetch all test cases for a project and search test case title and description |\n| `update_test_run_result_status` | Update the status of a single QA Touch test run result |\n| `update_test_run_results_by_code` | Batch update QA Touch test run result statuses by test case code |\n\n## Example Prompts\n\n- List all QA Touch projects\n- Count all QA Touch projects\n- Create a project named Mobile App Regression\n- Show test cases from project ABC\n- Search test cases containing \"login\" in project ABC\n- Create a login test case in project ABC under section AUTH\n- Create 8 regression test cases for checkout in project ABC under section CHECKOUT\n- Import test cases from `/path/to/testcases.csv` into project ABC\n- List modules from project ABC\n- Create a module named Payment Gateway in project ABC\n- List releases from project ABC\n- Create release \"June Regression\" in project ABC\n- List requirements from project ABC\n- Search requirements containing \"password reset\" in project ABC\n- List requirement documents in project ABC\n- Create a requirement document named Login Requirements for release REL1 in project ABC\n- Create a requirement for valid login in document DOC1\n- List defects from project ABC\n- Show high priority defects in project ABC\n- Search defects containing \"timeout\" in project ABC\n- Create a high priority defect in project ABC for checkout payment timeout\n- List test runs from project ABC\n- Create a test run named \"Regression Run\" in project \"v7Nz\" using modules \"2BQXR\" and \"VeRDL\", assign it to user \"M7\" under milestone \"0DLB\"\n- Show test run results for test run RUN1 in project ABC\n- Show result history for result RES1 in test run RUN1\n- List available test run statuses\n- Mark result RES1 as failed in test run RUN1 for project ABC\n- Batch update TC-101 as passed and TC-102 as blocked in test run RUN1\n- List testers available for project ABC\n- Search project ABC for \"login\"\n- Generate a QA status report for project ABC\n- Identify unexecuted test cases in test run RUN1\n- For more📖 Prompt Examples: [how_to_use.txt](./how_to_use.txt)\n\n## Development\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nRun the MCP server locally:\n\n```bash\nnpm start\n```\n\nEnvironment variables are required when running locally:\n\n```bash\nQATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken npm start\n```\n\nThis repository currently defines only the `start` script in `package.json`.\n\n## Project Structure\n\n```text\nsrc/\n  api/          QA Touch API client\n  config/       Environment variable validation\n  tools/        MCP tool definitions and handlers\n  index.js      MCP server entry point and tool registration\nexamples/       Prompt and client setup examples\n```\n\n## Contributing\n\nContributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for development workflow, coding standards, and pull request guidance.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n",
  "bytes": 8450,
  "sha": "569ffee35ca3860196b593383425306b3443b81f9bc43eb7b93ce2006484477b",
  "repo_slug": "qatouch/qatouch-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_qatouch_qatouch_38c3febd/readme"
}