# Strumenti · Contenuti e coinvolgimento

> Strumenti MCP per ciò che accade nel feed: cercare, leggere, pubblicare, modificare, spostare ed eliminare post, post brevi, commentare e rispondere, modificare ed eliminare commenti, reagire, fissare, la galleria (aggiungere, elencare, modificare, reagire ed eliminare), la classifica e i tuoi punti, e la moderazione.

La vita quotidiana della community: la classifica e la coda di moderazione, trovare un post per titolo, pubblicare un avviso con immagine, rispondere alle domande di una diretta, reagire alle presentazioni, fissare ciò che conta, spostare un post nello spazio giusto e curare le foto della galleria. Post e commenti escono con il nome di chi ha collegato l'assistente.

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_posts`](#list-posts) | Il feed, con commenti e reazioni | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`search_content`](#search-content) | Cerca post, eventi, corsi, sezioni, spazi e call per titolo | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_comments`](#list-comments) | Commenti di un post | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_post`](#create-post) | Pubblica un post, con copertina tramite link | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_post`](#update-post) | Modifica titolo, testo, copertina; fissa | Autore o moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_post`](#delete-post) | Elimina un post, con conferma | Autore o moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`move_post`](#move-post) | Sposta un post in un altro spazio Contenuti o Feed | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`create_short_post`](#create-short-post) | Pubblica un post breve, senza titolo, in un Feed | Membro (non la finanza) | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`create_comment`](#create-comment) | Commenta o risponde | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_comment`](#update-comment) | Modifica un commento | Autore o moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_comment`](#delete-comment) | Elimina un commento, con conferma | Autore o moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`add_reaction`](#add-reaction) | Reagisce con un'emoji | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`pin_post`](#pin-post) | Fissa o sgancia nel feed | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`add_gallery_image`](#add-gallery-image) | Mette un'immagine, tramite link, in una galleria | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_gallery_images`](#list-gallery-images) | Le immagini di una galleria, con autore e reazioni | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`update_gallery_image`](#update-gallery-image) | Cambia il titolo o la descrizione di un'immagine | Autore o moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`react_to_gallery_image`](#react-to-gallery-image) | Reagisce a un'immagine della galleria | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_gallery_image`](#delete-gallery-image) | Elimina un'immagine della galleria | Autore o moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`get_leaderboard`](#get-leaderboard) | La parte alta della classifica | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_my_points`](#get-my-points) | I tuoi punti e la tua posizione in classifica | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_ranking_rules`](#get-ranking-rules) | Se la classifica è attiva e i punti per azione | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`update_ranking_rules`](#update-ranking-rules) | Attiva, disattiva e cambia i punti | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_moderation_queue`](#list-moderation-queue) | Ciò che attende approvazione | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`moderate_item`](#moderate-item) | Approva o rifiuta un elemento della coda | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |

## `list_posts`

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

**Elencare i post del feed.** Il feed (post, stati, eventi e corsi), dal più recente al più vecchio, con il numero di commenti e reazioni. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space_id` | id | No | Un solo spazio (da `list_spaces`) |
| `type` | `all`, `status`, `content`, `events`, `courses` | No | Un solo tipo di elemento |
| `page`, `limit` | numero | No | Paginazione |

**Restituisce:** gli elementi, ciascuno con l'**id** e il **tipo** che chiedono `create_comment`, `add_reaction` e `pin_post`, l'autore, il titolo o il testo, i conteggi e se è fissato.

**Chiedi così:** *"Quali sono stati i post più commentati di questa settimana?"* · *"Cosa è stato pubblicato nello spazio Avvisi?"*

## `search_content`

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

**Cercare per titolo.** Cerca per titolo in post, eventi, corsi, sezioni, spazi e call for papers, senza distinguere maiuscole e accenti, con un'unica ricerca su tutta la community. *Ruolo minimo: qualsiasi; ognuno trova ciò che può vedere.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `query` | testo, da 2 a 200 | Sì | Parte del titolo. Nei post brevi cerca nel testo |
| `types` | elenco: `posts`, `events`, `courses`, `spaces`, `calls` | No | Predefinito: tutti. `spaces` comprende le sezioni |
| `limit` | numero, fino a 50 | No | Predefinito 20 |

**Restituisce:** i risultati, ciascuno con tipo, id, titolo e, quando ci sono, lo spazio, la sezione, il modulo, la data e lo stato.

**Note:** chi non fa parte dello staff trova solo ciò che è pubblicato e approvato; gli spazi e le sezioni chiusi per quella persona restano fuori. La ricerca è la stessa di [`GET /api/search`](/api/referencia/feed/get-search).

**Chiedi così:** *"Trova il post Come funziona la community."*

## `list_comments`

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

**Elencare i commenti di un post.** I commenti di un post di contenuto o di uno stato. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `type` | `content`, `status` | Sì | Il tipo dell'elemento, da `list_posts` |
| `post_id` | id | Sì | L'id dell'elemento, da `list_posts` |

**Restituisce:** i commenti, con l'id (che `create_comment` usa in `reply_to`), l'autore, il testo e la data.

**Chiedi così:** *"Quali commenti del post di benvenuto non hanno ancora una risposta?"*

## `create_post`

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

**Pubblicare un post.** Pubblica un post di testo in uno spazio Feed o Contenuto. *Ruolo minimo: qualsiasi ruolo che possa pubblicare in quello spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space_id` | id | Sì | Da `list_spaces` |
| `title` | testo | Sì | |
| `text` | Markdown | Sì | Il corpo del post, in [Markdown](/mcp/ferramentas#testo-in-markdown): grassetto, corsivo, elenchi, link, sottotitoli, citazione e codice |
| `image_url` | link | No | La copertina del post: un link pubblico (`http`/`https`) a un'immagine JPEG, PNG, WebP o GIF fino a 10 MB. Vedi [Immagini](/mcp/ferramentas#immagini) |

**Restituisce:** il post creato, con l'id (per `pin_post`) e la copertina. Il testo torna in Markdown, con `text_format: "markdown"`.

**Chiedi così:** *"Pubblica nel Feed un post di benvenuto per chi è entrato questa settimana, citando ciascuno per nome."*

**Note:** il post esce con il nome e la foto di chi ha collegato l'assistente. Vale la regola **Chi può pubblicare** dello spazio: in uno spazio riservato allo staff, un membro viene rifiutato. Il post esce subito; programmarlo non è ancora possibile. Se l'immagine non può essere usata, non viene pubblicato nulla e l'assistente riceve il motivo.

## `update_post`

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

**Modificare un post.** Cambia titolo, testo o copertina di un post, e lo fissa o lo sgancia. Cambia solo ciò che viene inviato. *Ruolo minimo: l'autore, oppure moderatore in su.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `post` | id o link | Sì | |
| `type` | `content`, `status` | No | Predefinito: `content`. Negli status (post brevi) cambia solo il testo |
| `title` | testo semplice | No | |
| `text` | Markdown | No | In un post breve (`status`), solo grassetto, corsivo, link e a capo |
| `image_url` o `image_base64` | link o file | No | La nuova copertina. Vedi [Immagini](/mcp/ferramentas#immagini) |
| `remove_image` | sì o no | No | Toglie la copertina |
| `pinned` | sì o no | No | Fissa o sgancia (moderatore in su) |

**Chiedi così:** *"Nel post Come funziona la community, sostituisci la copertina con questa immagine e fissalo in alto."*

**Note:** il post non cambia spazio.

## `delete_post`

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

**Eliminare un post.** Chiede conferma: la prima chiamata mostra il post, e solo la seconda lo elimina. *Ruolo minimo: l'autore, oppure moderatore in su.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `post` | id o link | Sì | |
| `type` | `content`, `status` | No | Predefinito: `content` |

## `move_post`

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

**Sposta post in un altro spazio.** Porta un post in un altro spazio Contenuti o Feed della community; il suo posto nel feed lo segue. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `post` | id o link | Sì | |
| `to_space` | id, link, indirizzo o nome | Sì | Uno spazio Contenuti o Feed |

**Chiedi così:** *"Questo annuncio di lavoro è finito in Avvisi; spostalo nello spazio Offerte di lavoro."*

**Note:** uno spazio di un altro modulo (Corsi, Eventi…) viene rifiutato.

## `create_short_post`

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

**Pubblica post breve.** Un post breve, fino a 500 caratteri e senza titolo, in uno spazio Feed, come il campo rapido dell'app. Per un post con titolo e copertina, l'assistente usa `create_post`. *Ruolo: proprietario, Admin, moderatore o membro che può pubblicare nello spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id, link, indirizzo o nome | Sì | Uno spazio Feed |
| `text` | testo, fino a 500 | Sì | Accetta solo grassetto, corsivo, link e a capo, in [Markdown](/mcp/ferramentas#testo-in-markdown) |
| `visibility` | `public`, `members`, `private` | No | |

**Chiedi così:** *"Scrivi nel Feed: 'Diretta stasera alle 20, il link è nell'evento!'"*

## `create_comment`

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

**Commentare o rispondere.** Commenta un elemento del feed, o risponde a un commento. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `type` | `content`, `status`, `event`, `course` | Sì | Il tipo dell'elemento, da `list_posts` |
| `item_id` | id | Sì | L'id dell'elemento |
| `text` | testo semplice, fino a 2.000 | Sì | Senza formattazione: i segni di Markdown vengono tolti |
| `reply_to` | id | No | L'id del commento a cui rispondere (da `list_comments`). Solo per elementi di tipo `content` |

**Restituisce:** il commento creato.

**Chiedi così:** *"Rispondi a ogni domanda senza risposta nel post della live di ieri, ringraziando e dicendo che ne parleremo nella prossima."*

## `update_comment`

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

**Modificare un commento.** Cambia il testo di un commento. *Ruolo minimo: l'autore, oppure moderatore in su.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `type` | `content`, `status` | Sì | |
| `post` | id o link | Sì | Il post del commento |
| `comment_id` | id | Sì | Da `list_comments` |
| `text` | testo, fino a 2.000 | Sì | |

## `delete_comment`

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

**Eliminare un commento.** Con conferma. *Ruolo minimo: l'autore, oppure moderatore in su.* Stessi parametri, senza `text`.

## `add_reaction`

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

**Reagire.** Reagisce a un elemento del feed. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `type` | `content`, `status`, `event`, `course` | Sì | |
| `item_id` | id | Sì | |
| `reaction` | 👍 ❤️ 🔥 🙌 😊 👏 🎉 | Sì | Una delle sette reazioni |

**Restituisce:** la reazione registrata.

**Chiedi così:** *"Reagisci con 🎉 alle presentazioni di chi è entrato oggi."*

## `pin_post`

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

**Fissare nel feed.** Fissa un elemento in cima al feed, o lo sgancia. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `type` | `content`, `status`, `event`, `course` | Sì | |
| `item_id` | id | Sì | |
| `pinned` | sì o no | No | Predefinito: fissare. Con `false`, sgancia |

**Restituisce:** l'elemento con il nuovo stato.

**Chiedi così:** *"Fissa il post con le regole della community."*

## `add_gallery_image`

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

**Aggiungere un'immagine a una galleria.** Scarica un'immagine da un link e la mette in uno spazio Galleria. *Ruolo minimo: qualsiasi ruolo che possa pubblicare in quello spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space_id` | id | Sì | Uno spazio Galleria (`list_spaces` con `module: gallery`) |
| `image_url` | link | Sì | Un link pubblico (`http`/`https`) a un'immagine JPEG, PNG, WebP o GIF fino a 10 MB. Vedi [Immagini](/mcp/ferramentas#immagini) |
| `title` | testo, fino a 255 | No | Il titolo dell'immagine nella galleria |

**Restituisce:** l'immagine nella galleria, con l'indirizzo e la miniatura.

**Chiedi così:** *"Metti questa foto dell'incontro nella galleria Incontri: https://…/foto.jpg"*

## `list_gallery_images`

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

**Elenca immagini della galleria.** Le immagini di uno spazio Galleria, dalla più recente alla più vecchia, con titolo, autore e reazioni. *Ruolo minimo: qualsiasi ruolo che veda lo spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id, link, indirizzo o nome | Sì | Lo spazio Galleria |
| `page`, `limit` | numero | No | `limit` fino a 50 |

**Restituisce:** le immagini, con l'id che chiedono gli altri strumenti della galleria.

## `update_gallery_image`

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

**Modifica immagine della galleria.** Cambia il titolo o la descrizione di un'immagine. *Ruolo: chi ha caricato l'immagine, o dal moderatore in su.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `image_id` | id | Sì | Da `list_gallery_images` |
| `title` | testo, fino a 255 | No | |
| `description` | testo | No | |

## `react_to_gallery_image`

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

**Reagisci a immagine della galleria.** Con 👍 ❤️ 🔥 👏 😊 o 🙌. La stessa reazione una seconda volta la toglie. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `image_id` | id | Sì | Da `list_gallery_images` |
| `reaction` | una delle sei emoji | Sì | |

## `delete_gallery_image`

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

**Elimina immagine della galleria.** *Ruolo: chi ha caricato l'immagine, o dal moderatore in su.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `image_id` | id | Sì | Da `list_gallery_images` |

**Restituisce:** alla prima chiamata, il titolo e l'autore dell'immagine, più il codice di conferma.

## `get_leaderboard`

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

**Vedere la classifica.** La parte alta della classifica a punti della community. *Ruolo minimo: qualsiasi.*

Parametri: nessuno.

**Chiedi così:** *"Chi sono i primi 10 della classifica?"*

## `get_my_points`

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

**I miei punti in classifica.** I tuoi punti e la tua posizione nella classifica della community. *Ruolo minimo: qualsiasi.*

Parametri: nessuno.

**Chiedi così:** *"Quanti punti ho, e in che posizione sono?"*

## `get_ranking_rules`

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

**Vedere le regole della classifica.** Se la classifica è attiva e quanti punti vale ogni azione. *Ruolo minimo: Admin.*

Parametri: nessuno.

**Chiedi così:** *"Quanti punti vale un commento?"*

## `update_ranking_rules`

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

**Cambiare le regole della classifica.** Attiva o disattiva la classifica e cambia i punti per azione. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `enabled` | sì o no | No | |
| `points` | azione → punti | No | Le azioni vengono da `get_ranking_rules`, es.: `{"comment": 10}` |

**Chiedi così:** *"Commentare d'ora in poi vale 10 punti."*

Vedi [Classifica](/espacos/ranking).

## `list_moderation_queue`

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

**Coda di moderazione.** Ciò che attende approvazione, o i numeri della moderazione. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `type` | `summary`, `posts`, `courses`, `events`, `gallery`, `status` | No | Predefinito: `posts`. `summary` restituisce i numeri |

**Chiedi così:** *"C'è qualcosa in attesa di approvazione?"*

## `moderate_item`

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

**Approvare o rifiutare.** Approva o rifiuta un elemento della coda di moderazione. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `type` | `posts`, `courses`, `events`, `gallery`, `status` | Sì | |
| `item_id` | id | Sì | Da `list_moderation_queue` |
| `decision` | `approve`, `reject` | Sì | |
| `reason` | testo | No | Obbligatorio per rifiutare |

**Chiedi così:** *"Approva i post in coda che non hanno link esterni."*

Vedi [Moderazione](/membros/moderacao).

## Correlati

- [Strumenti](/mcp/ferramentas)
- [Ricette](/mcp/receitas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)