RSVPhere.app
PricingGet Started Free

Developers

API & MCP documentation

RSVPhere exposes your events as an MCP (Model Context Protocol) server, so AI assistants like ChatGPT, Claude, Cursor and Codex — or your own code — can read and manage your guest lists on your behalf. 29 tools, one secure endpoint, no API keys to copy around.

Server URL

https://rsvphere.app/mcp

Transport: MCP Streamable HTTP · Auth: OAuth 2.1 with dynamic client registration

One endpoint

Add the URL to any MCP client. Tools are discovered automatically.

OAuth secured

You sign in and approve the client. Every call runs as you, with your permissions.

Natural language

Ask "add these 40 guests and remind everyone still pending" — the assistant does it.

Connecting an AI assistant

Any MCP-capable client works the same way. Add a remote/HTTP MCP server, paste the URL above, and the client walks you through sign-in.

  1. In your assistant, add a new connector or MCP server and choose the remote/HTTP type.
  2. Paste https://rsvphere.app/mcp as the server URL.
  3. A browser window opens on RSVPhere. Sign in with your host account and approve the connection on the consent screen.
  4. The assistant lists the available tools. Try “list my events” to confirm the connection.

For file-based clients (Cursor, Codex, Claude Desktop) the configuration usually looks like this:

{
  "mcpServers": {
    "rsvphere": {
      "url": "https://rsvphere.app/mcp"
    }
  }
}

Clients that only support stdio can bridge to the HTTP endpoint with npx mcp-remote https://rsvphere.app/mcp.

Authentication

RSVPhere is an OAuth 2.1 resource server. There are no long-lived API keys to generate or paste — clients register themselves dynamically and obtain a short-lived access token after you approve them.

  • Discovery: GET /.well-known/oauth-protected-resource returns the authorization server metadata.
  • Registration: dynamic client registration (DCR) is enabled, so compatible clients self-register.
  • Consent: you are redirected to https://rsvphere.app/oauth/consent to approve or deny each client.
  • Calls: every request carries Authorization: Bearer <access token>. Unauthenticated requests get a 401.

Tokens act as you. A tool can only touch events you own or co-host, and plan limits apply exactly as they do in the app. Revoke access at any time by removing the connector in your assistant.

Calling the API directly

The endpoint speaks JSON-RPC 2.0 over MCP Streamable HTTP. Requests must accept both JSON and SSE responses.

curl -X POST https://rsvphere.app/mcp \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_invitees",
      "arguments": { "event_id": "…", "rsvp_status": "pending", "limit": 50 }
    }
  }'

Use "method": "tools/list" to enumerate every tool with its JSON Schema. Tool results come back as MCP content blocks; read tools also return structured JSON where it is useful.

Tool reference

29 tools across 7 groups. Parameters marked * are required. Tools tagged write change data; tools tagged Pro require a Pro plan.

Events

Create and manage the events you own or co-host.

list_eventsread-only

List events you own or co-host, with RSVP counts.

—

get_eventread-only

Full detail for one event, including functions, owners and RSVP settings.

event_id*

create_eventwrite

Create a new event. Respects your plan limits.

name*, event_date, event_time, location, description, rsvp_deadline, capacity, default_allow_guests, default_max_guests

update_eventwrite

Update event details or RSVP settings.

event_id*, name, event_date, event_time, location, description, rsvp_deadline, capacity, is_active, rsvp_closed, welcome_message

event_statsread-only

RSVP totals: attending, declined, pending, guests and seats used.

event_id*

Invitees & RSVPs

The guest list — add, edit, search and record responses.

list_inviteesread-only

List invitees, filtered by status, tag or a name/email search.

event_id*, rsvp_status, tag, search, limit

add_inviteewrite

Add a single invitee.

event_id*, first_name*, last_name, email, phone, allow_guests, max_guests, notes

bulk_add_inviteeswrite

Add many invitees in one call.

event_id*, invitees*

update_inviteewrite

Update contact details, guest allowance or notes.

invitee_id*, first_name, last_name, email, phone, allow_guests, max_guests, notes

delete_inviteewrite

Permanently remove an invitee and their guests.

invitee_id*

set_rsvp_for_inviteewrite

Record an RSVP on an invitee's behalf, optionally naming guests.

invitee_id*, attending*, guests

export_invitees_csvread-only

Return the full guest list as CSV text.

event_id*

Tags

Group guests for filtering, invite rules and reminders.

list_tagsread-only

List the invitee tags defined on an event.

event_id*

create_tagwrite

Create an invitee tag.

event_id*, label*, color

set_invitee_tagswrite

Replace the full set of tags on an invitee.

invitee_id*, tag_ids*

Co-hosts & owners

Who can manage the event, and who it is hosted by.

list_cohostsread-only

List active co-hosts and pending invitations.

event_id*

invite_cohostwrite

Email an invitation to co-host. Sends real email.

event_id*, email*

remove_cohostwrite

Remove a co-host or revoke a pending invitation.

host_id, invite_id

list_ownersread-only

List the invitation owners (hosts of record).

event_id*

add_ownerwrite

Add an invitation owner.

event_id*, name*, role, organization, email

update_ownerwrite

Update an owner's details.

owner_id*, name, role, organization, email

delete_ownerwrite

Remove an invitation owner.

owner_id*

Functions

Sub-events inside a multi-function event.

list_functionsread-only

List functions with per-function RSVP counts.

event_id*

create_functionwritePro

Add a function such as a ceremony or dinner.

event_id*, name*, description, function_date, function_time, location, capacity

Reminders & check-in

Nudge pending guests and run the door.

send_reminderwrite

Immediately email a reminder to invitees filtered by RSVP status. Sends real email — confirm the audience first.

event_id*, subject*, body*, statuses*

check_in_lookupread-only

Find a party by name or email and return their guests and check-in state.

event_id*, query*

confirm_check_inwrite

Mark an invitee and/or named guests as checked in.

invitee_id, guest_ids

Surveys

Post-event feedback.

list_surveysread-only

List an event's post-event surveys with response counts.

event_id*

survey_results_summaryread-only

Aggregate responses: rating averages, choice tallies and free-text answers.

survey_id*, include_text_answers

Limits & good practice

  • Tools that send email (send_reminder, invite_cohost) send real messages immediately — always confirm the audience before running them.
  • Plan limits on events, invitees and Pro features are enforced server-side.
  • Deletions (delete_invitee, delete_owner) are permanent.
  • Keep calls bounded — use limit and filters on list_invitees for large guest lists.

Ready to plug your assistant in?

Create a free account, add your first event, then connect https://rsvphere.app/mcp to your AI assistant.

Get Started FreeSee pricing