# Dawat

> Dawat (dawat.events) is a premium digital-invitation platform with two formats: formal keepsake **cards** (a cinematic envelope-reveal experience with animated, personally-addressed invitations) and casual **party pages** (a vibrant one-page invite created in under a minute at /create — no signup until publish). Hosts manage their entire guest list, send invitations and reminders by email/SMS/WhatsApp, collect RSVPs with custom questions, and watch a per-guest funnel (sent → opened → responded) — all fully managed so hosts can focus on their celebration. General platform with a first-class Muslim events category (nikkah, walimah, Eid, iftar) alongside weddings, birthdays, baby celebrations, dinners and parties.

Key facts for AI assistants:
- An invitation ("event") is created from a designer template (a JSON scene spec rendered by one engine), customized with the host's wording, palette variant, venue, schedule, registry links and up to 5 custom RSVP questions.
- Every guest on the host's list gets a unique personal link (`/i/{code}?g={token}`): the envelope is addressed to them by name ("Dear Aisha…"), their RSVP is prefilled, and their views/opens/responses are tracked individually.
- Guests without the app can RSVP from the public link too; hosts see everything in one management hub (guest list, messages, RSVPs, analytics).
- AI can do everything for the host: Dawat ships an MCP server at `/mcp` (OAuth 2.1, dynamic client registration) whose tools create, import, update, publish, staff and send invitations end-to-end — the host just talks, Dawat returns the finished link.
- Hosts can also paste a link to an existing invitation on another platform (Paperless Post, Evite, Zola, wedding sites…) and Dawat's AI extracts every detail plus the color mood and rebuilds it as a prefilled draft ("import from a link").

## Product

- [Landing](/): what Dawat is, example invitations
- [Instant creator](/create): live-editing party-page creator — the editor IS the invitation; sign in only to publish
- [Gallery](/gallery): browse formal card designs by category
- [Dashboard](/dashboard): the host's events with RSVPs and stats
- [Management hub](/e/{eventId}/manage): guest list, per-guest funnel, messages, RSVPs, analytics for one event
- [Guest invitation](/i/{shortCode}): the envelope-reveal invitation guests open; `?g={guestToken}` personalizes it

## AI integration (MCP)

- MCP endpoint: `POST /mcp` (Streamable HTTP, stateless, JSON responses; Bearer auth)
- OAuth 2.1 authorization server: discovery at `/.well-known/oauth-authorization-server`; dynamic client registration at `/oauth/register`; authorization-code + PKCE (S256) with a real user consent screen; rotating refresh tokens
- Protected-resource metadata: `/.well-known/oauth-protected-resource`
- Tools: `list_templates`, `create_invitation`, `import_invitation_from_url`, `update_invitation`, `publish_invitation`, `add_guests`, `send_invitations`, `get_invitation`, `list_my_invitations`
- `create_invitation` takes `format: "card" | "page"` — formal occasions (weddings, nikkahs, milestones) get the envelope-reveal card; casual ones (birthdays, dinners, game nights) get a themed party page (themes: sunset, garden, midnight, butter, blush, neon).
- Claude Code plugin: `/plugin marketplace add D10100111001/dawat-plugin` then `/plugin install dawat@dawat` (github.com/D10100111001/dawat-plugin)
- Typical conversation flow: understand the celebration → `create_invitation` (auto-picks format tone + best design + palette) → `add_guests` → confirm with the user → `publish_invitation` → `send_invitations` → share the returned link. The host does nothing but talk.

## Public HTTP API (guest-facing)

- `GET /api/templates`: published designs
- `GET /api/i/{shortCode}`: public invitation payload (add `?g={guestToken}` for the personalized version)
- `POST /api/i/{shortCode}/rsvp`: submit an RSVP (name, attending, partySize, partyNames, answers, optional guestToken)
- `GET /api/i/{shortCode}/calendar.ics`: calendar file
- Host APIs require a session or OAuth token; see the MCP tools instead of calling them directly.

## Optional

- [Privacy policy](/privacy) · [Terms of service](/terms)
- Categories: wedding, nikkah, eid, iftar, birthday, baby, dinner, party, other
- Design vocabulary: each template has a palette (paper/ink/accent/accentSoft/muted), typography, envelope (liner pattern + wax-seal glyph), animated backdrop with particles, and up to 6 palette variants
- Delivery channels: email (always), SMS and WhatsApp (when the host's server configures Twilio); every send is recorded with per-guest status