create_test_plan
Create a test plan in TestCollab with optional test cases, configurations, and assignments. Automates the creation process including bulk-add and assignment.
Instructions
Create a test plan in TestCollab using a single MCP tool call.
Before calling this tool:
Ask follow-up questions for missing required information.
Do not infer or auto-generate required values like project_id.
Execution flow:
POST /testplans
POST /testplantestcases/bulkAdd (optional)
POST /testplanconfigurations (optional)
POST /testplans/assign (optional)
Optional:
project_id
title (defaults to "Test Plan DD Month YYYY HH:mm:ss" if omitted)
description
priority (0=Low, 1=Normal, 2=High)
test_plan_folder (ID or title)
release (ID or title)
start_date, end_date
custom_fields
test_cases (test_case_ids/selector/assignee; assignee supports user ID/"me"/name)
configurations
assignment (supports user IDs/"me"/names; if user says "assign to me", use "me")
Example: { "project_id": 16, "title": "Release 2.9 Regression", "priority": 1, "test_cases": { "test_case_ids": [101, 102, 103] }, "configurations": [ [{ "field": "Browser", "value": "Chrome" }, { "field": "OS", "value": "Windows" }] ], "assignment": { "executor": "team", "assignment_criteria": "testCase", "assignment_method": "automatic", "user_ids": [27, 31] } }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | No | Project ID (optional if TC_DEFAULT_PROJECT is set) | |
| title | No | Test plan title (optional; defaults to "Test Plan DD Month YYYY HH:mm:ss") | |
| description | No | Test plan description (HTML supported) | |
| priority | No | Priority: 0=Low, 1=Normal, 2=High | |
| test_plan_folder | No | Test plan folder ID or title (null to place at root) | |
| release | No | Release ID or title | |
| start_date | No | Planned start date (YYYY-MM-DD) | |
| end_date | No | Planned end date (YYYY-MM-DD) | |
| custom_fields | No | Array of test plan custom field values | |
| test_cases | No | Test cases to bulk-add immediately after plan creation | |
| configurations | No | Configuration matrix to attach to the test plan | |
| assignment | No | Assignment payload to execute after creation |