Version
READ

get_group

Read one group by UUID — its team, code and name. Read-only.

Fetch one group, the same row list_groups emits: id, team_id, code, name and created_at. Groups cluster users for organisation and carry no permission payload of their own — when you are reasoning about what somebody may do, read get_role instead.

Read-only. Never mutates anything.

Requires ability

The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.

Runs the same action as

The REST endpoint and this tool share one action, so validation, permissions and events are identical.

Annotations

Read-only

It reads and never changes anything.

Arguments

group_id*string

UUID of the group to fetch.

How it fails

RESOURCE_NOT_FOUND

the id is unknown, or the group belongs to a team the caller is not a member of.

TOKEN_MISSING_ABILITY

token lacks group:view.

Arguments

  • group_id (required) — UUID of the group, from list_groups.

How is this guide?

Last updated on