Version
DESTRUCTIVE

create_team

Create a team owned by the caller. Growth-tier capability.

Creates a team owned by the caller. Teams are the tenant every project, plan and subscription hangs off; the caller becomes the owner, which is not a membership row and cannot later be removed or re-roled.

Growth-tier capability. On a lower tier this returns TEAM_TIER_REQUIRED and creates nothing. See what the tier gates.

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.

Fires one event

Delivered to every endpoint subscribed to it once the change is made.

Annotations

DestructiveOpen world

A client that honours annotations asks a person before running it. It reaches beyond Subscriby: a connector, a provider or a member.

Arguments

name*string

Team name, 1..255 characters.

What it returns

{  "data": {    "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",    "name": "Research Collective",    "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80"  }}

How it fails

AUTHENTICATION_REQUIRED

no authenticated user on the request.

TOKEN_MISSING_ABILITY

token lacks team:create.

TEAM_TIER_REQUIRED

the caller's platform tier does not include Teams.

VALIDATION_FAILED

name empty or longer than 255 characters.

How is this guide?

Last updated on