# Herramientas · Miembros

> Herramientas MCP para miembros: listar y buscar miembros, invitar a una persona o a una clase entera, cambiar roles, quitar a alguien de la comunidad, organizar grupos y etiquetas y montar el organigrama.

Quién está en la comunidad y cómo se organiza: listar y buscar miembros, invitar a una persona o a una clase entera, cambiar roles, quitar a alguien, crear grupos, poner etiquetas e indicar quién depende de quién en el organigrama.

Invitar y cambiar un rol ocurren en la primera llamada, como en el panel; como la invitación envía un correo de verdad, el asistente muestra antes quién lo va a recibir. Solo quitar a un miembro y eliminar un grupo o una etiqueta **piden tu confirmación** en dos pasos. Consulta [Dinero y confirmación](/mcp/dinheiro-e-confirmacao).

Cada herramienta lleva un sello: <span class="tool-kind tool-kind-read">Solo consulta</span> no cambia nada, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia algo al momento, y <span class="tool-kind tool-kind-confirm">Pide confirmación</span> solo actúa después de tu sí a un resumen. Consulta [Dinero y confirmación](/mcp/dinheiro-e-confirmacao).

## En resumen

| Herramienta | Qué hace | Rol mínimo | Tipo |
|---|---|---|---|
| [`list_members`](#list-members) | Miembros con rol y fecha de entrada | Moderador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`invite_member`](#invite-member) | Invita a una persona, con rol, grupos y etiquetas | Administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`invite_members`](#invite-members) | Invita hasta 100 personas a la vez, con el resultado línea a línea | Administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_member_role`](#update-member-role) | Cambia el rol de un miembro | Administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_member`](#remove-member) | Saca a una persona de la comunidad | Administrador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`list_groups`](#list-groups) | Grupos, con color, líder, grupo padre y cuántas personas | Moderador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`create_group`](#create-group) | Crea un grupo de miembros | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_group`](#update-group) | Renombra o cambia un grupo | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_group`](#delete-group) | Elimina un grupo; las personas siguen en la comunidad | Moderador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`update_group_members`](#update-group-members) | Pone o quita personas de un grupo | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_tags`](#list-tags) | Etiquetas en uso, con color y cuántas personas | Moderador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`update_member_tags`](#update-member-tags) | Pone o quita etiquetas a una o más personas | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_tag`](#update-tag) | Renombra una etiqueta o cambia su color | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_tag`](#delete-tag) | Quita una etiqueta de todas las personas | Moderador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`get_org_chart`](#get-org-chart) | Quién depende de quién, con los grupos | Moderador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`set_manager`](#set-manager) | Indica de quién depende una persona | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_activity_logs`](#list-activity-logs) | Quién hizo qué: equipo, asistente y miembros | Administrador | <span class="tool-kind tool-kind-read">Solo consulta</span> |

## `list_members`

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

**Listar miembros.** Los miembros, con rol y fecha de entrada. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `search` | texto | No | Parte del nombre o del correo |
| `role` | `owner`, `admin`, `moderator`, `member`, `finance` | No | Un solo rol |
| `sort_by` | `joinedAt`, `lastSeenAt`, `displayName`, `role`, `fullName` | No | `joinedAt` para "quién ha entrado", `lastSeenAt` para "quién ha aparecido" |
| `order` | `asc`, `desc` | No | Ascendente o descendente |
| `page`, `limit` | número | No | Paginación |

**Devuelve:** los perfiles (nombre visible, nombre, rol, fecha de entrada, avatar) y la paginación.

**Pídelo así:** *"¿Quién ha entrado en la comunidad en los últimos 7 días?"* · *"¿Quiénes son los moderadores?"*

## `invite_member`

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

**Invitar a una persona.** Invita a una persona a la comunidad, con nombre, rol, grupos y etiquetas. *Rol mínimo: administrador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `email` | correo | Sí | El correo de la persona |
| `name` | texto, de 2 a 100 | No | El nombre completo. Sin él, el nombre sale del correo |
| `role` | `member`, `moderator`, `admin`, `finance` | No | Por defecto: `member`. Nadie entra como propietario por invitación |
| `groups` | lista de nombres o ids, hasta 20 | No | Los grupos en los que entra la persona (de `list_groups`) |
| `tags` | lista de textos, hasta 20 | No | Las etiquetas de la persona |

**Devuelve:** la invitación enviada: quién la recibió, con qué rol, grupos y etiquetas.

**Pídelo así:** *"Invita a maria@memberfy.net como moderadora, en el grupo Clase de marzo."*

**Notas:** la invitación envía un correo de verdad en la primera llamada; el asistente muestra antes quién lo va a recibir. Quien no tiene cuenta recibe el enlace para definir la contraseña; quien ya tiene cuenta recibe el aviso de que ha sido añadido. Consulta [Invitar miembros](/membros/convidar-membros).

## `invite_members`

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

**Invitar a una clase.** Invita hasta 100 personas a la vez, cada una con su propio nombre, rol, grupos y etiquetas, o con un valor por defecto para todas. *Rol mínimo: administrador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `people` | lista de 1 a 100 | Sí | Cada persona con `email` (obligatorio), `name`, `role`, `groups` y `tags` |
| `role` | `member`, `moderator`, `admin`, `finance` | No | El rol de quien no tenga uno propio. Por defecto: `member` |
| `groups` | lista, hasta 20 | No | Los grupos de quien no tenga los suyos |
| `tags` | lista, hasta 20 | No | Las etiquetas de quien no tenga las suyas |

**Devuelve:** el resultado **línea a línea**: invitada, ya era miembro (`already_member`) o error, con el motivo.

**Pídelo así:** *"Invita a estas 30 personas como miembros, todas en el grupo Clase de marzo: [lista de nombres y correos]."*

**Notas:** los correos salen en la primera llamada, por eso el asistente muestra la lista antes de invitar. Cada línea sale bien o falla por sí sola: quien ya es miembro no detiene al resto. Para más de 100 personas, el asistente divide la lista. Consulta la receta [Invitar a una clase](/mcp/receitas#10-invitar-a-una-clase).

## `update_member_role`

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

**Cambiar el rol de alguien.** Cambia el rol de un miembro. *Rol mínimo: administrador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `member` | texto | Sí | El id del perfil (de `list_members`) o el correo de la persona |
| `role` | `member`, `moderator`, `admin`, `finance` | Sí | El rol nuevo |

**Devuelve:** el perfil con el rol nuevo.

**Pídelo así:** *"Asciende a ana@memberfy.net a moderadora."*

**Notas:** cambia lo que la persona puede hacer al momento; para deshacerlo, pide el rol anterior. El rol del propietario solo lo cambia otro propietario. Consulta [Roles y permisos](/conceitos/papeis-e-permissoes).

## `remove_member`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Quitar miembro.** Saca a una persona de la comunidad. *Rol mínimo: administrador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `member` | texto | Sí | El id del perfil (de `list_members`) o el correo de la persona |

**Devuelve:** en la primera llamada, el nombre, el correo y el rol de la persona, y el código de confirmación.

**Pídelo así:** *"Saca a bruno\@memberfy.net de la comunidad."*

**Notas:** los certificados de la persona siguen siendo válidos. Solo un propietario quita a otro propietario, y nadie se quita a sí mismo por aquí. Consulta [Gestionar miembros](/membros/gerenciar-membros).

## `list_groups`

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

**Listar grupos.** Los grupos de miembros (departamentos, clases, equipos), con color, líder, grupo padre y cuántas personas tiene cada uno. *Rol mínimo: moderador.*

Parámetros: ninguno.

**Devuelve:** los grupos, con id, nombre, color, líder, grupo padre y número de personas.

**Pídelo así:** *"¿Qué grupos tiene la comunidad y cuántas personas hay en cada uno?"*

## `create_group`

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

**Crear grupo.** Crea un grupo de miembros. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `name` | texto | Sí | Único en la comunidad |
| `description` | texto simple | No | Sin formato: las marcas de Markdown se eliminan |
| `color` | color en hex | No | Ej.: `#2563EB` |
| `parent_group` | nombre o id | No | El grupo de arriba (dirección → área → equipo) |

**Devuelve:** el grupo creado, con el id.

**Pídelo así:** *"Crea el grupo Clase de marzo, azul, dentro de Alumnos."*

Consulta [Grupos y organigrama](/membros/grupos-e-organograma).

## `update_group`

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

**Renombrar o cambiar grupo.** Cambia el nombre, la descripción, el color o el grupo padre de un grupo. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `group` | nombre o id | Sí | El grupo |
| `name` | texto | No | El nombre nuevo |
| `description` | texto simple | No | Sin formato: las marcas de Markdown se eliminan |
| `color` | color en hex | No | |
| `parent_group` | nombre o id | No | El nuevo grupo de arriba |

**Devuelve:** el grupo actualizado.

**Pídelo así:** *"Renombra el grupo Clase de marzo a Clase 2026.1."*

## `delete_group`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Eliminar grupo.** Elimina un grupo. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `group` | nombre o id | Sí | El grupo |

**Devuelve:** en la primera llamada, el resumen (el grupo y cuántas personas tiene) y el código; en la segunda, la eliminación.

**Pídelo así:** *"Elimina el grupo Clase de 2024."*

**Notas:** las personas salen del grupo, pero siguen en la comunidad; los grupos que estaban debajo suben un nivel.

## `update_group_members`

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

**Poner o quitar personas de un grupo.** Añade o quita personas de un grupo, sin tocar sus otros grupos. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `group` | nombre o id | Sí | El grupo |
| `add` | lista de ids de perfil o correos | No | Quién entra |
| `remove` | lista de ids de perfil o correos | No | Quién sale |

**Devuelve:** el resultado persona a persona.

**Pídelo así:** *"Pon en el grupo Mentoría a todos los que han comprado la mentoría este mes."*

## `list_tags`

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

**Listar etiquetas de miembros.** Las etiquetas usadas en la comunidad, con color y cuántas personas tiene cada una. *Rol mínimo: moderador.*

Parámetros: ninguno.

**Devuelve:** las etiquetas, con nombre, color y número de personas.

**Pídelo así:** *"¿Qué etiquetas existen y cuántas personas tiene cada una?"*

## `update_member_tags`

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

**Poner o quitar etiquetas.** Añade y quita etiquetas a una o más personas, manteniendo sus otras etiquetas. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `members` | lista de ids de perfil o correos | Sí | Las personas |
| `add` | lista de etiquetas | No | Las etiquetas que entran |
| `remove` | lista de etiquetas | No | Las etiquetas que salen |

**Devuelve:** el resultado persona a persona.

**Pídelo así:** *"Pon la etiqueta Mentor a ana@memberfy.net y a bruno@memberfy.net."*

**Notas:** las etiquetas de sistema, como **Ponente**, no se ponen a mano. Consulta [Etiquetas](/membros/tags).

## `update_tag`

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

**Renombrar o cambiar el color de una etiqueta.** Renombra una etiqueta en todas las personas que la tienen y cambia su color. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `tag` | texto | Sí | La etiqueta |
| `new_name` | texto | No | El nombre nuevo |
| `color` | color en hex | No | |

**Devuelve:** la etiqueta actualizada.

**Pídelo así:** *"Cambia la etiqueta Mentor por Mentora y ponla morada."*

## `delete_tag`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Eliminar etiqueta.** Quita una etiqueta de todas las personas que la tienen. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `tag` | texto | Sí | La etiqueta |

**Devuelve:** en la primera llamada, el resumen y el código; en la segunda, la eliminación.

**Pídelo así:** *"Elimina la etiqueta Evento 2024."*

**Notas:** las personas siguen en la comunidad; solo sale la etiqueta.

## `get_org_chart`

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

**Ver organigrama.** Quién depende de quién, con los grupos de cada persona. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `root_member` | id de perfil o correo | No | Quién queda arriba |
| `group` | nombre o id | No | Dibuja solo ese grupo |
| `depth` | número | No | Cuántos niveles bajar |

**Devuelve:** el árbol, persona a persona, con su responsable y sus grupos.

**Pídelo así:** *"Muéstrame el organigrama del área de Producto."*

Consulta [Grupos y organigrama](/membros/grupos-e-organograma).

## `set_manager`

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

**Definir de quién depende una persona.** Indica el responsable de una persona en el organigrama, o lo quita. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `member` | id de perfil o correo | Sí | La persona |
| `manager` | id de perfil o correo | No | De quién depende |
| `no_manager` | sí o no | No | `true` quita el responsable |

**Devuelve:** la persona con el nuevo responsable.

**Pídelo así:** *"Bruno pasa a depender de Ana."*

**Notas:** un ciclo (A depende de B, que depende de A) se rechaza. El organigrama no da ningún permiso: lo que cada uno puede hacer sigue siendo su rol.

## `list_activity_logs`

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

**Registros de actividad.** Quién hizo qué en la comunidad, de lo más reciente a lo más antiguo: la misma línea de tiempo de la pestaña **Miembros › Registros**. *Rol mínimo: administrador (propietario o administrador).*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `source` | `team`, `assistant`, `members` | No | **Equipo** (las acciones sobre suscripciones: cancelar, reactivar, descuento, cortesía, extensión, adicional, enlace de pago), **asistente** (lo que un asistente de IA hizo por el MCP, incluidas las conexiones autorizadas y desconectadas) o **miembros** (las acciones que dan puntos en el ranking). Sin él, las tres |
| `profile` | id de perfil, correo o enlace de la app | No | Solo lo que hizo esa persona |
| `from`, `to` | fecha ISO 8601 | No | El periodo. Una fecha sin hora en `to` vale el día entero |
| `page`, `limit` | números | No | Hasta 100 por página |

**Devuelve:** cada registro con cuándo, quién, la acción (en tu idioma), sobre qué y los detalles: el antes y después de una acción del equipo, el resultado de una llamada del asistente (completada, error, rechazada o esperando confirmación) o los puntos de una acción de un miembro. Los argumentos de las llamadas del asistente vienen resumidos, sin códigos de confirmación ni imágenes.

**Pídelo así:** *"¿Quién canceló la suscripción de Ana?"* · *"¿Qué hizo el asistente ayer?"* · *"¿Qué hizo ana@memberfy.net esta semana?"*

**Notas:** si una llamada del asistente falló, la respuesta sugiere [`get_connection_diagnostics`](/mcp/ferramentas-comunidade#get-connection-diagnostics); con una persona en el filtro, sugiere [`member_activity`](/mcp/relatorios-e-graficos#member-activity). Un perfil o enlace de otra comunidad se rechaza.

## Relacionados

- [Herramientas](/mcp/ferramentas)
- [Recetas](/mcp/receitas)
- [Dinero y confirmación](/mcp/dinheiro-e-confirmacao)