list_teams
List every team the authenticated user owns or belongs to. Read-only — team CRUD stays in the dashboard.
List every team the caller has visibility into. Useful before minting a token scoped to a specific team — agents can surface a picker instead of making the user hunt for a UUID. Read-only; team create/update/delete flows stay in the dashboard.
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": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Research Collective", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "personal": true, "created_at": "2026-01-12T10:05:00Z" } ], "meta": { "total": 1 }}personal is true for the auto-created signup team and false for every other team the user created or joined.
How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks team:view-any.
How is this guide?
Last updated on