---
name: status-social
description: Create a shareable event invite link with RSVPs for a party, dinner, birthday, trip or other get-together, read who is coming, and edit its details. Use when the user is organising a get-together with other people and wants an invite link that collects RSVPs, a date poll or shared costs.
---

# Status Social

## AI assistants: create an invite

POST JSON to https://status-social.com/api/agent/status_create_event (or call the MCP tool status_create_event at https://status-social.com/mcp).

Required: title. Optional: details, location, date (YYYY-MM-DD), time (HH:mm), timeZone (defaults to Europe/London), theme (party, dinner, garden, sport, holiday, or plain) and hostName.

No account or API key is needed. Optional fields can be added or changed later with status_update_event.

The response has a private claimUrl for the user, an inviteUrl for guests that works once the user has claimed the event, and an editKey for later edits.

Status Social makes a shareable event invite link for a party, dinner, birthday, trip, night out or society social. Guests open the link to RSVP, and the host can add a date poll, split the bill and share photos on the same page.

Use it when the user is organising a get-together with other people and wants an invite link that collects RSVPs, a date poll or shared costs. Not for calendar entries, solo reminders, one-to-one meetings, or selling tickets to public events.

How it works:
1. status_create_event makes a draft invite page from whatever is known. Only title is required; date, time, place, details, theme and host name can be added or changed later. No account, sign-up or API key is needed.
2. The result has three links and a key. claimUrl is private to the user: opening it and signing in with a phone number makes them the host. Until then the event is a draft and guests cannot join. inviteUrl is the link for guests and works once the event is claimed. eventUrl is where the host manages it.
3. editKey is a credential for this one event and works for 7 days. status_update_event uses it to change the title, details, place, date, time or theme; status_get_event uses it to read the event and each guest's RSVP.

Inviting guests, running a date poll, splitting costs and sharing photos are done by the host on the event page after claiming it. The tools do not cover those steps, cancelling or deleting.

## Connect

MCP server (Streamable HTTP, no authentication): https://status-social.com/mcp

## Example prompts

- Make an invite for Sam's 30th: drinks at The Albion, Bristol on Saturday 13 March at 7:30pm.
- Set up an RSVP link for our book club dinner next Friday and give me the link to send round.
- Who has replied to the invite you made for my birthday?

Without MCP, call the same tools over HTTP. Each is a POST with a JSON body:

```bash
curl -X POST https://status-social.com/api/agent/status_create_event \
  -H 'Content-Type: application/json' \
  -d '{"title":"Saturday dinner","date":"2027-03-13","time":"19:30","location":"The Albion, Bristol","theme":"party"}'
```

The response contains `claimUrl` (private to the user), `inviteUrl` (for guests, works once the user has claimed the event), `editKey` and a plain-language `message`. Guests cannot join until the event is claimed.

Tools renamed on 11 November 2026 keep their old names as aliases: `create_event`, `get_event` and `update_event` still work on both MCP and HTTP.

## Tools

- `status_create_event`: Create 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).
- `status_get_event`: Read an event invite made with status_create_event: who is coming and how many people have replied (each guest's name and RSVP: confirmed for yes, maybe, pass for no, or pending), its title, details, place, date, time and theme, and whether the user has claimed it. Needs the eventId and editKey from status_create_event. Read-only.
- `status_update_event`: Change the title, details, place, date, time or theme of an event invite made with status_create_event. Send eventId, editKey and only the fields to change. The invite link stays the same and guests see the change straight away. Does not change a date poll, the guest list or costs, and cannot cancel or delete the event.

Errors come back as `{ "ok": false, "error", "code", "retryable" }`; `error` says what to change.

Full schema: https://status-social.com/openapi.json
