> ## 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.

# Users & Roles

> List users and roles; update profiles and team memberships; manage user roles and lifecycle; send and manage invitations.

This group covers everything related to users in your Attention org: listing reps and roles, updating user profiles, changing team memberships, assigning roles, deactivating and reactivating accounts, and managing pending invitations.

Several tools require **user-level authentication** (not org-level API keys) — these are flagged below. The reason is that they perform actions tied to a specific actor (e.g. invitation emails include the inviter's name).

## Read tools

### list\_reps

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

List all users (reps, managers, admins) in your organization. Optionally filter by email, ID, or team.

**email** `string`

Filter by user email address.

**user\_id** `string`

Filter by user ID.

**team\_id** `string`

Filter by team ID.

**include\_deleted** `boolean`

Include soft-deleted (deactivated) users.

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

***

### list\_roles

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

List all roles defined in your organization with their type (`admin`, `manager`, or `sales_rep`). Use this before assigning roles via `manage_user_role` or `update_user`.

**Returns:** Markdown list of roles with name, type, and UUID.

***

### list\_invitations

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

List pending invitations in your organization. Shows email, team, role, seat type, and expiration status.

**page** `integer`

Page number. Default: `1`.

**size** `integer`

Page size. Default: `20`. Maximum: `50`.

**email** `string`

Filter invitations by email address (exact match).

**team\_id** `string`

Filter invitations by team ID.

## User write tools

### update\_user

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

Update a user's profile, role, or seat type. Omitted fields preserve current values (read-before-write merge).

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

The UUID of the user to update.

**first\_name** `string`

New first name.

**last\_name** `string`

New last name.

**role\_id** `string`

UUID of the role to assign. Use `list_roles` to find role IDs.

**seat\_type** `string`

Seat type: `recording` (can record calls) or `listener` (view-only).

**bot\_name** `string`

Custom name for the user's recording bot.

**deals\_enabled** `boolean`

Whether deal/pipeline features are enabled for this user.

***

### update\_user\_teams

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

Add or remove a user from teams in a single operation. Can also set the user's primary team. At least one of `teams_to_add` or `team_ids_to_remove` is required.

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

The UUID of the user.

**teams\_to\_add** `array`

Teams to add the user to. Each entry: `{ "team_id": "...", "primary": false }`. Only one team can be primary.

**team\_ids\_to\_remove** `array`

Team UUIDs to remove the user from.

## Role and lifecycle tools

### manage\_user\_role

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

Assign or remove a role for a user. Use `list_roles` to find available role IDs.

**action** `string` *required*

Action to perform: `set` to assign, `remove` to remove.

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

UUID of the user.

**role\_id** `string` *required*

UUID of the role.

***

### delete\_user

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role and **user-level authentication** (org-level API keys are not supported). Destructive but reversible via `reactivate_user`.

Soft-delete (deactivate) a user. The user loses access immediately but can be reactivated later. Their team memberships are preserved.

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

UUID of the user to deactivate.

***

### reactivate\_user

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

Reactivate a previously deactivated user. Restores their access and team memberships.

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

UUID of the user to reactivate.

## Invitation tools

### invite\_user

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role and **user-level authentication** (org-level API keys are not supported — the invitation email includes the inviter's name).

Invite a user to your organization by email. The recipient receives an email invitation to join the specified team with the given role.

**email** `string` *required*

Email address of the user to invite.

**role\_id** `string` *required*

Role UUID to assign. Use `list_roles` to get available role IDs.

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

Team UUID to add the user to. Use [`list_teams`](https://docs.attention.com/mcp/tools/teams#list_teams) to get available team IDs.

**seat\_type** `string` *required*

Seat type: `listener` (view-only) or `recording` (can record calls).

***

### update\_invitation

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role and **user-level authentication**.

Update a pending invitation's seat type. Only pending (not yet accepted) invitations can be updated.

**invitation\_id** `string` *required*

UUID of the invitation to update.

**seat\_type** `string` *required*

New seat type: `listener` or `recording`.

***

### delete\_invitation

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role and **user-level authentication**. Destructive.

Delete a pending invitation. Only pending (not yet accepted) invitations can be deleted.

**invitation\_id** `string` *required*

UUID of the invitation to delete.


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