# Ferramentas · Eventos

> Ferramentas MCP para eventos: listar eventos e quem confirmou presença, criar um evento com ingresso, editar data, local, transmissão e banner, iniciar e encerrar a transmissão, confirmar a sua presença e excluir um evento.

A agenda da comunidade: os próximos eventos e quem vai, um evento novo (online, presencial ou híbrido) com o ingresso à venda, mudanças de data, local ou banner, a transmissão ao vivo e a sua própria presença.

Cada ferramenta traz um selo: <span class="tool-kind tool-kind-read">Só consulta</span> não muda nada, <span class="tool-kind tool-kind-write">Altera</span> cria ou muda algo na hora, e <span class="tool-kind tool-kind-confirm">Pede confirmação</span> só age depois do seu sim a um resumo. Ver [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao).

## Em resumo

| Ferramenta | O que faz | Papel mínimo | Tipo |
|---|---|---|---|
| [`list_events`](#list-events) | Eventos próximos, passados, os meus ou todos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`list_event_attendees`](#list-event-attendees) | Quem confirmou presença num evento | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`create_event`](#create-event) | Espaço, evento e o ingresso, de uma vez | Moderador (com ingresso, administrador) | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_event`](#update-event) | Edita um evento e o banner | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`start_live_stream`](#start-live-stream) | Marca o evento como ao vivo, com o link da transmissão | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`stop_live_stream`](#stop-live-stream) | Encerra a transmissão | Moderador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`rsvp_event`](#rsvp-event) | Diz se você vai: vou, talvez ou não vou | Membro (não o financeiro) | <span class="tool-kind tool-kind-write">Altera</span> |
| [`delete_event`](#delete-event) | Exclui um evento | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |

## `list_events`

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

**Listar eventos.** Os eventos da comunidade. *Papel mínimo: qualquer.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `filter` | `next`, `past`, `my`, `all` | Não | Próximos (o padrão), passados, os que você confirmou, ou todos |
| `space_id` | id | Não | Só um espaço de eventos |
| `search` | texto | Não | Parte do título |
| `page`, `limit` | número | Não | Paginação |

**Devolve:** os eventos, com id, título, início, fim, tipo (online, presencial, híbrido) e local.

**Peça assim:** *"Quais são os próximos eventos?"*

## `list_event_attendees`

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

**Quem confirmou presença.** Os participantes de um evento. *Papel mínimo: qualquer.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `event_id` | id | Sim | De `list_events` |
| `status` | `going`, `maybe` | Não | Só quem vai, ou só quem talvez vá |

**Devolve:** os participantes, com o nome e a resposta.

**Peça assim:** *"Quantas pessoas confirmaram no encontro de quinta? Liste os nomes."*

**Notas:** quem comprou um ingresso pelo `create_event` não entra sozinho nesta lista. Ver [Problemas comuns](/mcp/problemas-comuns#o-que-ainda-nao-da-para-fazer).

## `create_event`

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

**Criar evento (com ingresso opcional).** Espaço de Eventos → evento → (opcional) o ingresso, um produto avulso que libera o espaço, com estoque. *Papel mínimo: moderador; com ingresso, ou criando o espaço, administrador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `title` | texto, até 255 | Sim | |
| `description` | Markdown | Não | A descrição do evento, em [Markdown](/mcp/ferramentas#texto-em-markdown) |
| `start` | data ISO 8601 com fuso | Sim | Ex.: `2026-11-10T19:00:00-03:00` |
| `end` | data ISO 8601 | Não | |
| `type` | `online`, `in_person`, `hybrid` | Não | Padrão: `online` |
| `location` | texto | Não | O nome do lugar |
| `address` | objeto | Não | `street`, `number`, `neighborhood`, `city`, `state`, `country`, `postal_code` |
| `streaming_url` | endereço web | Não | |
| `timezone` | texto | Não | Ex.: `America/Sao_Paulo`. Padrão: o da comunidade |
| `visibility` | `public`, `members`, `plan` | Não | |
| `space_id` | id | Não | Um espaço de Eventos que já existe |
| `section_id` | id | Não | Onde criar o espaço |
| `space_title` | texto | Não | |
| `icon` | um dos ícones da lista | Não | O ícone do espaço criado |
| `image_url` | link | Não | O banner do evento. Ver [Imagens](/mcp/ferramentas#imagens) |
| `ticket` | objeto | Não | Os mesmos campos da `sale` do `create_course` |
| `idempotency_key` | texto, até 100 | Não | |

**Devolve:** o espaço, o evento (id, título, slug, início, fim) e o ingresso (id, título, preço, estoque, status), se houver.

**Peça assim:** *"Crie o Encontro de Novembro, presencial, em 15/11 das 19h às 22h no Espaço Paulista, Rua Augusta 1500, São Paulo, com 80 ingressos de R$ 60 em rascunho."*

**Notas:** quem compra o ingresso ganha acesso ao espaço do evento, mas **ainda não entra sozinho na lista de participantes**; a resposta da ferramenta avisa. Um moderador sem `space_id` é recusado no passo do espaço, porque criar espaço exige administrador: para ele, passe um espaço de eventos que já existe.

## `update_event`

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

**Editar evento.** Muda título, descrição, datas, tipo, local, endereço, link da transmissão, visibilidade e o banner. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `event` | id, slug ou link | Sim | |
| `title`, `description`, `start`, `end`, `type`, `location`, `address`, `streaming_url`, `visibility` | | Não | Os mesmos de [`create_event`](/mcp/ferramentas-eventos#create-event) |
| `image_url` ou `image_base64` | link ou arquivo | Não | O banner novo |

**Peça assim:** *"Passe o encontro de amanhã para quinta, mesmo horário."*

## `start_live_stream`

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

**Iniciar transmissão.** Marca um evento como ao vivo, com o link e o serviço da transmissão, se houver. *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `event` | id, slug ou link | Sim | |
| `streaming_url` | link | Não | |
| `streaming_service` | `youtube`, `vimeo`, `mux` | Não | |

**Peça assim:** *"Estamos ao vivo: marque a live de hoje com o link https://youtube.com/…"*

**Notas:** depois, a resposta sugere encerrar a transmissão quando acabar.

## `stop_live_stream`

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

**Encerrar transmissão.** *Papel mínimo: moderador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `event` | id, slug ou link | Sim | |

## `rsvp_event`

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

**Confirmar presença no evento.** Diz se você vai a um evento. *Papel: proprietário, administrador, moderador ou membro.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `event` | id, slug ou link | Sim | |
| `status` | `going`, `maybe`, `not_going` | Sim | Vou, talvez ou não vou |

**Peça assim:** *"Confirme a minha presença no Encontro de Novembro."*

## `delete_event`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Excluir evento.** *Papel mínimo: administrador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `event` | id, slug ou link | Sim | |

**Devolve:** na primeira chamada, o título, a data e quantas pessoas confirmaram, e o código de confirmação.

## Relacionados

- [Ferramentas](/mcp/ferramentas)
- [Receitas](/mcp/receitas)
- [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao)