Herramientas · Pódcast y Vídeos
Herramientas MCP para los módulos Pódcast y Vídeos: programas y presentadores, episodios con audio, vídeo, portada y capítulos, publicar y programar con el alcance del correo, transcripción, números y, para quien escucha, el punto donde lo dejó, reacciones, comentarios y la cola.
Los módulos Pódcast y Vídeos con el asistente: crear programas y elegir presentadores, crear episodios subiendo el audio o el vídeo por enlace o archivo, publicar o programar sabiendo antes cuántas personas reciben el correo, transcribir, ver los números y, para quien escucha, guardar el punto, reaccionar, comentar y organizar la cola.
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_shows | Los programas de un espacio | Cualquiera que vea el espacio | Solo consulta |
get_show | Un programa, con los presentadores | Cualquiera que vea el espacio | Solo consulta |
create_show | Crea un programa, con portada y presentadores | Administrador | Modifica |
update_show | Edita el programa | Administrador | Modifica |
delete_show | Elimina el programa y los episodios | Administrador | Pide confirmación |
add_show_presenter | Hace a alguien presentador del programa | Administrador | Modifica |
remove_show_presenter | Quita a alguien de los presentadores | Administrador | Pide confirmación |
get_show_stats | Los números del programa, por episodio | Presentador o equipo | Solo consulta |
list_episodes | Los episodios de un programa | Cualquiera que vea el espacio | Solo consulta |
get_episode | Un episodio, por el id o por el enlace | Quien puede escucharlo | Solo consulta |
create_episode | Crea un episodio (borrador) con audio o vídeo | Presentador o administrador | Modifica |
update_episode | Edita el episodio, cambia el archivo y los capítulos | Presentador o administrador | Modifica |
delete_episode | Elimina el episodio | Presentador o administrador | Pide confirmación |
publish_episode | Publica ahora o programa; dry_run dice cuántos reciben el correo | Presentador o administrador | Modifica |
unpublish_episode | Devuelve el episodio a borrador | Presentador o administrador | Pide confirmación |
transcribe_episode | Pide la transcripción | Presentador o administrador | Modifica |
get_episode_transcript | La transcripción en texto, tramos o subtítulo | Quien puede escucharlo | Solo consulta |
get_episode_stats | Los números de un episodio | Presentador o equipo | Solo consulta |
save_episode_progress | Guarda dónde lo dejaste | Quien puede escucharlo | Modifica |
react_to_episode | Reacciona al episodio | Quien puede escucharlo | Modifica |
list_episode_comments | Los comentarios del episodio | Quien puede escucharlo | Solo consulta |
create_episode_comment | Comenta o responde, con Drop opcional | Quien puede escucharlo | Modifica |
update_episode_comment | Edita tu comentario | El autor | Modifica |
delete_episode_comment | Elimina un comentario y sus respuestas | El autor o moderador | Pide confirmación |
react_to_episode_comment | Reacciona a un comentario | Quien puede escucharlo | Modifica |
get_my_media_queue | Tu cola | Cualquiera | Solo consulta |
queue_episode | Pone un episodio al final de la cola | Quien puede escucharlo | Modifica |
unqueue_episode | Quita un episodio de la cola | Cualquiera | Modifica |
reorder_my_media_queue | Reordena la cola entera | Cualquiera | Modifica |
El espacio se crea con create_space y module: "podcast" o "videos", con mode single (un programa) o multi (varios). Presentador es el miembro o moderador elegido para un programa: las herramientas de episodio aparecen para todos los roles, y Memberfy rechaza a quien no es propietario, administrador ni presentador de ese programa. Equipo, en los números, es propietario, administrador, moderador y financiero.
Archivos. El audio (MP3, M4A o AAC, hasta 500 MB; WAV se rechaza) y el vídeo (MP4, WebM o MOV, hasta 4 GB) van por enlace público (audio_file_url, video_file_url), que Memberfy descarga y guarda en un área privada, o en base64 hasta unos 7 MB (audio_file_base64 con audio_file_type, video_file_base64). Las portadas, por cover_image_url o cover_image_base64. Un episodio tiene audio o vídeo, nunca los dos. Un WAV se rechaza con un error que apunta al campo mimeType. Los resúmenes de confirmación de delete_episode, unpublish_episode y remove_show_presenter traen el nombre del programa en show_title, para que lo compruebes antes del sí.
list_shows
Solo consulta
Los programas de un espacio, con portada, presentadores y cuántos episodios tiene cada uno. Rol mínimo: cualquiera que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | El espacio de Pódcast o de Vídeos |
Pídelo así: "¿Qué programas tiene el espacio Audios?"
get_show
Solo consulta
Un programa, con descripción, categoría, idioma, autor, presentadores y si transcribe cada episodio. Rol mínimo: cualquiera que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
show_id | id | Sí | El programa (list_shows) |
create_show
Modifica
Crear un programa. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | El espacio de Pódcast o de Vídeos |
title | texto | Sí | Hasta 200 caracteres |
description | Markdown o HTML | No | |
category | texto | No | La categoría en inglés (Business, Education, Technology…) |
language | texto | No | pt-BR, en-US… |
explicit | verdadero o falso | No | Contenido explícito |
author_name | texto | No | Quién firma el programa |
auto_transcribe | verdadero o falso | No | Transcribir cada episodio al publicarse (Pódcast; activado por defecto) |
presenter_ids | lista de ids | No | Los presentadores (miembros o moderadores; list_members) |
cover_image_url / cover_image_base64 | enlace o base64 | No | La portada, cuadrada |
Pídelo así: "Crea en el espacio Audios el programa Charla de Comunidad, en español, categoría Negocios, con María como presentadora."
update_show
Modifica
Editar el programa. Los mismos campos de create_show (menos space y presenter_ids), más remove_cover. Solo cambia lo que envíes. Rol mínimo: administrador.
delete_show
Pide confirmación
Eliminar el programa, con los episodios, comentarios y números. El resumen dice cuántos episodios salen. Rol mínimo: administrador.
add_show_presenter
Modifica
Hacer a alguien presentador. Pasa a crear, editar, publicar y transcribir los episodios de este programa, y solo de este, y a ver los números. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
show_id | id | Sí | |
member_id | id | Sí | Un miembro o moderador de esta comunidad |
remove_show_presenter
Pide confirmación
Quitar a alguien de los presentadores. Lo que publicó sigue. Parámetros: show_id y member_id. Rol mínimo: administrador.
get_show_stats
Solo consulta
Los números del programa, en total y por episodio: reproducciones (a partir de 30 segundos), personas únicas, cuántas llegaron al 90 % y la finalización media. Rol mínimo: presentador del programa o equipo.
Pídelo así: "¿Qué episodio de Charla de Comunidad se escuchó más?"
list_episodes
Solo consulta
Los episodios de un programa. Quien no gestiona el programa ve solo los publicados. Rol mínimo: cualquiera que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
show_id | id | Sí | |
status | draft, scheduled o published | No | Borradores y programados, solo para quien gestiona |
season | número | No | La temporada |
order | newest o oldest | No | |
page, limit | número | No | Hasta 100 por página |
get_episode
Solo consulta
Un episodio, con descripción, capítulos, el punto donde lo dejaste, las reacciones y, para quien gestiona, el estado de la transcripción. Acepta el id o el enlace de la app (incluido el del correo de aviso). Rol mínimo: quien puede escucharlo.
create_episode
Modifica
Crear un episodio, como borrador. Rol mínimo: presentador del programa o administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
show_id | id | Sí | |
title | texto | Sí | Hasta 200 caracteres |
description | Markdown o HTML | No | Las líneas como 00:00 Abertura se convierten en capítulos |
season, number | número | No | Temporada y número del episodio |
type | full, trailer o bonus | No | Completo (por defecto), tráiler o extra |
is_open | verdadero o falso | No | Episodio abierto: se reproduce para todos los miembros de la comunidad |
chapters | lista de { start_seconds, title } | No | Capítulos propios, en lugar de los de la descripción |
audio_file_url / audio_file_base64 | enlace o base64 | No | El audio (consulta Archivos, arriba) |
video_file_url / video_file_base64 | enlace o base64 | No | El vídeo |
cover_image_url / cover_image_base64 | enlace o base64 | No | La portada del episodio |
Después, publish_episode.
Pídelo así: "Crea el episodio 4 de la temporada 1 de Charla de Comunidad con el audio de este enlace y estos capítulos."
update_episode
Modifica
Editar el episodio. Los campos de create_episode, más remove_media (quita el audio o el vídeo; un episodio publicado necesita uno) y remove_cover. chapters: null vuelve a leer los capítulos de la descripción. Cambiar el archivo oculta la transcripción anterior. Rol mínimo: presentador del programa o administrador.
delete_episode
Pide confirmación
Eliminar el episodio, con el archivo, los comentarios y los números. Rol mínimo: presentador del programa o administrador.
publish_episode
Modifica
Publicar o programar. El episodio necesita audio o vídeo. A la hora en que se publica, quien puede escucharlo y dejó activada la categoría Pódcast y vídeos recibe un correo. El asistente llama primero con dry_run y dice cuántas personas lo van a recibir. Rol mínimo: presentador del programa o administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episode | id o enlace | Sí | |
publish_at | fecha y hora (ISO 8601) | No | En el futuro, programa; vacía o en el pasado, publica ahora |
notify_by_email | verdadero o falso | No | false publica sin correo |
dry_run | verdadero o falso | No | No publica: solo dice cuántos reciben el correo |
Pídelo así: "Programa el episodio 4 para el lunes a las 7:00 y dime antes cuántas personas reciben el correo."
unpublish_episode
Pide confirmación
Despublicar. El episodio vuelve a borrador y los miembros dejan de verlo; los comentarios, las reacciones y los números se guardan. Rol mínimo: presentador del programa o administrador.
transcribe_episode
Modifica
Pedir la transcripción. Usa los minutos de transcripción de IA del plan (los mismos de los Drops). Se rechaza sin archivo, por encima de 4 horas, con una transcripción ya en curso o con la cuota del mes agotada. Rol mínimo: presentador del programa o administrador.
get_episode_transcript
Solo consulta
La transcripción lista. Rol mínimo: quien puede escucharlo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episode | id o enlace | Sí | |
format | text, cues o vtt | No | El texto (por defecto), los tramos con los tiempos o el subtítulo WebVTT |
Pídelo así: "Resume el episodio 4 a partir de la transcripción y enumera los tramos sobre precios."
get_episode_stats
Solo consulta
Los números de un episodio: reproducciones (a partir de 30 segundos), personas únicas, cuántas empezaron, cuántas llegaron al 90 %, la finalización media y la retención en 20 tramos. Rol mínimo: presentador del programa o equipo.
save_episode_progress
Modifica
Guardar dónde lo dejaste (position_seconds), para continuar en cualquier dispositivo. Llegar al 90 % marca el episodio como terminado. Rol mínimo: quien puede escucharlo.
react_to_episode
Modifica
Reaccionar con 🎉 ❤️ 👍 🔥 🙌 😊 o 👏 (una reacción por persona; otra sustituye a la anterior), o quitar la tuya con remove: true. Rol mínimo: quien puede escucharlo.
list_episode_comments
Solo consulta
Los comentarios, con las respuestas. Parámetros: episode, sort (newest o oldest), page, limit. Rol mínimo: quien puede escucharlo.
create_episode_comment
Modifica
Comentar (hasta 5.000 caracteres), o responder a un comentario (parent_id, un nivel), opcionalmente con un Drop en vídeo (video_file_url o video_file_base64, hasta 500 MB) cuando la comunidad acepta Drops en los comentarios. Comentar da los puntos de participación una vez por episodio. Rol mínimo: quien puede escucharlo.
update_episode_comment
Modifica
Editar tu comentario. Parámetros: episode, comment_id, comment. Solo el autor.
delete_episode_comment
Pide confirmación
Eliminar un comentario y sus respuestas. El autor, o el propietario, el administrador y el moderador.
react_to_episode_comment
Modifica
Reaccionar a un comentario, con las mismas reacciones del episodio, o quitar la tuya. Rol mínimo: quien puede escuchar el episodio.
get_my_media_queue
Solo consulta
Tu cola, en orden, con los episodios de los espacios de Pódcast y de Vídeos de esta comunidad. Cualquier rol.
queue_episode
Modifica
Poner un episodio al final de la cola. Rol mínimo: quien puede escucharlo.
unqueue_episode
Modifica
Quitar un episodio de la cola. El episodio no cambia. Cualquier rol.
reorder_my_media_queue
Modifica
Reordenar la cola entera (episode_ids, hasta 200, en el orden deseado). El episodio que quede fuera de la lista sale de la cola. Cualquier rol.
Pídelo así: "Pon los tres últimos episodios de Entre bastidores al principio de mi cola."