Organisation tools

Discover the caller's identity and orgs, then read org details and members.

Call whoami first to discover the org_oid values you’ll pass to every other tool.

whoami

The authenticated user plus a flat list of orgs.

Required scope: orgs:read.

user_oid string
email string
is_admin boolean
Platform-level superuser flag.
orgs object[]
Per-org: oid, name, slug, role, balance_aud, balance_display.

list_my_orgs

Same as whoami.orgs but with extra fields.

Required scope: orgs:read.

auto_topup_enabled boolean
domain_count integer

get_org

Required scope: orgs:read.

org_oid string path required
oid string
name string
slug string
balance_aud number
auto_topup_enabled boolean
auto_topup_threshold_aud number
auto_topup_amount_aud number
your_role string
owner, admin, or member.
member_count integer
domain_count integer

list_org_members

Required scope: orgs:read.

org_oid string path required

Returns email, display name, role, and join date for each member. Clerk IDs are deliberately omitted.

Last updated Edit this page
↑↓ navigate open esc close