Suggest Definition of Ready / Done items for a user story

userstory.suggest_checklistChanges dataCreates, updates or deletes something in your workspace.

What it does

Adds story-specific items to a user story's Ready and/or Done checklist, unticked, marked as AI suggestions. Only a person ticks items, in the Test Maze web app; agents cannot. Skip items the workspace list already has (see userstory.gates) and anything the automatic checks cover (statement, acceptance cases, points, review, test results). Duplicates are ignored. Returns the updated gates.

Ask your agent

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

  • “Suggest what has to be true before we start the refund story”

Inputs

NameTypeDescription
suiteId
required
stringId of the user story.
ready
optional
string[]Definition of Ready items to add.
done
optional
string[]Definition of Done items to add.

The MCP call

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "userstory.suggest_checklist",
    "arguments": {
      "suiteId": "<suiteId>"
    }
  }
}

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.