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.
Cada herramienta lleva un sello: Solo consulta no cambia nada, Modifica crea o cambia algo al momento, y Pide confirmación solo actúa después de tu sí a un resumen. Consulta Dinero y confirmación.
En resumen
| Herramienta | Qué hace | Rol mínimo | Tipo |
|---|---|---|---|
list_members | Miembros con rol y fecha de entrada | Moderador | Solo consulta |
invite_member | Invita a una persona, con rol, grupos y etiquetas | Administrador | Modifica |
invite_members | Invita hasta 100 personas a la vez, con el resultado línea a línea | Administrador | Modifica |
update_member_role | Cambia el rol de un miembro | Administrador | Modifica |
remove_member | Saca a una persona de la comunidad | Administrador | Pide confirmación |
list_groups | Grupos, con color, líder, grupo padre y cuántas personas | Moderador | Solo consulta |
create_group | Crea un grupo de miembros | Moderador | Modifica |
update_group | Renombra o cambia un grupo | Moderador | Modifica |
delete_group | Elimina un grupo; las personas siguen en la comunidad | Moderador | Pide confirmación |
update_group_members | Pone o quita personas de un grupo | Moderador | Modifica |
list_tags | Etiquetas en uso, con color y cuántas personas | Moderador | Solo consulta |
update_member_tags | Pone o quita etiquetas a una o más personas | Moderador | Modifica |
update_tag | Renombra una etiqueta o cambia su color | Moderador | Modifica |
delete_tag | Quita una etiqueta de todas las personas | Moderador | Pide confirmación |
get_org_chart | Quién depende de quién, con los grupos | Moderador | Solo consulta |
set_manager | Indica de quién depende una persona | Moderador | Modifica |
list_activity_logs | Quién hizo qué: equipo, asistente y miembros | Administrador | Solo consulta |
list_members
Solo consulta
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
Modifica
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.
invite_members
Modifica
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.
update_member_role
Modifica
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.
remove_member
Pide confirmación
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.
list_groups
Solo consulta
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
Modifica
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.
update_group
Modifica
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
Pide confirmación
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
Modifica
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
Solo consulta
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
Modifica
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.
update_tag
Modifica
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
Pide confirmación
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
Solo consulta
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.
set_manager
Modifica
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
Solo consulta
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; con una persona en el filtro, sugiere member_activity. Un perfil o enlace de otra comunidad se rechaza.