# Strumenti · Eventi

> Strumenti MCP per gli eventi: elencare gli eventi e chi ha confermato la presenza, creare un evento con biglietto, modificare data, luogo, diretta e banner, avviare e terminare la diretta, confermare la tua partecipazione ed eliminare un evento.

L'agenda della community: i prossimi eventi e chi ci va, un nuovo evento (online, dal vivo o ibrido) con il biglietto in vendita, cambi di data, luogo o banner, la diretta e la tua partecipazione.

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_events`](#list-events) | Eventi prossimi, passati, i miei o tutti | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_event_attendees`](#list-event-attendees) | Chi ha confermato la presenza a un evento | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_event`](#create-event) | Spazio, evento e il biglietto, in una volta | Moderatore (con biglietto, Admin) | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_event`](#update-event) | Modifica un evento e il banner | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`start_live_stream`](#start-live-stream) | Segna l'evento come in diretta, con il link della trasmissione | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`stop_live_stream`](#stop-live-stream) | Termina la diretta | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`rsvp_event`](#rsvp-event) | Dice se partecipi: parteciperò, forse o non parteciperò | Membro (non la finanza) | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_event`](#delete-event) | Elimina un evento | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |

## `list_events`

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

**Elencare gli eventi.** Gli eventi della community. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `filter` | `next`, `past`, `my`, `all` | No | Prossimi (predefinito), passati, quelli che hai confermato, o tutti |
| `space_id` | id | No | Un solo spazio di eventi |
| `search` | testo | No | Parte del titolo |
| `page`, `limit` | numero | No | Paginazione |

**Restituisce:** gli eventi, con id, titolo, inizio, fine, tipo (online, dal vivo, ibrido) e luogo.

**Chiedi così:** *"Quali sono i prossimi eventi?"*

## `list_event_attendees`

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

**Chi ha confermato la presenza.** I partecipanti di un evento. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `event_id` | id | Sì | Da `list_events` |
| `status` | `going`, `maybe` | No | Solo chi partecipa, o solo chi forse partecipa |

**Restituisce:** i partecipanti, con il nome e la risposta.

**Chiedi così:** *"Quante persone hanno confermato per l'incontro di giovedì? Elenca i nomi."*

**Note:** chi ha comprato un biglietto tramite `create_event` non entra da solo in questo elenco. Vedi [Problemi comuni](/mcp/problemas-comuns#cosa-non-si-puo-ancora-fare).

## `create_event`

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

**Creare un evento (con biglietto facoltativo).** Spazio Eventi → evento → (facoltativo) il biglietto, un prodotto singolo che sblocca lo spazio, con disponibilità. *Ruolo minimo: moderatore; con biglietto, o creando lo spazio, Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `title` | testo, fino a 255 | Sì | |
| `description` | Markdown | No | La descrizione dell'evento, in [Markdown](/mcp/ferramentas#testo-in-markdown) |
| `start` | data ISO 8601 con fuso orario | Sì | Es.: `2026-11-10T19:00:00-03:00` |
| `end` | data ISO 8601 | No | |
| `type` | `online`, `in_person`, `hybrid` | No | Predefinito: `online` |
| `location` | testo | No | Il nome del luogo |
| `address` | oggetto | No | `street`, `number`, `neighborhood`, `city`, `state`, `country`, `postal_code` |
| `streaming_url` | indirizzo web | No | |
| `timezone` | testo | No | Es.: `America/Sao_Paulo`. Predefinito: quello della community |
| `visibility` | `public`, `members`, `plan` | No | |
| `space_id` | id | No | Uno spazio Eventi esistente |
| `section_id` | id | No | Dove creare lo spazio |
| `space_title` | testo | No | |
| `ticket` | oggetto | No | Gli stessi campi della `sale` di `create_course` |
| `icon` | una delle icone dell'elenco | No | L'icona dello spazio creato |
| `image_url` | link | No | Il banner dell'evento. Vedi [Immagini](/mcp/ferramentas#immagini) |
| `idempotency_key` | testo, fino a 100 | No | |

**Restituisce:** lo spazio, l'evento (id, titolo, slug, inizio, fine) e il biglietto (id, titolo, prezzo, disponibilità, stato), se c'è.

**Chiedi così:** *"Crea l'Incontro di Novembre, dal vivo, il 15/11 dalle 19 alle 22 allo Spazio Paulista, Rua Augusta 1500, San Paolo, con 80 biglietti da R$ 60 in bozza."*

**Note:** chi compra il biglietto ottiene l'accesso allo spazio dell'evento, ma **non entra ancora da solo nella lista dei partecipanti**; la risposta dello strumento lo segnala. Un moderatore senza `space_id` viene rifiutato al passaggio dello spazio, perché creare uno spazio richiede Admin: per lui, indica uno spazio di eventi esistente.

## `update_event`

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

**Modificare un evento.** Cambia titolo, descrizione, date, tipo, luogo, indirizzo, link della diretta, visibilità e il banner. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `event` | id, slug o link | Sì | |
| `title`, `description`, `start`, `end`, `type`, `location`, `address`, `streaming_url`, `visibility` | | No | Gli stessi di [`create_event`](/mcp/ferramentas-eventos#create-event) |
| `image_url` o `image_base64` | link o file | No | Il nuovo banner |

**Chiedi così:** *"Sposta l'incontro di domani a giovedì, stesso orario."*

## `start_live_stream`

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

**Avvia diretta.** Segna un evento come in diretta, con il link e il servizio della trasmissione, se ci sono. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `event` | id, slug o link | Sì | |
| `streaming_url` | link | No | |
| `streaming_service` | `youtube`, `vimeo`, `mux` | No | |

**Chiedi così:** *"Siamo in diretta: segna la live di oggi con il link https://youtube.com/…"*

**Note:** dopo, la risposta suggerisce di terminare la diretta quando finisce.

## `stop_live_stream`

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

**Termina diretta.** *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `event` | id, slug o link | Sì | |

## `rsvp_event`

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

**Conferma partecipazione all'evento.** Dice se partecipi a un evento. *Ruolo: proprietario, Admin, moderatore o membro.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `event` | id, slug o link | Sì | |
| `status` | `going`, `maybe`, `not_going` | Sì | Parteciperò, forse o non parteciperò |

**Chiedi così:** *"Conferma la mia partecipazione all'Incontro di Novembre."*

## `delete_event`

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

**Elimina evento.** *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `event` | id, slug o link | Sì | |

**Restituisce:** alla prima chiamata, il titolo, la data e quante persone hanno confermato, più il codice di conferma.

## Correlati

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