list_groups
List groups across every team the caller owns or belongs to, with the permissions each group shares and the members in it.
List groups across every team the caller owns or belongs to. A group bundles members who share a set of permissions on top of their roles; each row carries those permissions and the member_ids in it. Read-only; groups are edited in the application.
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
It reads and never changes anything.
Arguments
This tool takes no arguments.
What it returns
{ "data": [ { "id": "1f68d92a-04c5-4e83-97b1-3d6a05e2f847", "team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "code": "release-crew", "name": "Release crew", "permissions": ["webhook-endpoint:view-any", "webhook-delivery:view-any"], "member_ids": ["5e0c7a2d-9b1f-4c3e-8d6a-2f4b7c9e1a30"] } ], "meta": { "total": 1 }}How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks group:view-any.
How is this guide?
Last updated on