Create Manual Test Run
create_manual_runCreate a manual test run for a project, choosing all test cases or scoping to specific cases and suites, with tags, notes, release linking, and environment details.
Instructions
Create a new manual test run. Requires write permission. selectionMode controls which test cases are included: "all" (default — every case in the project) or "selected" (use testCaseIds and/or suiteIds to scope). releaseId attaches the run to a release. note accepts rich HTML. IMPORTANT: tags must be a JSON array of strings here — e.g. ["smoke","regression"] — NOT the comma-separated form that list_manual_runs accepts as a filter.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"name": "<name>"
},
"name": "create_manual_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Run name | |
| note | No | Rich HTML note | |
| tags | No | Array of tag strings, e.g. ["smoke","regression"]. NOT a comma-separated string. | |
| links | No | Array of link objects. | |
| state | No | Workflow state (default "new"). Either canonical ("in_progress") or display ("In Progress") form — server normalizes to lowercase+underscored so UI colors render correctly. | |
| forecast | No | Numeric forecast/target for the run (model stores this as a number). | |
| suiteIds | No | Suite IDs whose cases are included when selectionMode="selected" | |
| projectId | Yes | Project ID | |
| releaseId | No | Attach run to this release | |
| attachments | No | Not supported over MCP: any value is refused with a 400. Tell the user to upload files in the TestDino UI. | |
| environment | No | Environment label, e.g. "Staging" | |
| testCaseIds | No | Case IDs to include when selectionMode="selected" | |
| linkedIssues | No | Array of linked-issue objects (use the same shape returned by list_manual_runs). | |
| selectionMode | No | Default "all" | |
| includeUnsorted | No | Also include cases with no suite when selectionMode="selected" |