# Strumenti · Podcast e Video

> Strumenti MCP per i moduli Podcast e Video: programmi e conduttori, episodi con audio, video, copertina e capitoli, pubblicare e programmare con la portata dell'e-mail, trascrizione, numeri, e per chi ascolta il punto in cui si è fermato, reazioni, commenti e la coda.

I moduli [Podcast](/espacos/podcast) e [Video](/espacos/videos) tramite l'assistente: creare programmi e scegliere i conduttori, creare episodi caricando l'audio o il video tramite link o file, pubblicare o programmare sapendo prima quante persone ricevono l'e-mail, trascrivere, vedere i numeri e, per chi ascolta, salvare il punto, reagire, commentare e organizzare la coda.

Ogni strumento ha un'etichetta: <span class="tool-kind tool-kind-read">Solo lettura</span> non cambia nulla, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia qualcosa subito, e <span class="tool-kind tool-kind-confirm">Chiede conferma</span> agisce solo dopo il tuo sì a un riepilogo. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao).

## In sintesi

| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
| [`list_shows`](#list-shows) | I programmi di uno spazio | Chiunque veda lo spazio | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_show`](#get-show) | Un programma, con i conduttori | Chiunque veda lo spazio | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_show`](#create-show) | Crea un programma, con copertina e conduttori | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_show`](#update-show) | Modifica il programma | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_show`](#delete-show) | Elimina il programma e gli episodi | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`add_show_presenter`](#add-show-presenter) | Rende qualcuno conduttore del programma | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_show_presenter`](#remove-show-presenter) | Rimuove qualcuno dai conduttori | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`get_show_stats`](#get-show-stats) | I numeri del programma, per episodio | Conduttore o team | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_episodes`](#list-episodes) | Gli episodi di un programma | Chiunque veda lo spazio | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_episode`](#get-episode) | Un episodio, tramite id o link | Chi può ascoltarlo | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_episode`](#create-episode) | Crea un episodio (bozza) con audio o video | Conduttore o admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_episode`](#update-episode) | Modifica l'episodio, sostituisce il file e i capitoli | Conduttore o admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_episode`](#delete-episode) | Elimina l'episodio | Conduttore o admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`publish_episode`](#publish-episode) | Pubblica ora o programma; `dry_run` dice quanti ricevono l'e-mail | Conduttore o admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`unpublish_episode`](#unpublish-episode) | Riporta l'episodio in bozza | Conduttore o admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`transcribe_episode`](#transcribe-episode) | Richiede la trascrizione | Conduttore o admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_episode_transcript`](#get-episode-transcript) | La trascrizione in testo, tratti o sottotitoli | Chi può ascoltarlo | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_episode_stats`](#get-episode-stats) | I numeri di un episodio | Conduttore o team | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`save_episode_progress`](#save-episode-progress) | Salva il punto in cui ti sei fermato | Chi può ascoltarlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`react_to_episode`](#react-to-episode) | Reagisce all'episodio | Chi può ascoltarlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_episode_comments`](#list-episode-comments) | I commenti dell'episodio | Chi può ascoltarlo | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_episode_comment`](#create-episode-comment) | Commenta o risponde, con un Drop facoltativo | Chi può ascoltarlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_episode_comment`](#update-episode-comment) | Modifica il tuo commento | L'autore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_episode_comment`](#delete-episode-comment) | Elimina un commento e le risposte | L'autore o il moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`react_to_episode_comment`](#react-to-episode-comment) | Reagisce a un commento | Chi può ascoltarlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_my_media_queue`](#get-my-media-queue) | La tua coda | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`queue_episode`](#queue-episode) | Mette un episodio in fondo alla coda | Chi può ascoltarlo | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`unqueue_episode`](#unqueue-episode) | Rimuove un episodio dalla coda | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`reorder_my_media_queue`](#reorder-my-media-queue) | Riordina tutta la coda | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |

Lo spazio si crea con [`create_space`](/mcp/ferramentas-comunidade#create-space) e `module: "podcast"` o `"videos"`, con `mode` `single` (un programma) o `multi` (più programmi). Il **conduttore** è il membro o moderatore scelto per un programma: gli strumenti degli episodi compaiono a tutti i ruoli, e Memberfy rifiuta chi non è proprietario, amministratore né conduttore di quel programma. Il **team**, nei numeri, è proprietario, amministratore, moderatore e finanza.

**File.** L'audio (MP3, M4A o AAC, fino a 500 MB; il WAV viene rifiutato) e il video (MP4, WebM o MOV, fino a 4 GB) si inviano tramite link pubblico (`audio_file_url`, `video_file_url`), che Memberfy scarica e conserva in un'area privata, oppure in base64 fino a circa 7 MB (`audio_file_base64` con `audio_file_type`, `video_file_base64`). Le copertine, con `cover_image_url` o `cover_image_base64`. Un episodio ha l'audio **o** il video, mai entrambi. Un WAV viene rifiutato con un errore che indica il campo `mimeType`. I riepiloghi di conferma di [`delete_episode`](#delete-episode), [`unpublish_episode`](#unpublish-episode) e [`remove_show_presenter`](#remove-show-presenter) riportano il nome del programma in `show_title`, così puoi verificarlo prima del sì.

## `list_shows`

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

**I programmi di uno spazio**, con copertina, conduttori e quanti episodi ha ciascuno. *Ruolo minimo: chiunque veda lo spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | Lo spazio Podcast o Video |

**Chiedi così:** *"Quali programmi ha lo spazio Audio?"*

## `get_show`

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

**Un programma**, con descrizione, categoria, lingua, autore, conduttori e se trascrive ogni episodio. *Ruolo minimo: chiunque veda lo spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `show_id` | id | Sì | Il programma ([`list_shows`](#list-shows)) |

## `create_show`

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

**Creare un programma.** *Ruolo minimo: admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | Lo spazio Podcast o Video |
| `title` | testo | Sì | Fino a 200 caratteri |
| `description` | Markdown o HTML | No | |
| `category` | testo | No | La categoria in inglese (`Business`, `Education`, `Technology`…) |
| `language` | testo | No | `pt-BR`, `en-US`… |
| `explicit` | vero o falso | No | Contenuto esplicito |
| `author_name` | testo | No | Chi firma il programma |
| `auto_transcribe` | vero o falso | No | Trascrivere ogni episodio quando va online (Podcast; attivo per impostazione predefinita) |
| `presenter_ids` | elenco di id | No | I conduttori (membri o moderatori; [`list_members`](/mcp/ferramentas-membros#list-members)) |
| `cover_image_url` / `cover_image_base64` | link o base64 | No | La copertina, quadrata |

**Chiedi così:** *"Crea nello spazio Audio il programma Chiacchiere di Community, in italiano, categoria Business, con Maria come conduttrice."*

## `update_show`

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

**Modificare il programma.** Gli stessi campi di [`create_show`](#create-show) (tranne `space` e `presenter_ids`), più `remove_cover`. Cambia solo ciò che invii. *Ruolo minimo: admin.*

## `delete_show`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Eliminare il programma**, con gli episodi, i commenti e i numeri. Il riepilogo dice quanti episodi escono. *Ruolo minimo: admin.*

## `add_show_presenter`

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

**Rendere qualcuno conduttore.** Da quel momento crea, modifica, pubblica e trascrive gli episodi di questo programma, e solo di questo, e vede i numeri. *Ruolo minimo: admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `show_id` | id | Sì | |
| `member_id` | id | Sì | Un membro o moderatore di questa community |

## `remove_show_presenter`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Rimuovere qualcuno dai conduttori.** Ciò che ha pubblicato resta. Parametri: `show_id` e `member_id`. *Ruolo minimo: admin.*

## `get_show_stats`

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

**I numeri del programma**, in totale e per episodio: riproduzioni (da 30 secondi), persone uniche, quante sono arrivate al 90% e il completamento medio. *Ruolo minimo: conduttore del programma o team.*

**Chiedi così:** *"Quale episodio di Chiacchiere di Community è stato più ascoltato?"*

## `list_episodes`

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

**Gli episodi di un programma.** Chi non gestisce il programma vede solo quelli online. *Ruolo minimo: chiunque veda lo spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `show_id` | id | Sì | |
| `status` | `draft`, `scheduled` o `published` | No | Bozze e programmati, solo per chi gestisce |
| `season` | numero | No | La stagione |
| `order` | `newest` o `oldest` | No | |
| `page`, `limit` | numero | No | Fino a 100 per pagina |

## `get_episode`

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

**Un episodio**, con descrizione, capitoli, il punto in cui ti sei fermato, le reazioni e, per chi gestisce, lo stato della trascrizione. Accetta l'id o il link dell'app (anche quello dell'e-mail di avviso). *Ruolo minimo: chi può ascoltarlo.*

## `create_episode`

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

**Creare un episodio**, in bozza. *Ruolo minimo: conduttore del programma o admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `show_id` | id | Sì | |
| `title` | testo | Sì | Fino a 200 caratteri |
| `description` | Markdown o HTML | No | Le righe come `00:00 Apertura` diventano capitoli |
| `season`, `number` | numero | No | Stagione e numero dell'episodio |
| `type` | `full`, `trailer` o `bonus` | No | Completo (predefinito), trailer o bonus |
| `is_open` | vero o falso | No | Episodio aperto: si riproduce per tutti i membri della community |
| `chapters` | elenco di `{ start_seconds, title }` | No | Capitoli personalizzati, al posto di quelli della descrizione |
| `audio_file_url` / `audio_file_base64` | link o base64 | No | L'audio (vedi **File**, sopra) |
| `video_file_url` / `video_file_base64` | link o base64 | No | Il video |
| `cover_image_url` / `cover_image_base64` | link o base64 | No | La copertina dell'episodio |

Poi, [`publish_episode`](#publish-episode).

**Chiedi così:** *"Crea l'episodio 4 della stagione 1 di Chiacchiere di Community con l'audio di questo link e questi capitoli."*

## `update_episode`

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

**Modificare l'episodio.** I campi di [`create_episode`](#create-episode), più `remove_media` (toglie l'audio o il video; un episodio online ne ha bisogno) e `remove_cover`. `chapters: null` torna a leggere i capitoli dalla descrizione. Sostituire il file nasconde la vecchia trascrizione. *Ruolo minimo: conduttore del programma o admin.*

## `delete_episode`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Eliminare l'episodio**, con il file, i commenti e i numeri. *Ruolo minimo: conduttore del programma o admin.*

## `publish_episode`

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

**Pubblicare o programmare.** L'episodio deve avere audio o video. Nel momento in cui va online, chi può ascoltarlo e ha lasciato attiva la categoria **Podcast e video** riceve un'e-mail. L'assistente chiama prima con `dry_run` e dice quante persone la riceveranno. *Ruolo minimo: conduttore del programma o admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `episode` | id o link | Sì | |
| `publish_at` | data e ora (ISO 8601) | No | Nel futuro, programma; vuota o nel passato, pubblica subito |
| `notify_by_email` | vero o falso | No | `false` pubblica senza e-mail |
| `dry_run` | vero o falso | No | Non pubblica: dice solo quanti ricevono l'e-mail |

**Chiedi così:** *"Programma l'episodio 4 per lunedì alle 7 e dimmi prima quante persone ricevono l'e-mail."*

## `unpublish_episode`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Annullare la pubblicazione.** L'episodio torna bozza e sparisce per i membri; commenti, reazioni e numeri restano salvati. *Ruolo minimo: conduttore del programma o admin.*

## `transcribe_episode`

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

**Richiedere la trascrizione.** Usa i minuti di trascrizione IA del piano (gli stessi dei Drops). Viene rifiutata senza file, oltre le 4 ore, con una trascrizione già in corso o con la quota del mese esaurita. *Ruolo minimo: conduttore del programma o admin.*

## `get_episode_transcript`

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

**La trascrizione pronta.** *Ruolo minimo: chi può ascoltarlo.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `episode` | id o link | Sì | |
| `format` | `text`, `cues` o `vtt` | No | Il testo (predefinito), i tratti con i tempi o i sottotitoli WebVTT |

**Chiedi così:** *"Riassumi l'episodio 4 a partire dalla trascrizione ed elenca i tratti sul prezzo."*

## `get_episode_stats`

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

**I numeri di un episodio:** riproduzioni (da 30 secondi), persone uniche, quante hanno iniziato, quante sono arrivate al 90%, il completamento medio e la ritenzione in 20 tratti. *Ruolo minimo: conduttore del programma o team.*

## `save_episode_progress`

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

**Salvare il punto in cui ti sei fermato** (`position_seconds`), per riprendere su qualsiasi dispositivo. Arrivare al 90% segna l'episodio come completato. *Ruolo minimo: chi può ascoltarlo.*

## `react_to_episode`

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

**Reagire** con 🎉 ❤️ 👍 🔥 🙌 😊 o 👏 (una reazione per persona; un'altra sostituisce la precedente), oppure togliere la tua con `remove: true`. *Ruolo minimo: chi può ascoltarlo.*

## `list_episode_comments`

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

**I commenti**, con le risposte. Parametri: `episode`, `sort` (`newest` o `oldest`), `page`, `limit`. *Ruolo minimo: chi può ascoltarlo.*

## `create_episode_comment`

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

**Commentare** (fino a 5.000 caratteri), o rispondere a un commento (`parent_id`, un livello), facoltativamente con un Drop video (`video_file_url` o `video_file_base64`, fino a 500 MB) quando la community accetta i Drops nei commenti. Commentare dà i punti di coinvolgimento una volta per episodio. *Ruolo minimo: chi può ascoltarlo.*

## `update_episode_comment`

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

**Modificare il tuo commento.** Parametri: `episode`, `comment_id`, `comment`. *Solo l'autore.*

## `delete_episode_comment`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Eliminare un commento** e le sue risposte. *L'autore, oppure il proprietario, l'amministratore e il moderatore.*

## `react_to_episode_comment`

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

**Reagire a un commento**, con le stesse reazioni dell'episodio, oppure togliere la tua. *Ruolo minimo: chi può ascoltare l'episodio.*

## `get_my_media_queue`

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

**La tua coda**, in ordine, con gli episodi degli spazi Podcast e Video di questa community. *Qualsiasi ruolo.*

## `queue_episode`

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

**Mettere un episodio in fondo alla coda.** *Ruolo minimo: chi può ascoltarlo.*

## `unqueue_episode`

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

**Rimuovere un episodio dalla coda.** L'episodio non cambia. *Qualsiasi ruolo.*

## `reorder_my_media_queue`

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

**Riordinare tutta la coda** (`episode_ids`, fino a 200, nell'ordine desiderato). L'episodio che resta fuori dall'elenco esce dalla coda. *Qualsiasi ruolo.*

**Chiedi così:** *"Metti gli ultimi tre episodi di Dietro le quinte all'inizio della mia coda."*

## Correlati

- [Podcast](/espacos/podcast)
- [Video](/espacos/videos)
- [Strumenti](/mcp/ferramentas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)