Terminal
Terminal/Skill
Lists and looks up Medusa Cloud organizations, including members and subscription details, to resolve organization IDs by name.
By Medusa
Works with
npx skills add medusajs/medusa-agent-skills --skill mcloud-organizationsExecute 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}'