# Ferramentas · Membros

> Ferramentas MCP para membros: listar e buscar membros, convidar uma pessoa ou uma turma inteira, trocar papéis, remover alguém da comunidade, organizar grupos e tags e montar o organograma.

Quem está na comunidade e como ela se organiza: listar e buscar membros, convidar uma pessoa ou uma turma inteira, trocar papéis, remover alguém, criar grupos, marcar tags e dizer quem responde a quem no organograma.

Convidar e trocar um papel acontecem na primeira chamada, como no painel; como o convite manda e-mail de verdade, o assistente mostra antes quem vai receber. Só a remoção de um membro e as exclusões de grupo e de tag **pedem a sua confirmação** em duas etapas. Ver [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao).

Cada ferramenta traz um selo: <span class="tool-kind tool-kind-read">Só consulta</span> não muda nada, <span class="tool-kind tool-kind-write">Altera</span> cria ou muda algo na hora, e <span class="tool-kind tool-kind-confirm">Pede confirmação</span> só age depois do seu sim a um resumo. Ver [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao).

## Em resumo

| Ferramenta | O que faz | Papel mínimo | Tipo |
|---|---|---|---|
| [`list_members`](#list-members) | Membros com papel e data de entrada | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`invite_member`](#invite-member) | Convida uma pessoa, com papel, grupos e tags | Administrador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`invite_members`](#invite-members) | Convida até 100 pessoas de uma vez, com o resultado linha a linha | Administrador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_member_role`](#update-member-role) | Troca o papel de um membro | Administrador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`remove_member`](#remove-member) | Tira uma pessoa da comunidade | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`list_groups`](#list-groups) | Grupos, com cor, líder, grupo pai e quantas pessoas | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`create_group`](#create-group) | Cria um grupo de membros | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_group`](#update-group) | Renomeia ou muda um grupo | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`delete_group`](#delete-group) | Exclui um grupo; as pessoas ficam na comunidade | Moderador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`update_group_members`](#update-group-members) | Põe ou tira pessoas de um grupo | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`list_tags`](#list-tags) | Tags usadas, com cor e quantas pessoas | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`update_member_tags`](#update-member-tags) | Marca ou desmarca tags em uma ou mais pessoas | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_tag`](#update-tag) | Renomeia ou muda a cor de uma tag | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`delete_tag`](#delete-tag) | Tira uma tag de todas as pessoas | Moderador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`get_org_chart`](#get-org-chart) | Quem responde a quem, com os grupos | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`set_manager`](#set-manager) | Diz a quem uma pessoa responde | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`list_activity_logs`](#list-activity-logs) | Quem fez o quê: equipe, assistente e membros | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> |

## `list_members`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Listar membros.** Os membros, com papel e data de entrada. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `search` | texto | Não | Parte do nome ou do e-mail |
| `role` | `owner`, `admin`, `moderator`, `member`, `finance` | Não | Só um papel |
| `sort_by` | `joinedAt`, `lastSeenAt`, `displayName`, `role`, `fullName` | Não | `joinedAt` para "quem entrou", `lastSeenAt` para "quem apareceu" |
| `order` | `asc`, `desc` | Não | Crescente ou decrescente |
| `page`, `limit` | número | Não | Paginação |

**Devolve:** os perfis (nome de exibição, nome, papel, data de entrada, avatar) e a paginação.

**Peça assim:** *"Quem entrou na comunidade nos últimos 7 dias?"* · *"Quem são os moderadores?"*

## `invite_member`

<span class="tool-kind tool-kind-write">Altera</span>

**Convidar uma pessoa.** Convida uma pessoa para a comunidade, com nome, papel, grupos e tags. *Papel mínimo: administrador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `email` | e-mail | Sim | O e-mail da pessoa |
| `name` | texto, de 2 a 100 | Não | O nome completo. Sem ele, o nome sai do e-mail |
| `role` | `member`, `moderator`, `admin`, `finance` | Não | Padrão: `member`. Ninguém entra como proprietário por convite |
| `groups` | lista de nomes ou ids, até 20 | Não | Os grupos em que a pessoa entra (de `list_groups`) |
| `tags` | lista de textos, até 20 | Não | As tags da pessoa |

**Devolve:** o convite feito: quem recebeu, com que papel, grupos e tags.

**Peça assim:** *"Convide a maria@memberfy.net como moderadora, no grupo Turma de março."*

**Notas:** o convite manda um e-mail de verdade na primeira chamada; o assistente mostra antes quem vai receber. Quem não tem conta recebe o link para definir a senha; quem já tem conta recebe o aviso de que foi adicionado. Ver [Convidar membros](/membros/convidar-membros).

## `invite_members`

<span class="tool-kind tool-kind-write">Altera</span>

**Convidar uma turma.** Convida até 100 pessoas de uma vez, cada uma com o próprio nome, papel, grupos e tags, ou com um padrão para todos. *Papel mínimo: administrador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `people` | lista de 1 a 100 | Sim | Cada pessoa com `email` (obrigatório), `name`, `role`, `groups` e `tags` |
| `role` | `member`, `moderator`, `admin`, `finance` | Não | O papel de quem não tiver um próprio. Padrão: `member` |
| `groups` | lista, até 20 | Não | Os grupos de quem não tiver os próprios |
| `tags` | lista, até 20 | Não | As tags de quem não tiver as próprias |

**Devolve:** o resultado **linha a linha**: convidada, já era membro (`already_member`) ou erro, com o motivo.

**Peça assim:** *"Convide estas 30 pessoas como membros, todas no grupo Turma de março: [lista de nomes e e-mails]."*

**Notas:** os e-mails saem na primeira chamada, por isso o assistente mostra a lista antes de convidar. Cada linha dá certo ou falha sozinha: quem já é membro não para o resto. Para mais de 100 pessoas, o assistente divide em partes. Ver a receita [Convidar uma turma](/mcp/receitas#10-convidar-uma-turma).

## `update_member_role`

<span class="tool-kind tool-kind-write">Altera</span>

**Trocar o papel de alguém.** Muda o papel de um membro. *Papel mínimo: administrador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `member` | texto | Sim | O id do perfil (de `list_members`) ou o e-mail da pessoa |
| `role` | `member`, `moderator`, `admin`, `finance` | Sim | O papel novo |

**Devolve:** o perfil com o papel novo.

**Peça assim:** *"Promova a ana@memberfy.net a moderadora."*

**Notas:** muda o que a pessoa pode fazer na hora; para desfazer, peça o papel antigo. O papel do proprietário só outro proprietário muda. Ver [Papéis e permissões](/conceitos/papeis-e-permissoes).

## `remove_member`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Remover membro.** Tira uma pessoa da comunidade. *Papel mínimo: administrador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `member` | texto | Sim | O id do perfil (de `list_members`) ou o e-mail da pessoa |

**Devolve:** na primeira chamada, o nome, o e-mail e o papel da pessoa, e o código de confirmação.

**Peça assim:** *"Tire o bruno\@memberfy.net da comunidade."*

**Notas:** os certificados da pessoa continuam válidos. Só um proprietário remove outro proprietário, e ninguém remove a si mesmo por aqui. Ver [Gerenciar membros](/membros/gerenciar-membros).

## `list_groups`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Listar grupos.** Os grupos de membros (departamentos, turmas, squads), com cor, líder, grupo pai e quantas pessoas cada um tem. *Papel mínimo: moderador.*

Parâmetros: nenhum.

**Devolve:** os grupos, com id, nome, cor, líder, grupo pai e o número de pessoas.

**Peça assim:** *"Quais grupos a comunidade tem, e quantas pessoas em cada um?"*

## `create_group`

<span class="tool-kind tool-kind-write">Altera</span>

**Criar grupo.** Cria um grupo de membros. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `name` | texto | Sim | Único na comunidade |
| `description` | texto simples | Não | Sem formatação: marcas de Markdown são tiradas |
| `color` | cor em hex | Não | Ex.: `#2563EB` |
| `parent_group` | nome ou id | Não | O grupo acima (diretoria → área → squad) |

**Devolve:** o grupo criado, com o id.

**Peça assim:** *"Crie o grupo Turma de março, azul, dentro de Alunos."*

Ver [Grupos e organograma](/membros/grupos-e-organograma).

## `update_group`

<span class="tool-kind tool-kind-write">Altera</span>

**Renomear ou mudar grupo.** Muda o nome, a descrição, a cor ou o grupo pai de um grupo. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `group` | nome ou id | Sim | O grupo |
| `name` | texto | Não | O nome novo |
| `description` | texto simples | Não | Sem formatação: marcas de Markdown são tiradas |
| `color` | cor em hex | Não | |
| `parent_group` | nome ou id | Não | O novo grupo acima |

**Devolve:** o grupo atualizado.

**Peça assim:** *"Renomeie o grupo Turma de março para Turma 2026.1."*

## `delete_group`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Excluir grupo.** Exclui um grupo. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `group` | nome ou id | Sim | O grupo |

**Devolve:** na primeira chamada, o resumo (o grupo e quantas pessoas tem) e o código; na segunda, a exclusão.

**Peça assim:** *"Exclua o grupo Turma de 2024."*

**Notas:** as pessoas saem do grupo, mas continuam na comunidade; os grupos que estavam abaixo dele sobem um nível.

## `update_group_members`

<span class="tool-kind tool-kind-write">Altera</span>

**Pôr ou tirar pessoas de um grupo.** Acrescenta ou tira pessoas de um grupo, sem mexer nos outros grupos delas. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `group` | nome ou id | Sim | O grupo |
| `add` | lista de ids de perfil ou e-mails | Não | Quem entra |
| `remove` | lista de ids de perfil ou e-mails | Não | Quem sai |

**Devolve:** o resultado pessoa por pessoa.

**Peça assim:** *"Ponha no grupo Mentoria todos os que compraram a mentoria este mês."*

## `list_tags`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Listar tags de membros.** As tags usadas na comunidade, com cor e quantas pessoas têm cada uma. *Papel mínimo: moderador.*

Parâmetros: nenhum.

**Devolve:** as tags, com nome, cor e número de pessoas.

**Peça assim:** *"Quais tags existem, e quantas pessoas em cada uma?"*

## `update_member_tags`

<span class="tool-kind tool-kind-write">Altera</span>

**Marcar ou desmarcar tags.** Acrescenta e tira tags de uma ou mais pessoas, mantendo as outras tags delas. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `members` | lista de ids de perfil ou e-mails | Sim | As pessoas |
| `add` | lista de tags | Não | As tags que entram |
| `remove` | lista de tags | Não | As tags que saem |

**Devolve:** o resultado pessoa por pessoa.

**Peça assim:** *"Marque a ana@memberfy.net e o bruno@memberfy.net com a tag Mentor."*

**Notas:** tags de sistema, como **Palestrante**, não se marcam à mão. Ver [Tags](/membros/tags).

## `update_tag`

<span class="tool-kind tool-kind-write">Altera</span>

**Renomear ou colorir tag.** Renomeia uma tag em todas as pessoas que a têm e muda a cor dela. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `tag` | texto | Sim | A tag |
| `new_name` | texto | Não | O nome novo |
| `color` | cor em hex | Não | |

**Devolve:** a tag atualizada.

**Peça assim:** *"Troque a tag Mentor por Mentora e deixe roxa."*

## `delete_tag`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Excluir tag.** Tira uma tag de todas as pessoas que a têm. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `tag` | texto | Sim | A tag |

**Devolve:** na primeira chamada, o resumo e o código; na segunda, a exclusão.

**Peça assim:** *"Exclua a tag Evento 2024."*

**Notas:** as pessoas continuam na comunidade; só a tag sai.

## `get_org_chart`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Ver organograma.** Quem responde a quem, com os grupos de cada pessoa. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `root_member` | id de perfil ou e-mail | Não | Quem fica no topo |
| `group` | nome ou id | Não | Desenha só esse grupo |
| `depth` | número | Não | Quantos níveis descer |

**Devolve:** a árvore, pessoa por pessoa, com o gestor e os grupos.

**Peça assim:** *"Mostre o organograma da área de Produto."*

Ver [Grupos e organograma](/membros/grupos-e-organograma).

## `set_manager`

<span class="tool-kind tool-kind-write">Altera</span>

**Definir a quem a pessoa responde.** Diz quem é o gestor de uma pessoa no organograma, ou tira o gestor. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `member` | id de perfil ou e-mail | Sim | A pessoa |
| `manager` | id de perfil ou e-mail | Não | A quem ela responde |
| `no_manager` | sim ou não | Não | `true` tira o gestor |

**Devolve:** a pessoa com o gestor novo.

**Peça assim:** *"O Bruno passa a responder à Ana."*

**Notas:** um ciclo (A responde a B, que responde a A) é recusado. O organograma não dá nenhuma permissão: quem pode o quê continua sendo o papel.

## `list_activity_logs`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Registros de atividade.** Quem fez o quê na comunidade, dos mais recentes para os mais antigos: a mesma linha do tempo da aba **Membros › Logs**. *Papel mínimo: administrador (proprietário ou administrador).*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `source` | `team`, `assistant`, `members` | Não | **Equipe** (as ações sobre assinaturas: cancelar, reativar, desconto, cortesia, extensão, adicional, link de pagamento), **assistente** (o que um assistente de IA fez pelo MCP, inclusive conexões autorizadas e desconectadas) ou **membros** (as ações que dão pontos no ranking). Sem ele, as três |
| `profile` | id de perfil, e-mail ou link do app | Não | Só o que essa pessoa fez |
| `from`, `to` | data ISO 8601 | Não | O período. Uma data sem hora em `to` vale o dia inteiro |
| `page`, `limit` | números | Não | Até 100 por página |

**Devolve:** cada registro com quando, quem, a ação (no seu idioma), sobre o quê e os detalhes: o antes e depois de uma ação da equipe, o resultado de uma chamada do assistente (concluída, erro, recusada ou aguardando confirmação) ou os pontos de uma ação de membro. Os argumentos das chamadas do assistente vêm resumidos, sem códigos de confirmação nem imagens.

**Peça assim:** *"Quem cancelou a assinatura da Ana?"* · *"O que o assistente fez ontem?"* · *"O que a ana@memberfy.net fez esta semana?"*

**Notas:** se uma chamada do assistente falhou, a resposta sugere [`get_connection_diagnostics`](/mcp/ferramentas-comunidade#get-connection-diagnostics); com uma pessoa no filtro, sugere [`member_activity`](/mcp/relatorios-e-graficos#member-activity). Um perfil ou link de outra comunidade é recusado.

## Relacionados

- [Ferramentas](/mcp/ferramentas)
- [Receitas](/mcp/receitas)
- [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao)