URL: /mcp/tools/orgs

---
title: Organisation tools
description: 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`.

<ResponseField name="user_oid" type="string" />
<ResponseField name="email" type="string" />
<ResponseField name="is_admin" type="boolean">Platform-level superuser flag.</ResponseField>
<ResponseField name="orgs" type="object[]">Per-org: `oid`, `name`, `slug`, `role`, `balance_aud`, `balance_display`.</ResponseField>

## `list_my_orgs`

Same as `whoami.orgs` but with extra fields.

Required scope: `orgs:read`.

<ResponseField name="auto_topup_enabled" type="boolean" />
<ResponseField name="domain_count" type="integer" />

## `get_org`

Required scope: `orgs:read`.

<ParamField path="org_oid" type="string" required />

<ResponseField name="oid" type="string" />
<ResponseField name="name" type="string" />
<ResponseField name="slug" type="string" />
<ResponseField name="balance_aud" type="number" />
<ResponseField name="auto_topup_enabled" type="boolean" />
<ResponseField name="auto_topup_threshold_aud" type="number" />
<ResponseField name="auto_topup_amount_aud" type="number" />
<ResponseField name="your_role" type="string">`owner`, `admin`, or `member`.</ResponseField>
<ResponseField name="member_count" type="integer" />
<ResponseField name="domain_count" type="integer" />

## `list_org_members`

Required scope: `orgs:read`.

<ParamField path="org_oid" type="string" required />

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