// Execute mcloud organizations commands to list or get Cloud organizations. Use when discovering organizations, resolving organization IDs by name, or retrieving organization details including members and subscription.
Execute mcloud authentication and context commands: login, logout, whoami, use, version, and signup. Use when setting up the CLI, switching accounts, verifying auth state, setting the active org/project/environment context, or checking the CLI version.
Execute mcloud deployments commands to list deployments, retrieve deployment details, and fetch build logs. Use when listing deployments, checking deployment status, or reading build output for debugging build failures.
Execute mcloud environments commands to list, get, create, delete, redeploy, or trigger builds for Cloud environments. Use when managing environment lifecycle, redeploying after variable changes, or starting new builds from source.
Execute mcloud logs to fetch and stream runtime logs for Cloud environments. Use when reading backend or storefront logs, filtering by time range, searching for errors, or scoping logs to a specific deployment.
Execute mcloud projects commands to list, get, or delete Cloud projects. Use when discovering projects, resolving project handles by name, or retrieving project details including linked environments.
Execute mcloud variables commands to list and get environment variables for a Cloud environment. Use when inspecting, reading, or exporting environment variables. Never pass --reveal unless the user explicitly requests secret values.
| name | mcloud-organizations |
| description | Execute mcloud organizations commands to list or get Cloud organizations. Use when discovering organizations, resolving organization IDs by name, or retrieving organization details including members and subscription. |
| allowed-tools | Bash(mcloud organizations*), Bash(mcloud use*), Bash(jq*) |
Execute mcloud organizations commands to list and retrieve Cloud organizations.
organizations list requires personal auth (browser login or personal access key). Organization access keys return 401 on this command.MCLOUD_TOKEN using an org access key, use mcloud whoami --json to get the organization ID instead.List all organizations your account has access to.
mcloud organizations list --json
Options:
--json — Output as JSONRetrieve a single organization by ID. Returns metadata, subscription details, and members.
mcloud organizations get <organization-id> --json
Arguments:
organization — Organization ID (required)Options:
-o/--organization <id> — Override the organization in active context (must match the argument)--json — Output as JSON| Field | Description |
|---|---|
id | Organization ID |
name | Organization display name |
billing_email | Billing contact email |
status | active or otherwise |
members | Array of member objects with id, role, user.email |
subscription | Current plan, period, and is_active flag |
account_holder | Billing account holder details |
# List all organizations
mcloud organizations list --json
# Set context to first organization
ORGANIZATION_ID=$(
mcloud organizations list --json \
| jq -r '.[0].id'
)
mcloud use --organization "$ORGANIZATION_ID"
# Find organization ID by name
ORGANIZATION_ID=$(
mcloud organizations list --json \
| jq -r '.[] | select(.name == "My Organization") | .id'
)
# Get organization details (subscription, members)
mcloud organizations get org_123 --json
# List member emails
mcloud organizations get org_123 --json \
| jq -r '.members[].user.email'
# Check subscription plan
mcloud organizations get org_123 --json \
| jq '{plan: .subscription.plan.name, status: .subscription.is_active}'