atoms_create_item

Create a new requirement, test case, or note in an ATOMS project. The server assigns a sequential ID automatically (e.g. REQ-014, TC-051, NOTE-003) based on the item type.

This tool requires editor or admin role on the project. Requests from users with the viewer role will be rejected with a permission error.

Parameters

Parameter	Type	Required	Description
`project_id`	`string (UUID)`	Yes	The project to create the item in
`type`	`string`	Yes	Item type: `requirement`, `test-case`, or `note`
`title`	`string`	Yes	Item title (1-500 characters)
`body`	`string`	No	Rich text content for the item
`summary`	`string`	No	Brief summary of the item
`domains`	`string[]`	No	Domain tags, e.g. `["security", "compliance"]`
`level`	`string`	No	Hierarchy level: `System`, `Subsystem`, or `Component`
`parent_ids`	`string[]`	No	Parent item IDs : relationships are created automatically

Example Response

{
  "status": "success",
  "data": {
    "id": "REQ-014",
    "type": "requirement",
    "title": "System shall encrypt data at rest",
    "project_id": "b2f7c1a0-1234-4abc-9def-567890abcdef"
  }
}

Notes

This tool modifies data (readOnlyHint: false, destructiveHint: false).
A change_history entry is logged automatically with actor: "mcp_claude" and event_type: "created".
When parent_ids is provided, parent relationships are created in the same transaction. Each parent ID must reference an existing item in the same project.
The assigned ID prefix depends on the type: REQ- for requirements, TC- for test cases, NOTE- for notes.

Parameters

Example Response

Notes

On this page