Herramientas · Contenido e interacción
Herramientas MCP para lo que pasa en el feed: buscar, leer, publicar, editar, mover y eliminar publicaciones, publicaciones cortas, comentar y responder, editar y eliminar comentarios, reaccionar, fijar, la galería (añadir, listar, editar, reaccionar y eliminar), el ranking y tus puntos, y la moderación.
El día a día de la comunidad: el ranking y la cola de moderación, encontrar una publicación por el título, publicar un aviso con imagen, responder a las preguntas de un directo, reaccionar a las presentaciones, fijar lo importante, mover una publicación al espacio adecuado y cuidar las fotos de la galería. Las publicaciones y los comentarios salen con el nombre de quien conectó el asistente.
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_posts | El feed, con comentarios y reacciones | Cualquiera | Solo consulta |
search_content | Busca publicaciones, eventos, cursos, secciones, espacios y convocatorias por el título | Cualquiera | Solo consulta |
list_comments | Comentarios de una publicación | Cualquiera | Solo consulta |
create_post | Publica una entrada | Cualquiera | Modifica |
update_post | Edita el título, el texto y la portada; fija | Autor o moderador | Modifica |
delete_post | Elimina una publicación, con confirmación | Autor o moderador | Pide confirmación |
move_post | Mueve una publicación a otro espacio de Contenido o de Feed | Moderador | Modifica |
create_short_post | Publica una publicación corta, sin título, en un Feed | Miembro (no Finanzas) | Modifica |
create_comment | Comenta o responde | Cualquiera | Modifica |
update_comment | Edita un comentario | Autor o moderador | Modifica |
delete_comment | Elimina un comentario, con confirmación | Autor o moderador | Pide confirmación |
add_reaction | Reacciona con un emoji | Cualquiera | Modifica |
pin_post | Fija o desfija en el feed | Moderador | Modifica |
add_gallery_image | Pone una imagen, por enlace, en una galería | Cualquiera | Modifica |
list_gallery_images | Las imágenes de una galería, con autor y reacciones | Cualquiera | Solo consulta |
update_gallery_image | Cambia el título o la descripción de una imagen | Autor o moderador | Modifica |
react_to_gallery_image | Reacciona a una imagen de la galería | Cualquiera | Modifica |
delete_gallery_image | Elimina una imagen de la galería | Autor o moderador | Pide confirmación |
get_leaderboard | Lo más alto del ranking | Cualquiera | Solo consulta |
get_my_points | Tus puntos y tu posición en el ranking | Cualquiera | Solo consulta |
get_ranking_rules | Si el ranking está activado y los puntos por acción | Administrador | Solo consulta |
update_ranking_rules | Activa, desactiva y cambia los puntos | Administrador | Modifica |
list_moderation_queue | Lo que espera aprobación | Moderador | Solo consulta |
moderate_item | Aprueba o rechaza un elemento de la cola | Moderador | Modifica |
list_posts
Solo consulta
Listar publicaciones del feed. El feed (publicaciones, estados, eventos y cursos), del más nuevo al más antiguo, con el número de comentarios y reacciones. Rol mínimo: cualquiera.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space_id | id | No | Un solo espacio (de list_spaces) |
type | all, status, content, events, courses | No | Un solo tipo de elemento |
page, limit | número | No | Paginación |
Devuelve: los elementos, cada uno con el id y el tipo que piden create_comment, add_reaction y pin_post, el autor, el título o texto, los recuentos y si está fijado.
Pídelo así: "¿Cuáles han sido las publicaciones más comentadas esta semana?" · "¿Qué se ha publicado en el espacio Avisos?"
search_content
Solo consulta
Buscar por título. Busca por título en publicaciones, eventos, cursos, secciones, espacios y convocatorias de ponencias, sin distinguir mayúsculas ni acentos, en una sola búsqueda en toda la comunidad. Rol mínimo: cualquiera; cada uno encuentra lo que puede ver.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query | texto, de 2 a 200 | Sí | Parte del título. En las publicaciones cortas, busca en el texto |
types | lista: posts, events, courses, spaces, calls | No | Por defecto: todos. spaces incluye las secciones |
limit | número, hasta 50 | No | Por defecto, 20 |
Devuelve: los resultados, cada uno con tipo, id, título y, cuando lo hay, el espacio, la sección, el módulo, la fecha y el estado.
Notas: quien no es del equipo solo encuentra lo que está publicado y aprobado; los espacios y las secciones cerrados para esa persona quedan fuera. La búsqueda es la misma de GET /api/search.
Pídelo así: "Busca la publicación Cómo funciona la comunidad."
list_comments
Solo consulta
Listar comentarios de una publicación. Los comentarios de una publicación de contenido o de un estado. Rol mínimo: cualquiera.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | content, status | Sí | El tipo del elemento, de list_posts |
post_id | id | Sí | El id del elemento, de list_posts |
Devuelve: los comentarios, con el id (que create_comment usa en reply_to), el autor, el texto y la fecha.
Pídelo así: "¿Qué comentarios de la publicación de bienvenida siguen sin respuesta?"
create_post
Modifica
Publicar entrada. Publica una entrada de texto en un espacio de Feed o de Contenido. Rol mínimo: cualquier rol que pueda publicar en ese espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space_id | id | Sí | De list_spaces |
title | texto | Sí | |
text | Markdown | Sí | El cuerpo de la publicación, en Markdown: negrita, cursiva, listas, enlaces, subtítulos, cita y código |
image_url | enlace | No | La portada de la publicación: un enlace público (http/https) de una imagen JPEG, PNG, WebP o GIF de hasta 10 MB. Consulta Imágenes |
Devuelve: la publicación creada, con el id (para pin_post) y la portada. El texto vuelve en Markdown, con text_format: "markdown".
Pídelo así: "Publica en el Feed una bienvenida para quienes han entrado esta semana, mencionando a cada uno por su nombre."
Notas: la publicación sale con el nombre y la foto de quien conectó. Se aplica la regla Quién puede publicar del espacio: en un espacio solo del equipo, un miembro recibe un rechazo. La publicación sale al momento; todavía no se puede programar. Si la imagen no se puede usar, no se publica nada y el asistente recibe el motivo.
update_post
Modifica
Editar entrada. Cambia el título, el texto o la portada de una publicación, y la fija o la desfija. Solo cambia lo que se envía. Rol mínimo: el autor, o moderador en adelante.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
post | id o enlace | Sí | |
type | content, status | No | Por defecto: content. En los estados (publicaciones cortas), solo cambia el texto |
title | texto simple | No | |
text | Markdown | No | En una publicación corta (status), solo negrita, cursiva, enlaces y saltos de línea |
image_url o image_base64 | enlace o archivo | No | La portada nueva. Consulta Imágenes |
remove_image | sí o no | No | Quita la portada |
pinned | sí o no | No | Fija o desfija (moderador en adelante) |
Pídelo así: "En la publicación Cómo funciona la comunidad, cambia la portada por esta imagen y fíjala arriba."
Notas: la publicación no cambia de espacio.
delete_post
Pide confirmación
Eliminar entrada. Pide confirmación: la primera llamada muestra la publicación, y solo la segunda la elimina. Rol mínimo: el autor, o moderador en adelante.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
post | id o enlace | Sí | |
type | content, status | No | Por defecto: content |
move_post
Modifica
Mover post a otro espacio. Lleva una publicación a otro espacio de Contenido o de Feed de la comunidad; su lugar en el feed va con ella. Rol mínimo: moderador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
post | id o enlace | Sí | |
to_space | id, enlace, dirección o nombre | Sí | Un espacio de Contenido o de Feed |
Pídelo así: "Esta oferta de empleo ha caído en Avisos; muévela al espacio Empleo."
Notas: un espacio de otro módulo (Cursos, Eventos…) se rechaza.
create_short_post
Modifica
Publicar post corto. Una publicación corta, de hasta 500 caracteres y sin título, en un espacio de Feed, como el campo rápido de la app. Para una publicación con título y portada, el asistente usa create_post. Rol: propietario, administrador, moderador o miembro que puede publicar en el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id, enlace, dirección o nombre | Sí | Un espacio de Feed |
text | texto, hasta 500 | Sí | Solo acepta negrita, cursiva, enlaces y saltos de línea, en Markdown |
visibility | public, members, private | No |
Pídelo así: "Escribe en el Feed: '¡Directo hoy a las 20:00, el enlace está en el evento!'"
create_comment
Modifica
Comentar o responder. Comenta en un elemento del feed, o responde a un comentario. Rol mínimo: cualquiera.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | content, status, event, course | Sí | El tipo del elemento, de list_posts |
item_id | id | Sí | El id del elemento |
text | texto simple, hasta 2.000 | Sí | Sin formato: las marcas de Markdown se eliminan |
reply_to | id | No | El id del comentario al que respondes (de list_comments). Solo en elementos de tipo content |
Devuelve: el comentario creado.
Pídelo así: "Responde a cada pregunta sin respuesta de la publicación del directo de ayer, dando las gracias y diciendo que lo trataremos en el próximo."
update_comment
Modifica
Editar comentario. Cambia el texto de un comentario. Rol mínimo: el autor, o moderador en adelante.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | content, status | Sí | |
post | id o enlace | Sí | La publicación del comentario |
comment_id | id | Sí | De list_comments |
text | texto, hasta 2.000 | Sí |
delete_comment
Pide confirmación
Eliminar comentario. Con confirmación. Rol mínimo: el autor, o moderador en adelante. Los mismos parámetros, sin text.
add_reaction
Modifica
Reaccionar. Reacciona a un elemento del feed. Rol mínimo: cualquiera.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | content, status, event, course | Sí | |
item_id | id | Sí | |
reaction | 👍 ❤️ 🔥 🙌 😊 👏 🎉 | Sí | Una de las siete reacciones |
Devuelve: la reacción registrada.
Pídelo así: "Reacciona con 🎉 a las presentaciones de quienes han entrado hoy."
pin_post
Modifica
Fijar en el feed. Fija un elemento en la parte superior del feed, o lo desfija. Rol mínimo: moderador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | content, status, event, course | Sí | |
item_id | id | Sí | |
pinned | sí o no | No | Por defecto: fijar. Con false, desfija |
Devuelve: el elemento con el nuevo estado.
Pídelo así: "Fija la publicación de las normas de la comunidad."
add_gallery_image
Modifica
Añadir imagen a una galería. Descarga una imagen de un enlace y la pone en un espacio de Galería. Rol mínimo: cualquier rol que pueda publicar en ese espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space_id | id | Sí | Un espacio de Galería (list_spaces con module: gallery) |
image_url | enlace | Sí | un enlace público (http/https) de una imagen JPEG, PNG, WebP o GIF de hasta 10 MB. Consulta Imágenes |
title | texto, hasta 255 | No | El título de la imagen en la galería |
Devuelve: la imagen en la galería, con la dirección y la miniatura.
Pídelo así: "Pon esta foto del encuentro en la galería Encuentros: https://…/foto.jpg"
list_gallery_images
Solo consulta
Listar imágenes de la galería. Las imágenes de un espacio de Galería, de la más reciente a la más antigua, con título, autor y reacciones. Rol mínimo: cualquier rol que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id, enlace, dirección o nombre | Sí | El espacio de Galería |
page, limit | número | No | limit hasta 50 |
Devuelve: las imágenes, con el id que piden las demás herramientas de la galería.
update_gallery_image
Modifica
Editar imagen de la galería. Cambia el título o la descripción de una imagen. Rol: quien subió la imagen, o de moderador para arriba.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
image_id | id | Sí | De list_gallery_images |
title | texto, hasta 255 | No | |
description | texto | No |
react_to_gallery_image
Modifica
Reaccionar a imagen de la galería. Con 👍 ❤️ 🔥 👏 😊 o 🙌. La misma reacción otra vez quita la reacción. Rol mínimo: cualquiera.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
image_id | id | Sí | De list_gallery_images |
reaction | uno de los seis emojis | Sí |
delete_gallery_image
Pide confirmación
Eliminar imagen de la galería. Rol: quien subió la imagen, o de moderador para arriba.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
image_id | id | Sí | De list_gallery_images |
Devuelve: en la primera llamada, el título y el autor de la imagen, y el código de confirmación.
get_leaderboard
Solo consulta
Ver ranking. Lo más alto del ranking de puntos de la comunidad. Rol mínimo: cualquiera.
Parámetros: ninguno.
Pídelo así: "¿Quiénes son los 10 primeros del ranking?"
get_my_points
Solo consulta
Mis puntos en el ranking. Tus puntos y tu posición en el ranking de la comunidad. Rol mínimo: cualquiera.
Parámetros: ninguno.
Pídelo así: "¿Cuántos puntos tengo y en qué posición estoy?"
get_ranking_rules
Solo consulta
Ver reglas del ranking. Si el ranking está activado y cuántos puntos vale cada acción. Rol mínimo: administrador.
Parámetros: ninguno.
Pídelo así: "¿Cuántos puntos vale un comentario?"
update_ranking_rules
Modifica
Cambiar reglas del ranking. Activa o desactiva el ranking y cambia los puntos por acción. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
enabled | sí o no | No | |
points | acción → puntos | No | Las acciones vienen de get_ranking_rules, p. ej. {"comment": 10} |
Pídelo así: "Comentar pasa a valer 10 puntos."
Consulta Ranking.
list_moderation_queue
Solo consulta
Cola de moderación. Lo que espera aprobación, o las cifras de la moderación. Rol mínimo: moderador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | summary, posts, courses, events, gallery, status | No | Por defecto: posts. summary devuelve las cifras |
Pídelo así: "¿Hay algo esperando aprobación?"
moderate_item
Modifica
Aprobar o rechazar. Aprueba o rechaza un elemento de la cola de moderación. Rol mínimo: moderador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | posts, courses, events, gallery, status | Sí | |
item_id | id | Sí | De list_moderation_queue |
decision | approve, reject | Sí | Aprobar o rechazar |
reason | texto | No | Obligatorio para rechazar |
Pídelo así: "Aprueba las publicaciones de la cola que no tienen enlace externo."
Consulta Moderación.