Tools · Members
MCP tools for members: listing and searching members, inviting one person or a whole class, changing roles, removing someone from the community, organizing groups and tags, and building the org chart.
Who is in the community and how it is organized: listing and searching members, inviting one person or a whole class, changing roles, removing someone, creating groups, tagging people and saying who reports to whom in the org chart.
Inviting and changing a role happen on the first call, as in the dashboard; since the invite sends a real e-mail, the assistant shows beforehand who will receive it. Only removing a member and deleting a group or a tag ask for your confirmation in two steps. See Money and confirmation.
Each tool carries a badge: Read-only changes nothing, Changes creates or changes something right away, and Asks to confirm only acts after your yes to a summary. See Money and confirmation.
In short
| Tool | What it does | Minimum role | Type |
|---|---|---|---|
list_members | Members with role and join date | Moderator | Read-only |
invite_member | Invites one person, with role, groups and tags | Admin | Changes |
invite_members | Invites up to 100 people at once, with the result line by line | Admin | Changes |
update_member_role | Changes a member's role | Admin | Changes |
remove_member | Removes a person from the community | Admin | Asks to confirm |
list_groups | Groups, with color, leader, parent group and how many people | Moderator | Read-only |
create_group | Creates a member group | Moderator | Changes |
update_group | Renames or changes a group | Moderator | Changes |
delete_group | Deletes a group; the people stay in the community | Moderator | Asks to confirm |
update_group_members | Adds or removes people from a group | Moderator | Changes |
list_tags | Tags in use, with color and how many people | Moderator | Read-only |
update_member_tags | Tags or untags one or more people | Moderator | Changes |
update_tag | Renames a tag or changes its color | Moderator | Changes |
delete_tag | Removes a tag from everyone | Moderator | Asks to confirm |
get_org_chart | Who reports to whom, with the groups | Moderator | Read-only |
set_manager | Sets who a person reports to | Moderator | Changes |
list_activity_logs | Who did what: team, assistant and members | Admin | Read-only |
list_members
Read-only
List members. The members, with role and join date. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
search | text | No | Part of the name or email |
role | owner, admin, moderator, member, finance | No | Only one role |
sort_by | joinedAt, lastSeenAt, displayName, role, fullName | No | joinedAt for "who joined", lastSeenAt for "who showed up" |
order | asc, desc | No | Ascending or descending |
page, limit | number | No | Pagination |
Returns: the profiles (display name, name, role, join date, avatar) and the pagination.
Ask like this: "Who joined the community in the last 7 days?" · "Who are the moderators?"
invite_member
Changes
Invite one person. Invites a person to the community, with a name, role, groups and tags. Minimum role: admin.
| Parameter | Type | Required | Description |
|---|---|---|---|
email | Yes | The person's e-mail | |
name | text, 2 to 100 | No | Full name. Without it, the name comes from the e-mail |
role | member, moderator, admin, finance | No | Default: member. Nobody joins as owner through an invite |
groups | list of names or ids, up to 20 | No | The groups the person joins (from list_groups) |
tags | list of texts, up to 20 | No | The person's tags |
Returns: the invite sent: who received it, with what role, groups and tags.
Ask like this: "Invite [email protected] as a moderator, in the March class group."
Notes: the invite sends a real e-mail on the first call; the assistant shows beforehand who will receive it. Someone without an account gets the link to set a password; someone who already has an account gets a notice that they were added. See Invite members.
invite_members
Changes
Invite a class. Invites up to 100 people at once, each with their own name, role, groups and tags, or with a default for everyone. Minimum role: admin.
| Parameter | Type | Required | Description |
|---|---|---|---|
people | list of 1 to 100 | Yes | Each person with email (required), name, role, groups and tags |
role | member, moderator, admin, finance | No | The role for anyone without their own. Default: member |
groups | list, up to 20 | No | The groups for anyone without their own |
tags | list, up to 20 | No | The tags for anyone without their own |
Returns: the result line by line: invited, already a member (already_member) or error, with the reason.
Ask like this: "Invite these 30 people as members, all in the March class group: [list of names and e-mails]."
Notes: the e-mails go out on the first call, which is why the assistant shows the list before inviting. Each line succeeds or fails on its own: someone who is already a member doesn't stop the rest. For more than 100 people, the assistant splits the list. See the recipe Invite a class.
update_member_role
Changes
Change someone's role. Changes a member's role. Minimum role: admin.
| Parameter | Type | Required | Description |
|---|---|---|---|
member | text | Yes | The profile id (from list_members) or the person's e-mail |
role | member, moderator, admin, finance | Yes | The new role |
Returns: the profile with the new role.
Ask like this: "Promote [email protected] to moderator."
Notes: it changes what the person can do right away; to undo it, ask for the old role. Only another owner can change the owner's role. See Roles and permissions.
remove_member
Asks to confirm
Remove member. Removes a person from the community. Minimum role: admin.
| Parameter | Type | Required | Description |
|---|---|---|---|
member | text | Yes | The profile id (from list_members) or the person's e-mail |
Returns: on the first call, the person's name, e-mail and role, and the confirmation code.
Ask like this: "Remove [email protected] from the community."
Notes: the person's certificates remain valid. Only an owner can remove another owner, and nobody can remove themselves this way. See Manage members.
list_groups
Read-only
List groups. The member groups (departments, classes, squads), with color, leader, parent group and how many people each has. Minimum role: moderator.
Parameters: none.
Returns: the groups, with id, name, color, leader, parent group and number of people.
Ask like this: "Which groups does the community have, and how many people are in each?"
create_group
Changes
Create group. Creates a member group. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | text | Yes | Unique in the community |
description | plain text | No | No formatting: Markdown marks are stripped |
color | hex color | No | E.g. #2563EB |
parent_group | name or id | No | The group above it (board → area → squad) |
Returns: the group created, with its id.
Ask like this: "Create the March class group, in blue, inside Students."
See Groups and org chart.
update_group
Changes
Rename or change group. Changes a group's name, description, color or parent group. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
group | name or id | Yes | The group |
name | text | No | The new name |
description | plain text | No | No formatting: Markdown marks are stripped |
color | hex color | No | |
parent_group | name or id | No | The new group above it |
Returns: the updated group.
Ask like this: "Rename the March class group to Class 2026.1."
delete_group
Asks to confirm
Delete group. Deletes a group. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
group | name or id | Yes | The group |
Returns: on the first call, the summary (the group and how many people it has) and the code; on the second, the deletion.
Ask like this: "Delete the Class of 2024 group."
Notes: the people leave the group but stay in the community; the groups below it move up one level.
update_group_members
Changes
Add or remove people from a group. Adds people to a group or removes them, without touching their other groups. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
group | name or id | Yes | The group |
add | list of profile ids or e-mails | No | Who joins |
remove | list of profile ids or e-mails | No | Who leaves |
Returns: the result person by person.
Ask like this: "Put everyone who bought the mentoring this month in the Mentoring group."
list_tags
Read-only
List member tags. The tags used in the community, with their color and how many people have each one. Minimum role: moderator.
Parameters: none.
Returns: the tags, with name, color and number of people.
Ask like this: "Which tags exist, and how many people have each one?"
update_member_tags
Changes
Tag or untag. Adds and removes tags on one or more people, keeping their other tags. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
members | list of profile ids or e-mails | Yes | The people |
add | list of tags | No | The tags to add |
remove | list of tags | No | The tags to remove |
Returns: the result person by person.
Ask like this: "Tag [email protected] and [email protected] with Mentor."
Notes: system tags, such as Speaker, can't be set by hand. See Tags.
update_tag
Changes
Rename or recolor tag. Renames a tag on everyone who has it and changes its color. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
tag | text | Yes | The tag |
new_name | text | No | The new name |
color | hex color | No |
Returns: the updated tag.
Ask like this: "Rename the Mentor tag to Coach and make it purple."
delete_tag
Asks to confirm
Delete tag. Removes a tag from everyone who has it. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
tag | text | Yes | The tag |
Returns: on the first call, the summary and the code; on the second, the deletion.
Ask like this: "Delete the Event 2024 tag."
Notes: the people stay in the community; only the tag goes.
get_org_chart
Read-only
View org chart. Who reports to whom, with each person's groups. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
root_member | profile id or e-mail | No | Who sits at the top |
group | name or id | No | Draws only that group |
depth | number | No | How many levels to go down |
Returns: the tree, person by person, with their manager and groups.
Ask like this: "Show the org chart of the Product area."
See Groups and org chart.
set_manager
Changes
Set who someone reports to. Sets a person's manager in the org chart, or removes it. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
member | profile id or e-mail | Yes | The person |
manager | profile id or e-mail | No | Who they report to |
no_manager | yes or no | No | true removes the manager |
Returns: the person with the new manager.
Ask like this: "Bruno now reports to Ana."
Notes: a cycle (A reports to B, who reports to A) is refused. The org chart grants no permission: what someone can do is still their role.
list_activity_logs
Read-only
Activity logs. Who did what in the community, newest first: the same timeline as the Members › Logs tab. Minimum role: admin (owner or admin).
| Parameter | Type | Required | Description |
|---|---|---|---|
source | team, assistant, members | No | Team (actions on subscriptions: cancel, reactivate, discount, complimentary, extension, add-on, payment link), assistant (what an AI assistant did through MCP, including connections authorized and disconnected) or members (the actions that earn ranking points). Without it, all three |
profile | profile id, e-mail or app link | No | Only what this person did |
from, to | ISO 8601 date | No | The period. A date without a time in to covers the whole day |
page, limit | numbers | No | Up to 100 per page |
Returns: each entry with when, who, the action (in your language), on what, and the details: the before and after of a team action, the result of an assistant call (completed, error, refused or awaiting confirmation) or the points of a member action. The arguments of assistant calls come summarized, with no confirmation codes or images.
Ask like this: "Who canceled Ana's subscription?" · "What did the assistant do yesterday?" · "What did [email protected] do this week?"
Notes: if an assistant call failed, the response suggests get_connection_diagnostics; with a person in the filter, it suggests member_activity. A profile or link from another community is refused.