@testkase/mcp-server

Model Context Protocol (MCP) server for TestKase API. Enables AI agents like Claude Desktop and GitHub Copilot to interact with your TestKase testcase management system.

Features

✨ Get Testcases - Retrieve testcases with advanced filtering and search 📊 Pagination - Control page size and navigate through results 🔍 Advanced Filtering - Filter by status, priority, dates, custom fields 🔎 Search - Text search and AI-powered semantic search 🔐 Secure - Uses Personal Access Token (PAT) authentication 🤖 AI-Ready - Works with Claude Desktop, GitHub Copilot, and other MCP clients

Installation

Global Installation (Recommended)

npm install -g @testkase/mcp-server

Local Installation

npm install @testkase/mcp-server

Quick Start

1. Get Your PAT Token

1. Log in to TestKase
2. Navigate to Settings → Personal Access Tokens
3. Click "Generate New Token"
4. Copy the token (starts with xyz_)

2. Configure Your AI Agent

For Claude Desktop

Edit your Claude config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "testkase": {
      "command": "npx",
      "args": ["-y", "@testkase/mcp-server"],
      "env": {
        "TESTKASE_API_BASE_URL": "https://apiqa.testkase.com",
        "TESTKASE_PAT_TOKEN": "xyz_your_pat_token_here"
      }
    }
  }
}

For GitHub Copilot (VS Code)

Edit your Copilot config file:

• Windows: %APPDATA%\Code\User\globalStorage\github.copilot\mcp.json
• macOS: ~/Library/Application Support/Code/User/globalStorage/github.copilot/mcp.json

{
  "mcpServers": {
    "testkase": {
      "command": "npx",
      "args": ["-y", "@testkase/mcp-server"],
      "env": {
        "TESTKASE_API_BASE_URL": "https://apiqa.testkase.com",
        "TESTKASE_PAT_TOKEN": "xyz_your_pat_token_here"
      }
    }
  }
}

3. Restart Your AI Agent

• Claude Desktop: Close and reopen completely
• VS Code: Restart VS Code

4. Start Using!

Ask your AI agent:

• "Get testcases for project PRJ-1030 in organization 1171"
• "Show high priority testcases from project ABC-123"
• "Find testcases containing 'login' in project XYZ-456"

Available Tools (26 Total)

Testcases (12 tools)

• get_testcases - Retrieve testcases with filtering, pagination, and search
• get_testcase_detail - Get detailed information about a specific testcase
• get_testcase_history - View complete change history of a testcase
• create_testcase - Create a new testcase with optional test steps
• create_bulk_testcase - Create multiple testcases at once
• update_testcase_field - Update specific fields for one or multiple testcases
• delete_testcase - Delete single or multiple testcases
• clone_testcase - Clone an existing testcase with all its steps
• create_test_step - Create or update test steps for a testcase
• delete_test_step - Delete test steps from a testcase
• download_testcases - Download testcases as CSV file
• import_testcases - Import testcases from CSV file

Folders (4 tools)

• get_folders - Get folder/section structure of a project
• create_folder - Create a new folder in a project
• delete_folder - Delete a folder and its subfolders
• update_folder - Rename or update folder details

Labels (2 tools)

• get_labels - Get all labels/tags available in a project
• create_label - Create new labels for a project

Projects (1 tool)

• get_my_projects - Get all projects the user has access to

Auth & Organization (2 tools)

• get_user_profile - Get current logged-in user profile information
• get_organization - Get current user organization details

Integration (3 tools)

• get_mapped_issues - Get mapped issues for a specific testcase
• search_issues - Search issues from integrated platforms (Jira, GitHub, GitLab)
• map_issues - Map integration issues to a TestKase requirement/defect

AI & Issues (2 tools)

• generate_testcases - Generate testcases using AI from requirement text
• create_issue - Create or update a requirement or defect issue

Configuration

Environment Variables

• TESTKASE_API_BASE_URL: API base URL (default: https://apiqa.testkase.com)
• TESTKASE_PAT_TOKEN: Your Personal Access Token (required)

Using with Different Environments

Production:

"env": {
  "TESTKASE_API_BASE_URL": "https://api.testkase.com",
  "TESTKASE_PAT_TOKEN": "xyz_your_token"
}

Local Development:

"env": {
  "TESTKASE_API_BASE_URL": "http://localhost:8080",
  "TESTKASE_PAT_TOKEN": "xyz_your_token"
}

Usage Examples

Basic Queries

"Show me testcases for project PRJ-1030 organization 1171"
"Get high priority active testcases from project PRJ-1030 org 1171"
"Find testcases about 'authentication' in project PRJ-1030 org 1171"
"Show testcases updated this week in project PRJ-1030 org 1171"

Detailed Information

"Get detailed information about testcase TC-123 in project PRJ-1030 org 1171"
"Show me the history of changes for testcase TC-456 in project PRJ-1030 org 1171"

Project Organization

"Show me all folders in project PRJ-1030 org 1171"
"List all labels available in project PRJ-1030 org 1171"
"Get all issues/defects for project PRJ-1030 org 1171"

User Projects

"Show me all my projects"
"List all projects I have access to"

Troubleshooting

"Authentication required" error

• Verify your PAT token is correct and starts with xyz_
• Check that the token hasn't been revoked
• Ensure it hasn't expired

Tool not showing up

1. Restart your AI agent completely
2. Check the config file path is correct
3. Verify the JSON syntax is valid

API connection issues

• Check that the API base URL is correct
• Verify the TestKase API is accessible
• Test with curl: curl -H "Authorization: Bearer xyz_YOUR_TOKEN" https://apiqa.testkase.com/api/v1/projects/testcases/get-testcase/PROJECT_ID?organizationId=ORG_ID

Documentation

• TestKase Documentation
• Model Context Protocol

Support

• 📧 Email: [email protected]
• 🌐 Website: testkase.com

Security

• PAT tokens are sent securely via HTTPS
• Tokens are validated by TestKase's backend
• Each user has their own unique token
• Tokens can be revoked at any time

License

MIT © TestKase