Skill

mcloud-organizations

Name: mcloud-organizations
Author: Medusa

manage Medusa Cloud organizations

Published by Medusa Updated May 9

Covers Operations Medusa

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.

SKILL.md

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

More skills from the medusa-agent-skills repository

View all 17 skills

SkillTagsUpdated

More from Medusa

View publisher

SkillTagsUpdated