List test plans

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

What it does

Lists the test plans in the connected workspace, 20 per page, optionally filtered by name. A test plan is a named bundle of test cases you want to run together, such as a quick smoke check before every deploy or a full regression pass before a release. Call it before testplan.create so you do not create a duplicate (plan names must be unique in the workspace). Returns { items: [{ id, uri, name, description, status, kind, priority }], page, totalPages, totalItems }. Read-only.

Ask your agent

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

  • “Do we already have a smoke test plan?”
  • “Show me all the test plans in this project”
  • “Find the release checklist plan we made last week”

Inputs

NameTypeDescription
title
optional
stringCase-insensitive text to look for in the plan name, e.g. "smoke" matches "Checkout smoke". Omit to list all plans.
page
optional
integerPage number, starting at 1 (default 1). Each page holds up to 20 plans; 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": "testplan.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.