List test cases

case.listReadsOnly looks things up; never changes your workspace.

What it does

Lists the test cases in the connected workspace, 20 per page, sorted by caseId. A test case is one written check of the app: steps to follow and the result to expect. Call it before case.create or case.create_batch so you do not write duplicates, and to find the case you want to read, update, waive or delete. Each row has two ids: id (internal, e.g. "AAtc-kzqd-mwpe-rtya-hbnc-xufo-lgsi") is what every other tool takes, while caseId (e.g. "GenTC-0001") is the human-readable label shown in the app. Returns { items: [{ id, uri, caseId, title, status, acceptanceCriterionLabel, isWaived, severity, automationStatus }], page, totalPages, totalItems }. Both ACTIVE and INACTIVE (archived) cases are listed; there is no status filter. Read-only. Use testcase.get for the steps of one case.

Ask your agent

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

  • “What test cases do we already have for login?”
  • “List all the tests in this project”
  • “Is there already a test for password reset?”

Inputs

NameTypeDescription
title
optional
stringCase-insensitive text matched against the title OR the human caseId, e.g. "checkout" or "GenTC-0012". Omit to list everything.
page
optional
integerPage number, starting at 1 (default 1). Each page holds up to 20 cases; check totalPages in the result.

The MCP call

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "case.list",
    "arguments": {
      "title": "<title>"
    }
  }
}

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.