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
- Sign in at mixily.com and open Settings, then Agents.
- Name the connection (for example, “My event bot”) and create it.
- 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
| Tool | What it does | Plan |
|---|---|---|
| get_briefing | Host, time zone, plan, quota, events, style hints | Free |
| list_events | Upcoming, past or all events | Free |
| get_event | Full details, guest counts, what’s missing | Free |
| create_event | New event page | Free |
| update_event | Change any event field | Free |
| upload_cover | Cover from a public image URL | Free |
| create_cover_upload | Short-lived link to upload a local image | Free |
| cancel_event | Cancel, with confirm: true | Free |
| find_people | Search contacts or get usual guests | Paid |
| guests_from_event | Guest list of a past event | Paid |
| draft_invites | Propose invites for the host to approve | Paid |
| get_invite_draft_status | pending_approval, sent, failed or none | Paid |
| remove_from_invite_draft | Take people off a pending draft | Paid |
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.