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: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
list_events | Eventi prossimi, passati, i miei o tutti | Qualsiasi | Solo lettura |
list_event_attendees | Chi ha confermato la presenza a un evento | Qualsiasi | Solo lettura |
create_event | Spazio, evento e il biglietto, in una volta | Moderatore (con biglietto, Admin) | Modifica |
update_event | Modifica un evento e il banner | Moderatore | Modifica |
start_live_stream | Segna l'evento come in diretta, con il link della trasmissione | Moderatore | Modifica |
stop_live_stream | Termina la diretta | Moderatore | Modifica |
rsvp_event | Dice se partecipi: parteciperò, forse o non parteciperò | Membro (non la finanza) | Modifica |
delete_event | Elimina un evento | Admin | Chiede conferma |
list_events
Solo lettura
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
Solo lettura
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.
create_event
Modifica
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 |
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 |
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
Modifica
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 | |
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
Modifica
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
Modifica
Termina diretta. Ruolo minimo: moderatore.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
event | id, slug o link | Sì |
rsvp_event
Modifica
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
Chiede conferma
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.