Edit a test plan or change its test cases

testplan.updateChanges dataCreates, updates or deletes something in your workspace.

What it does

Changes a test plan of the connected workspace: name (unique in the workspace), description, kind, status (INACTIVE archives it), priority, and which test cases it holds. Send only what changes. addTestCaseIds adds cases (ids from case.list; cases already in the plan or from another workspace are skipped and counted), addSuiteIds adds every case of those features / stories, removeTestCaseIds takes cases out of the plan (the cases themselves are not deleted, and runs already created keep them). Get the plan id from testplan.list. Returns {success, data: the plan with testCaseIds and caseCount, added, skipped, removed}.

Ask your agent

You don’t call testplan.update yourself. Say something like this to Claude Code, Cursor or another MCP-connected agent:

  • “Add the new payment cases to the smoke plan”
  • “Rename the regression plan to "Full regression"”
  • “Take the retired coupon cases out of the release plan”

Inputs

NameTypeDescription
testPlanId
required
stringId of the plan (the id from testplan.list).
name
optional
stringNew name, unique in the workspace.
description
optional
string | nullNew description; null clears it.
kind
optional
enumWhat kind of bundle it is.
Allowed: smokesanitysecurityregressionrelease-acceptancecustom
status
optional
enumACTIVE = in use; INACTIVE = archived, hidden from pickers.
Allowed: ACTIVEINACTIVE
priority
optional
enum | nullP0 = most important; null clears it.
addTestCaseIds
optional
string[]Test case ids (id from case.list) to add.
addSuiteIds
optional
string[]Feature or story ids (from feature.list) whose cases are all added.
removeTestCaseIds
optional
string[]Test case ids to take out of the plan.

The MCP call

What the agent’s MCP client sends (placeholders in angle brackets):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan.update",
    "arguments": {
      "testPlanId": "<testPlanId>"
    }
  }
}

Connect your agent

npx -y @testmaze/mcp init tmt_xxx
claude mcp add tm --scope project -- npx -y @testmaze/mcp

Create the token in your Test Maze workspace under Settings → MCP. Setup for Cursor, Cline, Gemini CLI and Codex CLI is shown there too.