Tool Reference
atoms_list_projects
Discover all accessible projects
atoms_list_projects
List all projects the authenticated user has access to. This is the entry point tool -- call it first to discover project IDs, which are required by every other project-scoped tool.
This is the ENTRY POINT tool. Call it first in any session to get project UUIDs for use with all other tools.
Parameters
This tool takes no parameters.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | -- | -- | Returns all projects accessible to the authenticated user |
Annotations
| Annotation | Value |
|---|---|
readOnlyHint | true |
destructiveHint | false |
openWorldHint | false |
Example Response
{
"status": "success",
"data": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Autopilot v3",
"description": "ADAS requirements for Level 3 highway driving",
"org_id": "org-uuid-here",
"org_name": "Acme Automotive",
"created_at": "2025-01-15T09:30:00Z"
},
{
"id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
"name": "Medical Device Firmware",
"description": "IEC 62304 compliant firmware requirements",
"org_id": "org-uuid-here",
"org_name": "Acme Automotive",
"created_at": "2025-03-01T14:00:00Z"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
id | UUID | The project identifier. Pass this as project_id to all other tools. |
name | string | Human-readable project name. |
description | string | Project description, if set. |
org_id | UUID | The organization this project belongs to. |
org_name | string | Human-readable organization name. |
created_at | ISO 8601 | When the project was created. |
Typical Workflow
atoms_status → atoms_list_projects → atoms_list_items / atoms_search / atoms_project_summaryUse the id field from the response as the project_id parameter for all subsequent tool calls:
atoms_list_items(project_id="a1b2c3d4-e5f6-7890-abcd-ef1234567890")If this tool returns an empty list, verify that your account has been invited to at least one organization and project on ATOMS.tech.