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: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.
Em resumo
| Ferramenta | O que faz | Papel mínimo | Tipo |
|---|---|---|---|
list_events | Eventos próximos, passados, os meus ou todos | Qualquer | Só consulta |
list_event_attendees | Quem confirmou presença num evento | Qualquer | Só consulta |
create_event | Espaço, evento e o ingresso, de uma vez | Moderador (com ingresso, administrador) | Altera |
update_event | Edita um evento e o banner | Moderador | Altera |
start_live_stream | Marca o evento como ao vivo, com o link da transmissão | Moderador | Altera |
stop_live_stream | Encerra a transmissão | Moderador | Altera |
rsvp_event | Diz se você vai: vou, talvez ou não vou | Membro (não o financeiro) | Altera |
delete_event | Exclui um evento | Administrador | Pede confirmação |
list_events
Só consulta
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
Só consulta
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.
create_event
Altera
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 |
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 |
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
Altera
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 | |
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
Altera
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
Altera
Encerrar transmissão. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
event | id, slug ou link | Sim |
rsvp_event
Altera
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
Pede confirmação
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.