get_team
Fetch a single team by UUID from the caller's visibility set (owned or joined). A foreign team answers RESOURCE_NOT_FOUND.
Fetch one team the authenticated person owns or belongs to. A team they are not part of always answers RESOURCE_NOT_FOUND, never a permission error, so existence does not leak.
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
team_id*stringUUID of the team to fetch.
What it returns
{ "data": { "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Zuse Technologies", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "created_at": "2026-01-12T10:05:00+00:00" }, "meta": {}}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