Skip to main content
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

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

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

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

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

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

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

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

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

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 to get available team IDs.
​
seat_type
string
required
Seat type: listener (view-only) or recording (can record calls).

​
update_invitation

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

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.