Tools · Events
MCP tools for events: listing events and who RSVP'd, creating an event with a ticket, editing the date, location, stream and banner, starting and ending the live stream, RSVPing yourself and deleting an event.
The community's calendar: upcoming events and who's going, a new event (online, in person or hybrid) with its ticket on sale, changes to date, location or banner, the live stream and your own RSVP.
Each tool carries a badge: Read-only changes nothing, Changes creates or changes something right away, and Asks to confirm only acts after your yes to a summary. See Money and confirmation.
In short
| Tool | What it does | Minimum role | Type |
|---|---|---|---|
list_events | Upcoming, past, your own or all events | Any | Read-only |
list_event_attendees | Who RSVP'd to an event | Any | Read-only |
create_event | Space, event and the ticket, in one go | Moderator (with a ticket, admin) | Changes |
update_event | Edits an event's dates, location, stream and banner | Moderator | Changes |
start_live_stream | Marks the event as live, with the stream link | Moderator | Changes |
stop_live_stream | Ends the live stream | Moderator | Changes |
rsvp_event | Says whether you're going: going, maybe or not going | Member (not finance) | Changes |
delete_event | Deletes an event | Admin | Asks to confirm |
list_events
Read-only
List events. The community's events. Minimum role: any.
| Parameter | Type | Required | Description |
|---|---|---|---|
filter | next, past, my, all | No | Upcoming (the default), past, the ones you RSVP'd to, or all |
space_id | id | No | Only one events space |
search | text | No | Part of the title |
page, limit | number | No | Pagination |
Returns: the events, with id, title, start, end, type (online, in person, hybrid) and location.
Ask like this: "What are the upcoming events?"
list_event_attendees
Read-only
Who RSVP'd. An event's participants. Minimum role: any.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | id | Yes | From list_events |
status | going, maybe | No | Only those going, or only those who might go |
Returns: the participants, with name and answer.
Ask like this: "How many people confirmed for Thursday's meetup? List the names."
Notes: someone who bought a ticket created by create_event isn't added to this list automatically. See Common problems.
create_event
Changes
Create event (with optional ticket). Events space → event → (optional) the ticket, a one-time product that unlocks the space, with stock. Minimum role: moderator; with a ticket, or when creating the space, admin.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | text, up to 255 | Yes | |
description | Markdown | No | The event description, in Markdown |
start | ISO 8601 date with time zone | Yes | E.g. 2026-11-10T19:00:00-03:00 |
end | ISO 8601 date | No | |
type | online, in_person, hybrid | No | Default: online |
location | text | No | The venue name |
address | object | No | street, number, neighborhood, city, state, country, postal_code |
streaming_url | web address | No | |
timezone | text | No | E.g. America/Sao_Paulo. Default: the community's |
visibility | public, members, plan | No | |
space_id | id | No | An existing Events space |
section_id | id | No | Where to create the space |
space_title | text | No | |
icon | one of the icons in the list | No | The icon of the space it creates |
image_url | link | No | The event banner. See Images |
ticket | object | No | The same fields as sale in create_course |
idempotency_key | text, up to 100 | No |
Returns: the space, the event (id, title, slug, start, end) and the ticket (id, title, price, stock, status), if any.
Ask like this: "Create the November Meetup, in person, on 11/15 from 7 to 10 p.m. at Espaço Paulista, Rua Augusta 1500, São Paulo, with 80 tickets at R$ 60 as a draft."
Notes: buying the ticket grants access to the event space, but doesn't yet add the buyer to the participant list; the tool's response says so. A moderator without space_id is refused at the space step, because creating a space requires an admin: as a moderator, pass an existing events space.
update_event
Changes
Edit an event. Changes the title, description, dates, type, location, address, stream link, visibility and the banner. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
event | id, slug or link | Yes | |
title, description, start, end, type, location, address, streaming_url, visibility | No | The same as in create_event | |
image_url or image_base64 | link or file | No | The new banner |
Ask like this: "Move tomorrow's meetup to Thursday, same time."
start_live_stream
Changes
Start live stream. Marks an event as live, with the stream link and service, if any. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
event | id, slug or link | Yes | |
streaming_url | link | No | |
streaming_service | youtube, vimeo, mux | No |
Ask like this: "We're live: mark today's live session with the link https://youtube.com/…"
Notes: afterwards, the response suggests ending the stream when it's over.
stop_live_stream
Changes
End live stream. Minimum role: moderator.
| Parameter | Type | Required | Description |
|---|---|---|---|
event | id, slug or link | Yes |
rsvp_event
Changes
Answer event invitation. Says whether you're going to an event. Role: owner, admin, moderator or member.
| Parameter | Type | Required | Description |
|---|---|---|---|
event | id, slug or link | Yes | |
status | going, maybe, not_going | Yes | Going, maybe or not going |
Ask like this: "RSVP me to the November Meetup."
delete_event
Asks to confirm
Delete event. Minimum role: admin.
| Parameter | Type | Required | Description |
|---|---|---|---|
event | id, slug or link | Yes |
Returns: on the first call, the title, the date and how many people RSVP'd, and the confirmation code.