# Herramientas · Eventos

> Herramientas MCP para eventos: listar eventos y quién ha confirmado asistencia, crear un evento con entrada, editar fecha, lugar, transmisión y banner, iniciar y terminar la transmisión, confirmar tu asistencia y eliminar un evento.

La agenda de la comunidad: los próximos eventos y quién va, un evento nuevo (online, presencial o híbrido) con la entrada a la venta, cambios de fecha, lugar o banner, la transmisión en directo y tu propia asistencia.

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_events`](#list-events) | Eventos próximos, pasados, los míos o todos | Cualquiera | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`list_event_attendees`](#list-event-attendees) | Quién ha confirmado asistencia a un evento | Cualquiera | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`create_event`](#create-event) | Espacio, evento y la entrada, de una vez | Moderador (con entrada, Administrador) | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_event`](#update-event) | Edita un evento y el banner | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`start_live_stream`](#start-live-stream) | Marca el evento como en directo, con el enlace de la transmisión | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`stop_live_stream`](#stop-live-stream) | Termina la transmisión | Moderador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`rsvp_event`](#rsvp-event) | Indica si vas: asistiré, quizás o no asistiré | Miembro (no Finanzas) | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_event`](#delete-event) | Elimina un evento | Administrador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |

## `list_events`

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

**Listar eventos.** Los eventos de la comunidad. *Rol mínimo: cualquiera.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `filter` | `next`, `past`, `my`, `all` | No | Próximos (por defecto), pasados, los que has confirmado, o todos |
| `space_id` | id | No | Un solo espacio de eventos |
| `search` | texto | No | Parte del título |
| `page`, `limit` | número | No | Paginación |

**Devuelve:** los eventos, con id, título, inicio, fin, tipo (online, presencial, híbrido) y lugar.

**Pídelo así:** *"¿Cuáles son los próximos eventos?"*

## `list_event_attendees`

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

**Quién ha confirmado asistencia.** Los participantes de un evento. *Rol mínimo: cualquiera.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `event_id` | id | Sí | De `list_events` |
| `status` | `going`, `maybe` | No | Solo quien va, o solo quien quizá vaya |

**Devuelve:** los participantes, con el nombre y la respuesta.

**Pídelo así:** *"¿Cuántas personas han confirmado para el encuentro del jueves? Enumera los nombres."*

**Notas:** quien compra una entrada creada con `create_event` no entra solo en esta lista. Consulta [Problemas comunes](/mcp/problemas-comuns#lo-que-todavia-no-se-puede-hacer).

## `create_event`

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

**Crear evento (con entrada opcional).** Espacio de Eventos → evento → (opcional) la entrada, un producto suelto que da acceso al espacio, con stock. *Rol mínimo: moderador; con entrada, o creando el espacio, administrador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `title` | texto, hasta 255 | Sí | |
| `description` | Markdown | No | La descripción del evento, en [Markdown](/mcp/ferramentas#texto-en-markdown) |
| `start` | fecha ISO 8601 con zona horaria | Sí | P. ej.: `2026-11-10T19:00:00-03:00` |
| `end` | fecha ISO 8601 | No | |
| `type` | `online`, `in_person`, `hybrid` | No | Por defecto: `online` |
| `location` | texto | No | El nombre del lugar |
| `address` | objeto | No | `street`, `number`, `neighborhood`, `city`, `state`, `country`, `postal_code` |
| `streaming_url` | dirección web | No | |
| `timezone` | texto | No | P. ej.: `America/Sao_Paulo`. Por defecto: la de la comunidad |
| `visibility` | `public`, `members`, `plan` | No | |
| `space_id` | id | No | Un espacio de Eventos que ya existe |
| `section_id` | id | No | Dónde crear el espacio |
| `space_title` | texto | No | |
| `icon` | uno de los iconos de la lista | No | El icono del espacio creado |
| `image_url` | enlace | No | El banner del evento. Consulta [Imágenes](/mcp/ferramentas#imagenes) |
| `ticket` | objeto | No | Los mismos campos que la `sale` de `create_course` |
| `idempotency_key` | texto, hasta 100 | No | |

**Devuelve:** el espacio, el evento (id, título, slug, inicio, fin) y la entrada (id, título, precio, stock, estado), si la hay.

**Pídelo así:** *"Crea el Encuentro de Noviembre, presencial, el 15/11 de 19 h a 22 h en el Espaço Paulista, Rua Augusta 1500, São Paulo, con 80 entradas de R$ 60 en borrador."*

**Notas:** quien compra la entrada obtiene acceso al espacio del evento, pero **todavía no entra solo en la lista de participantes**; la respuesta de la herramienta lo avisa. Un moderador sin `space_id` recibe un rechazo en el paso del espacio, porque crear un espacio exige ser administrador: en su caso, indica un espacio de eventos que ya exista.

## `update_event`

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

**Editar evento.** Cambia el título, la descripción, las fechas, el tipo, el lugar, la dirección, el enlace de la transmisión, la visibilidad y el banner. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `event` | id, slug o enlace | Sí | |
| `title`, `description`, `start`, `end`, `type`, `location`, `address`, `streaming_url`, `visibility` | | No | Los mismos de [`create_event`](/mcp/ferramentas-eventos#create-event) |
| `image_url` o `image_base64` | enlace o archivo | No | El banner nuevo |

**Pídelo así:** *"Pasa el encuentro de mañana al jueves, a la misma hora."*

## `start_live_stream`

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

**Iniciar transmisión.** Marca un evento como en directo, con el enlace y el servicio de la transmisión, si los hay. *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `event` | id, slug o enlace | Sí | |
| `streaming_url` | enlace | No | |
| `streaming_service` | `youtube`, `vimeo`, `mux` | No | |

**Pídelo así:** *"Estamos en directo: marca el directo de hoy con el enlace https://youtube.com/…"*

**Notas:** después, la respuesta sugiere terminar la transmisión cuando acabe.

## `stop_live_stream`

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

**Terminar transmisión.** *Rol mínimo: moderador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `event` | id, slug o enlace | Sí | |

## `rsvp_event`

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

**Confirmar asistencia al evento.** Indica si vas a un evento. *Rol: propietario, administrador, moderador o miembro.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `event` | id, slug o enlace | Sí | |
| `status` | `going`, `maybe`, `not_going` | Sí | Asistiré, quizás o no asistiré |

**Pídelo así:** *"Confirma mi asistencia al Encuentro de Noviembre."*

## `delete_event`

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

**Eliminar evento.** *Rol mínimo: administrador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `event` | id, slug o enlace | Sí | |

**Devuelve:** en la primera llamada, el título, la fecha y cuántas personas han confirmado, y el código de confirmación.

## Relacionados

- [Herramientas](/mcp/ferramentas)
- [Recetas](/mcp/receitas)
- [Dinero y confirmación](/mcp/dinheiro-e-confirmacao)