Create an event invite link
status_create_eventCreate a shareable event invite link where guests RSVP, for a party, dinner, birthday, trip, night out or other get-together; the host can then add a date poll and split costs on the same page. Use when the user is planning something with other people and wants a link to send round. Not for calendar entries, solo reminders, one-to-one meetings or selling tickets to public events. Only title is required; details, location, date, time, timeZone, theme and hostName are optional. No account or API key. Returns claimUrl (private to the user: opening it and signing in makes them the host; until then the event is a draft and guests cannot join), inviteUrl (for guests, works once claimed), eventUrl, eventId and editKey (for status_get_event and status_update_event, valid 7 days).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>"
},
"name": "status_create_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Event date as YYYY-MM-DD. Leave out if the date is not set yet | |
| time | No | Start time as 24-hour HH:mm, local to timeZone, e.g. 19:30. Needs date | |
| theme | No | Visual style of the invite page: party, dinner, garden, sport, holiday, plain. Defaults to party | |
| title | Yes | Event name shown at the top of the invite, e.g. "Sam's 30th" or "Book club dinner" | |
| details | No | Invite message for guests: what is happening, what to bring, dress code, cost per person | |
| hostName | No | The user's first name, shown as host on the invite until they claim it | |
| location | No | Venue name or address, e.g. "The Albion, Bristol" | |
| timeZone | No | IANA time zone for date and time, e.g. Europe/London (the default) or America/New_York |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event | No | The event as guests see it | |
| editKey | Yes | Credential for status_update_event and status_get_event. Valid for 7 days. | |
| eventId | Yes | ||
| message | Yes | Plain-language summary of the result | |
| claimUrl | Yes | Private link for the user only: opening it and signing in makes them the host | |
| inviteUrl | Yes | Invite link for guests; works once the user has claimed the event |