> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attention.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams

> List teams and their members; create, update, archive, and reorganize teams; add or remove team members.

Teams group users in Attention and control which calls, scorecards, and labels apply to them. Teams can be nested arbitrarily — every team has an optional parent, and the read tools return the full hierarchy.

Read tools (`list_teams`, `get_team`, `get_team_members`) require only `mcp:read`. All write tools require `mcp:write` **plus** the admin role.

## Read tools

### list\_teams

> [!NOTE]
>
> Scope: `mcp:read`. No parameters.

List all teams in your organization with their structure and sub-teams.

**Returns:** A Markdown tree of teams with IDs, names, and parent relationships.

**Example prompt:** *"What teams do we have in Attention?"*

***

### get\_team

> [!NOTE]
>
> Scope: `mcp:read`.

Get details about a specific team, including its sub-teams. Use the team ID from `list_teams`.

**id** `string` *required*

The team ID.

**Returns:** Team details (name, parent team, sub-teams).

***

### get\_team\_members

> [!NOTE]
>
> Scope: `mcp:read`.

List all members of a specific team — names, emails, and roles.

**id** `string` *required*

The team ID.

**Returns:** Markdown list of team members with names, emails, and roles.

## Write tools

### create\_team

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Create a new team in your organization. Teams organize users and control which calls, scorecards, and labels apply to them.

**name** `string` *required*

The team name. Will be prefixed with the organization name automatically (e.g. `Sales` becomes `[Acme Corp] Sales`).

**parent\_team\_id** `string`

UUID of the parent team. Omit for a top-level team. Use `list_teams` to find team IDs.

**Returns:** ID, name, and parent team of the newly created team.

***

### update\_team

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Update a team's name or parent team. Omitted fields preserve their current values.

**team\_id** `string` *required*

The UUID of the team to update.

**name** `string`

New team name.

**parent\_team\_id** `string`

New parent team UUID. Use `list_teams` to find team IDs.

***

### archive\_team

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Archive or unarchive a team. Archived teams are hidden from most views but their data is preserved — this is reversible.

**team\_id** `string` *required*

The UUID of the team.

**archived** `boolean` *required*

Set to `true` to archive, `false` to unarchive.

***

### change\_team\_parent

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Move a team under a different parent team, or make it top-level by omitting `parent_team_id`. Use `list_teams` to see the current hierarchy.

**team\_id** `string` *required*

UUID of the team to move.

**parent\_team\_id** `string`

UUID of the new parent team. Omit to make the team top-level.

***

### add\_team\_member

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Add a user to a team. Provide either `user_id` or `user_email`.

**team\_id** `string` *required*

The UUID of the team to add the member to.

**user\_id** `string`

UUID of the user to add. Provide either `user_id` or `user_email`.

**user\_email** `string`

Email of the user to add. Provide either `user_id` or `user_email`.

**role\_id** `string`

UUID of the role to assign. If omitted, the user's default role is used. Use [`list_roles`](https://docs.attention.com/mcp/tools/users-roles#list_roles) to find role IDs.

**primary\_team** `boolean`

Whether this should be the user's primary team.

***

### remove\_team\_member

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Remove a user from a team. Use `get_team_members` to find user IDs.

**team\_id** `string` *required*

The UUID of the team.

**user\_id** `string` *required*

UUID of the user to remove from the team.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.