# 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](/espacos/podcast) y [Vídeos](/espacos/videos) 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: <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_shows`](#list-shows) | Los programas de un espacio | Cualquiera que vea el espacio | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`get_show`](#get-show) | Un programa, con los presentadores | Cualquiera que vea el espacio | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`create_show`](#create-show) | Crea un programa, con portada y presentadores | Administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_show`](#update-show) | Edita el programa | Administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_show`](#delete-show) | Elimina el programa y los episodios | Administrador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`add_show_presenter`](#add-show-presenter) | Hace a alguien presentador del programa | Administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_show_presenter`](#remove-show-presenter) | Quita a alguien de los presentadores | Administrador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`get_show_stats`](#get-show-stats) | Los números del programa, por episodio | Presentador o equipo | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`list_episodes`](#list-episodes) | Los episodios de un programa | Cualquiera que vea el espacio | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`get_episode`](#get-episode) | Un episodio, por el id o por el enlace | Quien puede escucharlo | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`create_episode`](#create-episode) | Crea un episodio (borrador) con audio o vídeo | Presentador o administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_episode`](#update-episode) | Edita el episodio, cambia el archivo y los capítulos | Presentador o administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_episode`](#delete-episode) | Elimina el episodio | Presentador o administrador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`publish_episode`](#publish-episode) | Publica ahora o programa; `dry_run` dice cuántos reciben el correo | Presentador o administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`unpublish_episode`](#unpublish-episode) | Devuelve el episodio a borrador | Presentador o administrador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`transcribe_episode`](#transcribe-episode) | Pide la transcripción | Presentador o administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_episode_transcript`](#get-episode-transcript) | La transcripción en texto, tramos o subtítulo | Quien puede escucharlo | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`get_episode_stats`](#get-episode-stats) | Los números de un episodio | Presentador o equipo | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`save_episode_progress`](#save-episode-progress) | Guarda dónde lo dejaste | Quien puede escucharlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`react_to_episode`](#react-to-episode) | Reacciona al episodio | Quien puede escucharlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_episode_comments`](#list-episode-comments) | Los comentarios del episodio | Quien puede escucharlo | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`create_episode_comment`](#create-episode-comment) | Comenta o responde, con Drop opcional | Quien puede escucharlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_episode_comment`](#update-episode-comment) | Edita tu comentario | El autor | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_episode_comment`](#delete-episode-comment) | Elimina un comentario y sus respuestas | El autor o moderador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`react_to_episode_comment`](#react-to-episode-comment) | Reacciona a un comentario | Quien puede escucharlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_my_media_queue`](#get-my-media-queue) | Tu cola | Cualquiera | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`queue_episode`](#queue-episode) | Pone un episodio al final de la cola | Quien puede escucharlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`unqueue_episode`](#unqueue-episode) | Quita un episodio de la cola | Cualquiera | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`reorder_my_media_queue`](#reorder-my-media-queue) | Reordena la cola entera | Cualquiera | <span class="tool-kind tool-kind-write">Modifica</span> |

El espacio se crea con [`create_space`](/mcp/ferramentas-comunidade#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`](#delete-episode), [`unpublish_episode`](#unpublish-episode) y [`remove_show_presenter`](#remove-show-presenter) traen el nombre del programa en `show_title`, para que lo compruebes antes del sí.

## `list_shows`

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

**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`

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

**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`](#list-shows)) |

## `create_show`

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

**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`](/mcp/ferramentas-membros#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`

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

**Editar el programa.** Los mismos campos de [`create_show`](#create-show) (menos `space` y `presenter_ids`), más `remove_cover`. Solo cambia lo que envíes. *Rol mínimo: administrador.*

## `delete_show`

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

**Eliminar el programa**, con los episodios, comentarios y números. El resumen dice cuántos episodios salen. *Rol mínimo: administrador.*

## `add_show_presenter`

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

**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`

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

**Quitar a alguien de los presentadores.** Lo que publicó sigue. Parámetros: `show_id` y `member_id`. *Rol mínimo: administrador.*

## `get_show_stats`

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

**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`

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

**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`

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

**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`

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

**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`](#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`

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

**Editar el episodio.** Los campos de [`create_episode`](#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`

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

**Eliminar el episodio**, con el archivo, los comentarios y los números. *Rol mínimo: presentador del programa o administrador.*

## `publish_episode`

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

**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`

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

**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`

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

**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`

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

**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`

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

**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`

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

**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`

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

**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`

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

**Los comentarios**, con las respuestas. Parámetros: `episode`, `sort` (`newest` o `oldest`), `page`, `limit`. *Rol mínimo: quien puede escucharlo.*

## `create_episode_comment`

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

**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`

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

**Editar tu comentario.** Parámetros: `episode`, `comment_id`, `comment`. *Solo el autor.*

## `delete_episode_comment`

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

**Eliminar un comentario** y sus respuestas. *El autor, o el propietario, el administrador y el moderador.*

## `react_to_episode_comment`

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

**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`

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

**Tu cola**, en orden, con los episodios de los espacios de Pódcast y de Vídeos de esta comunidad. *Cualquier rol.*

## `queue_episode`

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

**Poner un episodio al final de la cola.** *Rol mínimo: quien puede escucharlo.*

## `unqueue_episode`

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

**Quitar un episodio de la cola.** El episodio no cambia. *Cualquier rol.*

## `reorder_my_media_queue`

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

**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."*

## Relacionados

- [Pódcast](/espacos/podcast)
- [Vídeos](/espacos/videos)
- [Todas las herramientas](/mcp/ferramentas)
- [Dinero y confirmación](/mcp/dinheiro-e-confirmacao)