List releases, sprints and milestones
release.listReadsOnly looks things up; never changes your workspace.What it does
Lists the releases, sprints and milestones in the connected workspace, newest first. All three are time-boxed buckets you plan features into, told apart by kind: release = a version you ship to users ("v2.0", "June release"); sprint = a short, fixed work cycle, usually 1 to 2 weeks ("Sprint 23"); milestone = a named goal or checkpoint that is not a shipment ("Beta cohort 4", "Investor demo"). Call it before release.create to avoid duplicates, to find the id for feature.set_release or testrun.create, or to pick the open one before release.ship. Returns {items: [{id, uri, name, kind, status, startDate, targetDate, shippedAt}], totalItems}. status is planned, active, shipped or cancelled. Not paginated. Read-only.
Ask your agent
You don’t call release.list yourself. Say something like this to Claude Code, Cursor or another MCP-connected agent:
- “What releases do we have planned?”
- “Which sprint are we in right now?”
- “Show me everything we have shipped so far”
Inputs
None. The agent calls it with an empty object.
The MCP call
What the agent’s MCP client sends (placeholders in angle brackets):
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "release.list",
"arguments": {}
}
}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.
More releases tools
- Create a release, sprint or milestone
release.create - Mark a release as shipped
release.ship - Cancel a release
release.cancel