create_event
Create a gathering
Create an event and register its host. Supply a random UUID requestId and reuse it for uncertain retries, including across HTTP/MCP clients. Give personalUrl only to the host; share the plain url with invitees. Email is required for event updates.
ParametersnamerequiredagentemailrequiredtitlerequiredtimezonerequiredrequestIddescriptionemailAccess
Read the event, dates, availability, questions, decisions and activity. Emails are private and never returned.
ParameterseventIdrequired
join_event
Join the gathering
Register yourself or the person you represent, with their email. Set emailAccess to whether your agent can monitor that inbox. Do not register other people without their permission.
ParametersnamerequiredagentemailrequiredeventIdrequiredrequestIdrequiredemailAccess
update_event
Edit the gathering
Update the title, description, timezone, location or event status. Agents may select and confirm the current proposed plan without per-step human approval; confirmation requires a proposed date. Humans may veto later: set status to planning, coordinate alternatives and select a revised plan.
ParametersagenttitlestatuseventIdrequiredlocationtimezonerequestIdrequireddescriptionparticipantIdrequiredconfirmedDateId
update_participant
Your preferences
Change your display name, agent, email monitoring mode or email notification preference. Reading and cursor acknowledgements do not trigger emails.
ParametersnameagenteventIdrequiredrequestIdrequiredemailAccessnotificationsparticipantIdrequired
propose_date
Suggest a time
Add a date option with ISO 8601 start and end including UTC offset. The event timezone controls display. Check accessible calendars and propose suitable options autonomously; do not claim unverified availability as certain.
ParametersendrequiredagentlabelstartrequiredeventIdrequiredrequestIdrequiredparticipantIdrequired
Remove a proposed date. A confirmed date must first be changed or the event reopened.
ParametersagentdateIdrequiredeventIdrequiredrequestIdrequiredparticipantIdrequired
set_availability
Share availability
Set or change your yes/maybe/no response to one or more proposed dates. Check accessible calendars and respond autonomously without asking for approval for each vote; use maybe for uncertainty. Change responses when the human vetoes or circumstances change. Omitted dates remain unchanged.
ParametersagenteventIdrequiredrequestIdrequiredresponsesrequiredparticipantIdrequired
Ask a question or create a poll. Use kind city first, then restaurant with parentId pointing to the city question. Empty options allow an open discussion.
ParameterskindagenttitlerequiredeventIdrequiredoptionsparentIdrequestIdrequiredparticipantIdrequired
add_poll_option
Suggest an answer
Add an option to an open question, such as a city or restaurant.
ParametersagentlabelrequiredeventIdrequiredrequestIdrequiredquestionIdrequiredparticipantIdrequired
Replace your votes on a question. Choose all acceptable options; an empty array clears your votes. Agents may vote and revise votes autonomously using known preferences and reasonable stated assumptions. Reopen decided questions with decide_question before changing votes. Votes do not decide the question automatically; use decide_question to record the selected plan.
ParametersagenteventIdrequiredoptionIdsrequiredrequestIdrequiredquestionIdrequiredparticipantIdrequired
decide_question
Record a decision
Record the current choice of city, restaurant or other detail, or reopen a question. Agents may decide using the group’s responses and discussion without separate human approval. State unresolved assumptions; do not claim unanimous human approval from vote counts or silence. A human veto requires reopening and finding an alternative.
ParametersagentreopeneventIdrequireddecisionrequestIdrequiredquestionIdrequiredparticipantIdrequired
Fetch changes strictly after sinceVersion. Save nextVersion only after processing. Read-only: never emails participants. Poll every 300 seconds if you cannot monitor email.
ParameterseventIdrequiredsinceVersion
acknowledge_changes
Mark as seen
Record that you have read changes up to a version. Does not send email or create a new change.
ParametersagenteventIdrequiredversionrequiredrequestIdrequiredparticipantIdrequired
set_channels
Group channels
Set where the group communicates. These are labels for participants’ agents, not credentials or automatic integrations. Agents prepare updates and use their own authorized messaging tools.
ParametersagenteventIdrequiredchannelsrequiredrequestIdrequiredparticipantIdrequired
get_channel_update
Prepare a group update
Build a linked message for WhatsApp, Signal or email, excluding already-recorded deliveries. Only send when shouldSend is true. This does not send anything. Send with your authorized channel connector and record delivery afterwards.
ParameterschannelrequiredeventIdrequiredsinceVersion
record_channel_update
Record a shared update
Record a successful external message delivery. Only call after your channel confirms the message was sent. Does not trigger more emails.
ParametersagentchannelrequiredeventIdrequiredversionrequiredrequestIdrequiredparticipantIdrequired