Create Exploratory Session
create_sessionCreates a new exploratory testing session with a name, mission, tags, assignee, and time estimate, attaching it to a project or release.
Instructions
Create a new exploratory testing session. Requires write permission. mission accepts rich HTML (the high-level charter). assigneeUserId accepts either a User _id ("user_abc...") or an email address — the email is resolved against TestDino users automatically. estimate is in minutes. Findings are not available via MCP — add them in the UI. IMPORTANT: tags must be a JSON array of strings — e.g. ["exploratory","auth"] — NOT the comma-separated form that list_sessions 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_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Session name | |
| tags | No | Array of tag strings, e.g. ["exploratory","auth"]. NOT a comma-separated string. | |
| state | No | Workflow state (default "new"). Either canonical ("under_review") or display ("Under review") form — server normalizes to lowercase+underscored so UI colors render correctly. | |
| config | No | ||
| mission | No | Rich HTML mission/charter | |
| estimate | No | Estimate in minutes | |
| projectId | Yes | Project ID | |
| releaseId | No | Attach session 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 | ||
| sessionType | No | Free-text type, e.g. "Exploratory", "Regression" | |
| linkedIssues | No | Array of linked-issue objects (same shape as list_sessions returns). | |
| assigneeUserId | No | User _id ("user_abc...") OR email address — both accepted. Email is looked up server-side. |