Teams

create_team

Create a new agent team.

The three shared_* fields form the team’s shared context, merged with each member agent’s own configuration at prompt-assembly time: shared_instruction is prepended to member instructions; shared_allowed_tools is a list of tool scope strings or slugs granted to all members; shared_mounted_skills is a list of skill slugs mounted on all members. Add agents to the team afterwards with set_agent_team. The slug is derived from name (deduped within the org).

Both lists are checked against the org: every shared_allowed_tools entry must resolve in the tool catalog (list_org_tools) and every shared_mounted_skills entry must be an existing skill slug (list_skills).

Parameter	Type	Required	Description
description	string	no
name	string	yes
org	string	no
shared_allowed_tools	string[]	no
shared_instruction	string	no
shared_mounted_skills	string[]	no

delete_team

Delete a team (by id or slug). Member agents are NOT deleted — they become ungrouped and revert to their own configuration.

Parameter	Type	Required	Description
org	string	no
team	string	yes

get_team

Get full detail for one team (by id or slug): its shared context (shared instruction, allowed tools, mounted skills) and the agents that belong to it.

Parameter	Type	Required	Description
org	string	no
team	string	yes

list_teams

List the agent teams in an organization, ordered for display.

Each entry includes the team’s slug, name, description, and current member count. Call get_team for a team’s shared context and member list.

Paged: the response carries total, has_more and next_offset — pass next_offset back as offset to walk the rest.

Parameter	Type	Required	Description
limit	integer	no	Max rows to return (1–200).
offset	integer	no	Rows to skip — pass the previous response’s next_offset.
org	string	no

set_agent_team

Set (or clear) an agent’s team membership.

Pass team (id or slug) to move the agent onto that team — it then inherits the team’s shared context. Omit team (or pass an empty string) to remove the agent from any team, reverting it to its own configuration.

Parameter	Type	Required	Description
agent	string	yes
org	string	no
team	string	no

update_team

Update a team (by id or slug). Partial: only the fields you pass are changed; omit the rest to leave them untouched.

Renaming (name) re-derives the slug. shared_allowed_tools and shared_mounted_skills REPLACE the current lists (pass an empty list to clear). Pass an empty string for shared_instruction to clear it. Changes apply immediately to every current member’s assembled prompt. Both lists are checked against the org before they are stored — see create_team.

Parameter	Type	Required	Description
description	string	no
name	string	no
org	string	no
shared_allowed_tools	string[]	no
shared_instruction	string	no
shared_mounted_skills	string[]	no
team	string	yes