mcloud-organizations

★ 195

by medusajs · part of medusajs/medusa-agent-skills

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.

🔥🔥✓ VerifiedFreeQuick setup

#git

🧩 One of 7 skills in the medusajs/medusa-agent-skills package — works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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