/mcloud-organizations

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*)

Cloud CLI: Organizations Commands

Execute `mcloud organizations` commands to list and retrieve Cloud organizations.

Constraints

• `organizations list` requires **personal auth** (browser login or personal access key). Organization access keys return 401 on this command.
• When authenticated with `MCLOUD_TOKEN` using an org access key, use `mcloud whoami --json` to get the organization ID instead.

Commands

organizations list

List all organizations your account has access to.

mcloud organizations list --json

**Options:**

• `--json` — Output as JSON

organizations get

Retrieve 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

Organization Fields (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 |

Examples

# 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}'