What is this?

This package gives AI agents — Claude Desktop, GitHub Copilot, Cursor, or any MCP-compatible client — full access to your TestKase projects. Your agent can create test cases, run test cycles, record execution results, and pull reports, all through natural language.

11 tools. Zero config beyond a token. Works out of the box.

Quick Start

1. Get a PAT token

Log in to TestKase > Settings > Personal Access Tokens > Generate New Token

2. Add to your AI agent

Edit your 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://api.testkase.com",
        "TESTKASE_PAT_TOKEN": "xyz_your_token_here"
      }
    }
  }
}

Edit your 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://api.testkase.com",
        "TESTKASE_PAT_TOKEN": "xyz_your_token_here"
      }
    }
  }
}

claude mcp add testkase -e TESTKASE_API_BASE_URL=https://api.testkase.com -e TESTKASE_PAT_TOKEN=xyz_your_token_here -- npx -y @testkase/mcp-server

Add to .cursor/mcp.json in your project root:

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

3. Restart your agent and start talking

"List my projects"
"Create a login test case in PRJ-1001 with steps"
"Run TEST-1 as pass in cycle TCYCLE-5"
"Show me the execution summary for PRJ-1001"

Tools

| Tool | Description | |------|-------------| | list_projects | List all accessible projects | | get_project_structure | Get folders, labels, members, and field options for a project | | search_testcases | Search test cases with filters, sorting, and pagination | | get_testcase | Get full test case details including steps | | manage_testcase | Create, bulk create, update, or delete test cases | | manage_folder | Create, rename, move, or delete folders (all sections) | | search_test_cycles | Search test cycles with execution progress | | manage_test_cycle | Full cycle lifecycle — CRUD, link/unlink/assign test cases | | execute_tests | Record execution results (single or bulk) | | manage_test_plan | Full plan lifecycle — CRUD, link/unlink cycles, view test cases | | get_report | Pull from 40+ report types (see below) |

Reporting

get_report covers execution, coverage, trends, team, defect, and AI-powered report types:

| Category | Report Types | |----------|-------------| | Execution | execution_summary, execution_by_cycle, execution_by_tester, execution_by_priority, execution_by_environment, execution_by_folder, execution_by_automation | | Coverage | requirement_coverage, traceability_matrix, failed_requirements, uncovered_requirements, testcase_coverage, unlinked_testcases | | Trends | execution_trend, execution_burnup, execution_burndown, test_creation, requirement_coverage_trend, execution_velocity | | Comparison | cycle_comparison, created_vs_executed, scorecard_by_folder, scorecard_by_tester | | Team | tester_workload, testcase_distribution, tester_effectiveness | | Defects | defects_by_cycle, defects_by_tester, defects_by_folder, defect_hotspots | | AI Insights | predictive_failure, smart_prioritization, testcase_quality, stale_tests, flaky_tests, suite_optimization | | Risk & Release | release_readiness, risk_heatmap_folder, risk_heatmap_feature, requirement_risk_matrix, cycle_health, project_health |

Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | TESTKASE_PAT_TOKEN | Yes | — | Personal Access Token (starts with xyz_) | | TESTKASE_API_BASE_URL | No | https://api.testkase.com | API endpoint |

Troubleshooting

| Problem | Solution | |---------|----------| | "Authentication required" | Verify your token starts with xyz_ and hasn't expired | | Tool not showing up | Restart your AI agent completely; check JSON syntax in config | | API connection errors | Verify TESTKASE_API_BASE_URL is reachable |

Links

• TestKase — Product website
• Documentation — Full platform docs
• MCP Protocol — Model Context Protocol spec

License

MIT