atoms_record_test_result

Record an execution result for a test case. Each call appends a new entry to the test execution history : previous results are preserved, building a complete test run timeline.

Parameters

Parameter	Type	Required	Description
`project_id`	`string (UUID)`	Yes	The project containing the test case
`item_id`	`string`	Yes	The test case ID, e.g. `"TC-012"`. Must be a `test-case` item
`result`	`string`	Yes	Execution outcome: `passed`, `failed`, `blocked`, or `not-run`
`note`	`string`	No	Freeform note about the run (max 1000 characters)

Example Response

{
  "status": "success",
  "data": {
    "item_id": "TC-012",
    "result": "passed",
    "run_at": "2025-12-20T09:15:00Z",
    "run_by": "mcp_claude",
    "note": "Verified in sprint 12 regression suite",
    "message": "Test result recorded for TC-012"
  }
}

Notes

This tool modifies data (readOnlyHint: false, destructiveHint: false).
The server validates that item_id exists and is of type test-case. Passing a requirement or note ID returns an error.
Results are appended to the test_results shadow table. The latest result also becomes the latest_result returned by atoms_get_item.
Each recorded result is logged to change_history for full audit traceability.
Use atoms_get_item to retrieve the complete test execution history for a given test case.

atoms_record_test_result

Parameters

Example Response

Notes

On this page