Mixily Blog · 129 articles · Updated Nov 18, 2026 Create a free event page →
Guides

An Event RSVP Page API for Developers and AI Agents

An Event RSVP Page API for Developers and AI Agents

Mixily’s API for RSVP pages is its MCP server at https://mcp.mixily.com. It’s one HTTPS endpoint. Send a JSON request with a bearer token, and you can create events, set covers, read RSVP counts and draft invites from your own code or AI agent.

You don’t need an MCP framework to use it. A plain HTTP POST works.

Who This Is For

  • Developers building an app or bot that needs to spin up RSVP pages
  • Anyone wiring an AI agent (your own, or a framework like the Claude Agent SDK) to real event pages
  • Teams that run the same kind of event often and want to script it

If you just want Claude or ChatGPT to do it for you, skip the code and read what the Mixily MCP is instead.

Step 1: Get a Connection Token

  1. Sign in at mixily.com and open Settings, then Agents.
  2. Name the connection (for example, “My event bot”) and create it.
  3. Copy the token. It starts with `mxa_` and is only shown once.

The token acts as you, on your events only. You can revoke it anytime from the same page.

Step 2: List the Tools

Every request is a JSON-RPC 2.0 message sent as a POST:

curl https://mcp.mixily.com \
  -H "Authorization: Bearer $MIXILY_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

You’ll get back 13 tools, each with its input schema.

Step 3: Start With the Briefing

Call `get_briefing` before creating anything. It returns who the host is, their time zone, plan, remaining email quota, upcoming events and style hints from past events.

curl https://mcp.mixily.com \
  -H "Authorization: Bearer $MIXILY_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_briefing","arguments":{}}}'

Results come back in `result.content[0].text` as a JSON string.

Step 4: Create an RSVP Page

Only `title` is required. Mixily fills in the host’s time zone, a two-hour duration and unlisted privacy.

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
  "name":"create_event",
  "arguments":{
    "title":"Team dinner",
    "start_time":"2026-12-04T19:00:00-08:00",
    "location":"Rosa's, 12 Main St",
    "privacy":"V",
    "max_capacity":12,
    "max_plus_n":0,
    "idempotency_key":"team-dinner-2026-12-04"
  }}}

Always send an `idempotency_key` and reuse it when you retry, so a dropped response can’t create two events. Then call `get_event` to read back the page, guest counts and what’s still missing.

The 13 Tools

ToolWhat it doesPlan
get_briefingHost, time zone, plan, quota, events, style hintsFree
list_eventsUpcoming, past or all eventsFree
get_eventFull details, guest counts, what’s missingFree
create_eventNew event pageFree
update_eventChange any event fieldFree
upload_coverCover from a public image URLFree
create_cover_uploadShort-lived link to upload a local imageFree
cancel_eventCancel, with confirm: trueFree
find_peopleSearch contacts or get usual guestsPaid
guests_from_eventGuest list of a past eventPaid
draft_invitesPropose invites for the host to approvePaid
get_invite_draft_statuspending_approval, sent, failed or nonePaid
remove_from_invite_draftTake people off a pending draftPaid

Paid means any paid plan, starting with Lite at $19 a month. See Mixily pricing.

Event Settings You Can Set

  • `privacy`: `U` unlisted (anyone with the link), `V` private (invited guests only), `P` password
  • `max_capacity`, `max_plus_n` (0 means no plus-ones), `registration_end_time`
  • `guests_can_invite`, `show_guest_list`, `capture_guest_phone`, `disable_comments`
  • `description` as simple HTML, `title` up to 90 characters

How Invites Work

`draft_invites` never sends anything. Mixily saves the list as a pending draft and emails the host a preview with an Approve button. Only that click sends the invites.

Check `get_invite_draft_status` before telling anyone invites went out. This is on purpose: no script or agent can email a host’s guests without the host seeing the list first.

Limits and Rules

  • A token only reaches its owner’s events.
  • No ticket sales. Mixily is for parties and gatherings.
  • Email sends count against the host’s weekly email quota, which `get_briefing` reports.
  • An invalid or revoked token returns HTTP 401.

Using an MCP Client Instead

If your agent framework already speaks MCP, add https://mcp.mixily.com as a remote server with the same bearer token, or let the user sign in with OAuth. Claude Code users can run:

claude mcp add --transport http mixily https://mcp.mixily.com

Common Questions

Is there a REST API for Mixily RSVP pages?

The MCP server is Mixily’s API. It’s JSON over HTTPS, so any language that can send a POST request can use it.

Can I create RSVP pages for free?

Yes. Creating, editing and cancelling events works on the free plan. Contacts and invites need a paid plan.

Can my AI agent send invitations?

It can draft them. The host approves each invite list by email before anything sends.

Get Started

Create a free Mixily account, make a token under Settings, then Agents, and send your first `tools/list`. More on the AI event planner page.

Skip the back-and-forth. Create →