READ
get_team
Fetch a single team by UUID from the caller's visibility set (owned + membership). Foreign teams return RESOURCE_NOT_FOUND.
Fetch one team the authenticated user owns or belongs to. Foreign teams always return RESOURCE_NOT_FOUND to prevent existence leaks.
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
team_id*stringUUID of the team to fetch.
What it returns
{ "data": { "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Research Studio", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "personal": false, "created_at": "2026-05-18T10:05:00Z" }}How it fails
RESOURCE_NOT_FOUNDteam_id is not a valid UUID, or it falls outside the caller's visibility set.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks team:view.
How is this guide?
Last updated on