List Clusters
list-clustersList RawTree dedicated clusters in an organization to retrieve cluster IDs, names, lifecycle status, resources, and storage metadata for discovery or provisioning checks.
Instructions
Purpose: List RawTree dedicated clusters accessible in an organization.
Returns: Cluster IDs, names, creation times, lifecycle status, resources, whether each cluster can be paused or resumed, optional s3_storage metadata for customer-owned default storage, and s3_storage_access containing external_id and resource_tag (null for older clusters without saved identity). s3_storage exposes data and backups, each with bucket and path. An empty path means the bucket root. Role ARNs and secret credentials are never returned.
With user authentication, discovery spans enabled regions. If a region is unavailable, healthy clusters are returned with unavailable_regions (region IDs and names). This is a partial list: do not infer that missing clusters do not exist; retry discovery. Each regional lookup is limited to five seconds. Authentication failures and total regional outages remain errors.
Auth: The RawTree API requires a user access token and organization membership. Authorization is enforced by the API.
When to use:
User asks which dedicated clusters exist
You need a cluster ID or current lifecycle status
You need to inspect provisioned resources before creating another cluster
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"organization": "<organization>"
},
"name": "list-clusters"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organization | Yes | Organization whose dedicated clusters should be listed. |